Task flow: Basic scenario with a Docker container
The steps in this basic scenario can help you get started running stubs with Docker.
This is the basic task flow that helps you to run stubs in a Docker container. After you setup to use Docker, you can perform the tasks in sequence to run one or more stubs in a Docker container.
| Task | More information |
|---|---|
| 1. Set up Docker. | Preparing to use Docker |
| 2. Publish one or more stubs to a Dockerfile and build context by using the user interface, command line, or Ant task. Stubs created in HCL OneTest™ API can be published to a Dockerfile and build context. To publish to a Dockerfile and build context, only stubs that are based on specific transports are supported. For more information, see Supported transports to publish stubs to a Dockerfile and build context. | See Dockerfile and build context in Publishing stubs, Publish stubs by using the command line, or Publish stubs by using an Ant task. |
| 3. Verify that the stub is published by checking the output directory from the publish step. | See Dockerfile and build context in Verifying publication of stubs. |
| 4. Build a Docker image. The Dockerfile and context files in the output directory can be used to build a Docker image. | See Build a Docker image by using the Dockerfile in Dockerfile and build context in Publishing stubs or see Build a Docker image by using the Dockerfile in Dockerfile and build context in Publish stubs by using the command line or see Build a Docker image by using the Dockerfile in Dockerfile and build context in Publish stubs by using an Ant task. |
5. Verify that the Docker image is built by
using the docker images command. |
Docker Documentation |
| 6. Verify the stub information by querying the Docker image. After you build a Docker image, you can query that image to see stub information such as the stub name, its ID, and its exposed port. In addition, after the image is running as a container, you can query the container to retrieve information as to what stubs are running within it. | Query stub information in Docker images and containers |
7. Run one or more stubs by using the docker run command.
After you publish one or more stubs to a Dockerfile and build context and you built a Docker image
from those files, you use the docker run command to run the image in a
container. |
Running stubs in a Docker container or Start a stub by using the command line |
8. Verify that the stub is running in the Docker
container by using the docker ps command. |
Docker Documentation |
9. Query Docker container logs by using the docker logs
command. |
Query Docker container logs |
| 10. Stop a stub by stopping the Docker container. | Stopping stubs that are running in a Docker container |