Connecting a Docker performance agent to Test

You can run a Performance agent in Docker container and connect it to Test.

You must have the following details to connect the Docker performance agent to Test Hub:

  • TESTHUB_SERVER: Server host name.
  • TESTHUB_TOKEN: Offline user token that is obtained in following context.
  • TESTHUB_PORT: 443
  • TESTHUB_TEAM_SPACE: Initial
  • TESTHUB_PATH_CONTEXT: Server API context path.
  • Docker_Image: Download the IBM_DevOps_Test_Performance_Agent_Docker_<version_number> Multilingual Multiplatform file from IBM® Passport Advantage®.
  1. Log in to Test.
  2. Click the User icon , and select the Create Token option.
    The token is generated automatically and displayed in the Create Offline User Token dialog.
  3. Click Copy to copy the token and save it in a secure location.
  4. Run the following command where the Docker image of the performance agent is located: 
    TESTHUB_SERVER=<server_url> 
TESTHUB_TOKEN=<access_token>
TESTHUB_PORT=443 
TESTHUB_TEAM_SPACE=Initial
TESTHUB_PATH_CONTEXT="/test"
docker run --detach --name Test_performance_agent_docker \
--env TESTHUB_SERVER=$TESTHUB_SERVER \
--env TESTHUB_PORT=$TESTHUB_PORT \
--env TESTHUB_TOKEN=$TESTHUB_TOKEN \
--env TESTHUB_TEAM_SPACE=$TESTHUB_TEAM_SPACE \
--env TESTHUB_PATH_CONTEXT=$TESTHUB_PATH_CONTEXT ibm-devops-test-performance:11.0.9
  5. Go to Infrastructure > Agents and Intercepts and verify whether your agent is connected to Test.
  6. Run the following commands to stop and remove the Docker container:
    docker stop <assigned_name_of_the_container>
    docker rm <assigned_name_of_the_container>
  7. Run the following command to view all the help options and available environment variables:
    docker run --rm ibm-devops-test-performance:11.0.9
You have connected the Docker performance agent to Test.