Docker Inspect action allows you output low-level information on Docker objects to a Continua CI variable.
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 directory from where the Docker command will be run. This is important for relative directories passed to the Docker Command.
Object Identifier
The ID or name of the object (e.g. container, image, volume, network, node, service, or task) to inspect.
Type
The type of object that we are inspecting:
- Any
- Container
- Image
- Volume
- Network
- Node
- Service
- Task
If you leave this as 'Any', a container will be inspected in preference to an image with the same name.
Output Selection Format
Choose the query format to use to select a value from the command output.
- Go template
- Json path
The relevant input boxes below will be shown for entering the associated template or query as each option is selected.
Go Template
See the Docker command and log output documentation for examples . Command line option: --format
Specify remote Docker host
Tick to open a new Host tab to specify an alternative Docker host to the one local to the agent.
Using
The version of Docker to use when running the Docker Inspect command. It is important that the agent have the correct version of Docker installed for the Docker File provided.
Host
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
Output Variable
Select the name of the build variable to set with the result of the inspection.
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
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.