CircleCI runner images

circleci/runner image is created by CircleCI to be with the runner feature.

Currently the launch-agent tag can be used to run the launch-agent in a container colocated with the CircleCI job, i.e. the job will run inside the same container.

In the future a variant will be added that runs the launch-agent runs on the host and will run each job inside its own container (via the task-agent).

Getting Started

This image can be used on a host with docker installed:

CIRCLECI_RESOURCE_CLASS=<resource-class> CIRCLECI_API_TOKEN=<runner-token> docker run --env CIRCLECI_API_TOKEN --env CIRCLECI_RESOURCE_CLASS --name <container-name> circleci/runner:launch-agent

Contributing

We encourage issues and pull requests against this repository.

For new feature requests, we encourage Canny ideas.

Additional Resources

• Dockerhub Repository - DockerHub repository for the runner image
• CircleCI Docs - The official CircleCI Documentation website.
• Runner Docs
• Docker Docs

Container orchestrators

We support running launch-agent in Kubernetes(docs). Other container orchestrators are not supported at this time

License

This repository is licensed under the Apache 2.0 license. The license can be found here.