Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The Docker Push Image Action allows for the pushing of a Docker Image to a remote Docker image registry. The action will log into the remote registry and verify the supplied registry user. Then the supplied Docker Image is uploaded under the image name and version tag. 

Docker Push

Image AddedImage Removed

Name

A friendly name for this action (will be displayed in the actions workflow area).

Enabled

Determines if this action will be run within the relevant stage.

...

Working Directory

The name of directory from where the Docker image to uploadcommand will be run. This usually is in the format of {repository}:{tag} where the repository can take the format of {user_name}/{image_name}.

Current Working Directory

is important for relative directories passed to the Docker Command. 

Image Name

Name of the image push to the registry in the format your-username/image-name[:tag].

Specify remote Docker host

Tick to open a new Host tab to specify an alternative Docker host to the one local to the agentThe base directory from where all docker command should be run on the agent. If any relative directories are used in the Docker File, or any other scripts that it runs this will be the directory that they are based on. It typically is not a good idea to rely on this directory in Docker Files. All relevant files should be held within the Docker Context

Using

The version of Docker to use when running the Docker

...

Push command. It is important that the agent have the correct version of Docker installed for the Docker File provided.

...

  


Registry

...

Image Added

Registry URL

...

The URL

...

or server name to the registry to upload the image

...

to

...

. Leave blank to use Docker Hub.

Username

Username for the registry account.

Password

Password for the registry account.


Host

Image Added

Docker Host URL

The address of the Docker Host. This can be in the form of a URL or any IP4 Address. If a non-standard port is required simply use the <IPAddress>:<Port> specitifcation format. 

Use TLS

Tick to connect to the Docker host using TLS where the host is not verified against a CA.

Verify TLS

Available to tick only if 'Use TLS' is ticked.

Verify the certificate with a root authority where the Host is verified against its CA.

When using Verify TLS, if the Host's CA is not trusted by the agent then the connection is not established. 

CA Certificate

Path to Docker host CA certificate file.

Certificate

Path to Docker host certificate file

Docker Host Certificate Key

The Docker Host Certificate Key is the PEM format key file for the accessing the Docker Host Certificate. 


Options

Image Added

Log Level

The amount of information detail to display in the build log.

Timeout (in seconds)

How long to wait for the action to finish running before timing out. Leaving this blank (or zero) will default to 86400 seconds (24 hours).

Treat failure as warning

Tick to continue build on failure marking the action with a warning status.


Environment

Image Added

Multiple environment variables can be defined - one per line.

Log environment variables

If this is ticked, environment variable values are written to the build log. 

Generate system environment variables

Tick this checkbox to set up a list of new environment variables prefixed with 'ContinuaCI.' for all current system expression objects and variables.

Docker Registry ID

The username under which the image will be published. The registry ID should have been given permission to publish images to the registry host supplied. 

Docker Registry Password

...