Pulling a Docker image from a registry
You can pull a Docker image from a Docker registry. This may be the central Docker Hub registry or a custom registry.
Before you begin
- Make sure you have Docker installed. We advise to use the most recent version.
Define a Docker capability in Bamboo. See Defining a new Docker capability
- If you're using Bamboo on Windows, you can't run Docker commands directly from the Windows command line. To use Docker tasks with Bamboo Windows, run Docker Machine.
To pull a Docker image from a registry
- In you job configuration screen, click Add task.
- Search for the Docker tasks type and select it.
- (optional) For future reference, add a Task description.
- (optional) Use the Disable this task checkbox to control whether your task is run.
- From the Repository drop-down list, choose Pull a Docker image from a Docker registry.
Complete the settings:Pull a Docker image to a Docker registry...
Registry Choose to push to either Docker Hub or a custom registry. Repository For Docker Hub you must specify the repository name and optionally a tag, for example:
namespace/repository:tagFor a custom registry you must specify the registry address, repository name and optionally a tag, for example:
Select how you'd like to authenticate:
- use agents'
- use username and password
- select predefined shared credentials from the drop-down list
Advanced options (optional) Environment variables Additional system environment variables that you want to pass to your build. Note that existing environment variables are automatically available to the executable. You can also include Bamboo global or build-specific variables (see Bamboo variables).
Multiple variables should be separated with spaces. Parameters with spaces must be quoted (e.g JAVA_OPTS="-Xms200m -Xmx700m").
Working sub directory An alternative subdirectory, relative to the job's root directory, where Bamboo will run the executable. The root directory contains everything checked out from the job's configured source repository. If you leave this field blank, Bamboo will look for build files in the root directory. This option is useful if your task has a build script in a subdirectory and the executable needs to be run from within that subdirectory
- use agents'