CircleCI orb for interacting with Microsoft's Azure Container Registry (ACR).
Following is the full list of parameters required by this orb's various commands and jobs. For details, see the listing in the Orb Registry.
| Parameter | Type | Default | Description |
|---|---|---|---|
alternate-tenant |
boolean |
false |
Use an alternate tenant. Only applicable for user logins. |
attach-workspace |
boolean |
true |
Boolean for whether or not to attach to an existing workspace. |
azure-username |
env_var_name |
AZURE_USERNAME |
Environment variable storing your Azure username. Only applicable for user logins. |
azure-password |
env_var_name |
AZURE_PASSWORD |
Environment variable storing your Azure password. Only applicable for user logins. |
azure-sp |
env_var_name |
AZURE_SP |
Name of environment variable storing the full name of the Service Principal, in the form https://app-url. Only applicable for Service Principal logins. |
azure-sp-password |
env_var_name |
AZURE_SP_PASSWORD |
Name of environment variable storing the password for the Service Principal. Only applicable for Service Principal logins. |
azure-sp-tenant |
env_var_name |
AZURE_SP_TENANT |
Name of environment variable storing the tenant ID for the Service Principal. Only applicable for Service Principal logins. |
azure-tenant |
env_var_name |
AZURE_TENANT |
Environment variable storing your Azure tenant, necessary if alternate-tenant is set to true. Only applicable for user logins. |
checkout |
boolean |
true |
Boolean for whether or not to checkout as a first step. |
dockerfile |
string |
Dockerfile |
name of Dockerfile to use |
executor |
executor |
default |
name of any custom executor (default is machine: true) |
extra-build-args |
string |
"" |
Extra flags to pass to docker build (see docs.docker.com/engine/reference/commandline/build) |
path |
string |
. |
path to Dockerfile, defaults to the working directory |
registry-name |
string |
N/A | name of your ACR registry |
repo |
string |
N/A | name of your ACR repository |
tag |
string |
latest |
ACR image tag (comma-delimited string) |
workspace-root |
string |
. |
Workspace root path that is either an absolute path or a path relative to the working directory. |
See below for a simple example of this orb's build_and_push_image job. For details, see the listing in the Orb Registry.
version: 2.1
orbs:
azure-acr: circleci/[email protected]
workflows:
simple_build_and_push:
jobs:
# with default parameter values, the following would be sufficient to build and push an image to ACR
- azure-acr/build_and_push_image:
registry-name: myRegistryName
login-server-name: myregistryname.azurecr.io
repo: myRepositoryNameWe welcome issues to and pull requests against this repository! For further questions/comments about this or other orbs, visit CircleCI's Orbs discussion forum.