Skip to main content

Microsoft Azure Command-Line Tools container Command Module

Project description

Microsoft Azure CLI ‘container’ Command Module

Commands to manage Azure container instances

Group
    az container: Manage Azure Container Instances.

Commands:
    attach: Attach local standard output and error streams to a container in a container group.
    create: Create a container group.
    delete: Delete a container group.
    list  : List container groups.
    logs  : Tail the log of a container group.
    show  : Show the details of a container group.

Commands to create an Azure container group

Command
    az container create: Create a container group.

Arguments
    --image             [Required]: The container image name.
    --name -n           [Required]: The name of the container group.
    --resource-group -g [Required]: Name of resource group. You can configure the default group
                                    using `az configure --defaults group=<name>`.
    --command-line                : The command line to run when the container is started, e.g.
                                    '/bin/bash -c myscript.sh'.
    --cpu                            : The required number of CPU cores of the containers.  Default:
                                    1.
    --dns-name-label                 : The dns name label for container group with public IP.
    --environment-variables -e       : A list of environment variable for the container. Space-
                                    separated values in 'key=value' format.
    --file -f                        : The path to the input file.
    --image                          : The container image name.
    --ip-address                     : The IP address type of the container group.  Allowed values:
                                    Public.
    --location -l                    : Location. You can configure the default location using `az
                                    configure --defaults location=<location>`.
    --memory                         : The required memory of the containers in GB.  Default: 1.5.
    --name -n                        : The name of the container group.
    --no-wait                        : Do not wait for the long-running operation to finish.
    --os-type                        : The OS type of the containers.  Allowed values: Linux,
                                    Windows.  Default: Linux.
    --ports                          : The ports to open.  Default: [80].
    --protocol                       : The network protocol to use.  Allowed values: TCP, UDP.
    --restart-policy                 : Restart policy for all containers within the container group.
                                    Allowed values: Always, Never, OnFailure.  Default: Always.
    --secrets                        : Space-separated secrets in 'key=value' format.
    --secrets-mount-path             : The path within the container where the secrets volume should
                                    be mounted. Must not contain colon ':'.
    --secure-environment-variables   : A list of secure environment variable for the container.
                                    Space-separated values in 'key=value' format.

Image Registry Arguments
    --registry-login-server       : The container image registry login server.
    --registry-password           : The password to log in container image registry server.
    --registry-username           : The username to log in container image registry server.

Log Analytics Arguments
    --log-analytics-workspace       : The Log Analytics workspace name or id. Use the --subscription
                                      flag to set the subscription if not current.
    --log-analytics-workspace-key   : The Log Analytics workspace key.

Global Arguments
    --debug                       : Increase logging verbosity to show all debug logs.
    --help -h                     : Show this help message and exit.
    --output -o                   : Output format.  Allowed values: json, jsonc, table, tsv.
                                    Default: json.
    --query                       : JMESPath query string. See http://jmespath.org/ for more
                                    information and examples.
    --verbose                     : Increase logging verbosity. Use --debug for full debug logs.

Examples
    Create a container group and specify resources required.
        az container create -g MyResourceGroup --name MyAlpine --image alpine:latest --cpu 1
        --memory 1

    Create a container group with OS type.
        az container create -g MyResourceGroup --name MyWinApp --image winappimage:latest --os-type
        Windows

    Create a container group with public IP address.
        az container create -g MyResourceGroup --name MyAlpine --image alpine:latest --ip-address
        public

    Create a container in a container group with public IP address and UDP port.
        az container create -g MyResourceGroup --name myapp --image myimage:latest --ip-address
        public --ports 8081 --protocol UDP

    Create a container group with starting command line.
        az container create -g MyResourceGroup --name MyAlpine --image alpine:latest --command-line
        "/bin/sh -c '/path to/myscript.sh'"

    Create a container group with envrionment variables.
        az contanier create -g MyResourceGroup --name MyAlpine --image alpine:latest -e key1=value1
        key2=value2

    Create a container group using container image from Azure Container Registry.
        az container create -g MyResourceGroup --name MyAlpine --image
        myAcrRegistry.azurecr.io/alpine:latest --registry-password password

    Create a container group using container image from other private container image registry.
        az container create -g MyResourceGroup --name MyApp --image myimage:latest --cpu 1 --memory
        1.5 --registry-login-server myregistry.com --registry-username username --registry-password
        password

    Create a container in a container group that mounts an Azure File share as volume.
        az container create -g MyResourceGroup --name myapp --image myimage:latest --command-line
        "cat /mnt/azfile/myfile" --azure-file-volume-share-name myshare --azure-file-volume-account-
        name mystorageaccount --azure-file-volume-account-key mystoragekey --azure-file-volume-
        mount-path /mnt/azfile

    Create a container in a container group that mounts a git repo as volume.
        az container create -g MyResourceGroup --name myapp --image myimage:latest --command-line
        "cat /mnt/gitrepo" --gitrepo-url https://github.com/user/myrepo.git --gitrepo-dir ./dir1
        --gitrepo-mount-path /mnt/gitrepo

    Create a container in a container group using a yaml file.
        az container create -g MyResourceGroup -f containerGroup.yaml

    Create a container group using Log Analytics from a workspace name.
        az container create -g MyResourceGroup --name myapp --log-analytics-workspace myworkspace

    Create a container group using Log Analytics from a workspace id and key.
        az container create -g MyResourceGroup --name myapp --log-analytics-workspace workspaceid
        --log-analytics-workspace-key workspacekey

Commands to get an Azure container group

Command
    az container show: Show the details of a container group.

Arguments

Resource Id Arguments
    --ids              : One or more resource IDs (space-delimited). If provided, no other 'Resource
                        Id' arguments should be specified.
    --name -n          : The name of the container group.
    --resource-group -g: Name of resource group. You can configure the default group using `az
                        configure --defaults group=<name>`.

Global Arguments
    --debug            : Increase logging verbosity to show all debug logs.
    --help -h          : Show this help message and exit.
    --output -o        : Output format.  Allowed values: json, jsonc, table, tsv.  Default: json.
    --query            : JMESPath query string. See http://jmespath.org/ for more information and
                        examples.
    --verbose          : Increase logging verbosity. Use --debug for full debug logs.

Commands to tail the logs of a Azure container group

Command
    az container logs: Tail the log of a container group.

Arguments
    --container-name   : The container name to tail the logs.

Resource Id Arguments
    --ids              : One or more resource IDs (space-delimited). If provided, no other 'Resource
                        Id' arguments should be specified.
    --name -n          : The name of the container group.
    --resource-group -g: Name of resource group. You can configure the default group using `az
                        configure --defaults group=<name>`.

Global Arguments
    --debug            : Increase logging verbosity to show all debug logs.
    --help -h          : Show this help message and exit.
    --output -o        : Output format.  Allowed values: json, jsonc, table, tsv.  Default: json.
    --query            : JMESPath query string. See http://jmespath.org/ for more information and
                        examples.
    --verbose          : Increase logging verbosity. Use --debug for full debug logs.

Commands to delete an Azure container group

Command
    az container delete: Delete a container group.

Arguments
    --yes -y           : Do not prompt for confirmation.

Resource Id Arguments
    --ids              : One or more resource IDs (space-delimited). If provided, no other 'Resource
                        Id' arguments should be specified.
    --name -n          : The name of the container group.
    --resource-group -g: Name of resource group. You can configure the default group using `az
                        configure --defaults group=<name>`.

Global Arguments
    --debug            : Increase logging verbosity to show all debug logs.
    --help -h          : Show this help message and exit.
    --output -o        : Output format.  Allowed values: json, jsonc, table, tsv.  Default: json.
    --query            : JMESPath query string. See http://jmespath.org/ for more information and
                        examples.
    --verbose          : Increase logging verbosity. Use --debug for full debug logs.

Commands to list Azure container groups by resource group

Command
    az container list: List container groups.

Arguments
    --resource-group -g: Name of resource group. You can configure the default group using `az
                        configure --defaults group=<name>`.

Global Arguments
    --debug            : Increase logging verbosity to show all debug logs.
    --help -h          : Show this help message and exit.
    --output -o        : Output format.  Allowed values: json, jsonc, table, tsv.  Default: json.
    --query            : JMESPath query string. See http://jmespath.org/ for more information and
                        examples.
    --verbose          : Increase logging verbosity. Use --debug for full debug logs.

Commands to execute a command in a running container

Command
    az container exec: Execute a command from within a running container of a container group.
        The most common use case is to open an interactive bash shell. See examples below. This
        command is currently not supported for Windows machines.

Arguments
    --exec-command [Required]: The command to run from within the container.
    --container-name         : The container name where to execute the command. Can be ommitted for
                            container groups with only one container.
    --terminal-col-size      : The col size for the command output.  Default: 80.
    --terminal-row-size      : The row size for the command output.  Default: 20.

Resource Id Arguments
    --ids                    : One or more resource IDs (space-delimited). If provided, no other
                            'Resource Id' arguments should be specified.
    --name -n                : The name of the container group.
    --resource-group -g      : Name of resource group. You can configure the default group using `az
                            configure --defaults group=<name>`.

Global Arguments
    --debug                  : Increase logging verbosity to show all debug logs.
    --help -h                : Show this help message and exit.
    --output -o              : Output format.  Allowed values: json, jsonc, table, tsv.  Default:
                            json.
    --query                  : JMESPath query string. See http://jmespath.org/ for more information
                            and examples.
    --subscription           : Name or ID of subscription. You can configure the default
                            subscription using `az account set -s NAME_OR_ID`".
    --verbose                : Increase logging verbosity. Use --debug for full debug logs.

Examples
    Stream a shell from within an nginx container.
        az container exec -g MyResourceGroup --name mynginx --container-name nginx --exec-command
        "/bin/bash"

Commands to attach to a container in a container group

Command
    az container attach: Attach local standard output and error streams to a container in a
    container group.

Arguments
    --container-name   : The container to attach to. If omitted, the first container in the
                        container group will be chosen.

Resource Id Arguments
    --ids              : One or more resource IDs (space delimited). If provided, no other 'Resource
                        Id' arguments should be specified.
    --name -n          : The name of the container group.
    --resource-group -g: Name of resource group. You can configure the default group using `az
                        configure --defaults group=<name>`.

Global Arguments
    --debug            : Increase logging verbosity to show all debug logs.
    --help -h          : Show this help message and exit.
    --output -o        : Output format.  Allowed values: json, jsonc, table, tsv.  Default: json.
    --query            : JMESPath query string. See http://jmespath.org/ for more information and
                        examples.
    --verbose          : Increase logging verbosity. Use --debug for full debug logs.

Release History

0.3.13

  • Adding ‘az container start’ command

  • Allow using decimal values for CPU during container creation

0.3.12

  • Updating dependencies

0.3.11

  • Updating dependencies

0.3.10

  • Minor fixes

0.3.9

  • Minor fixes

0.3.8

  • Show identity when exporting a container group to yaml

0.3.7

  • Make ‘Private’ a valid type to pass to ‘–ip-address’

  • Allow using only subnet ID to setup a virtual network for the container group

  • Allow using vnet name or resource id to enable using vnets from different resource groups

0.3.6

  • Add ‘–assign-identity’ for adding a MSI identity to a container group

  • Add ‘–scope’ to create a role assignment for the system assigned MSI identity

  • Show warning when creating a container group with an image without a long running process

  • Fix table output issues for ‘list’ and ‘show’ commands

0.3.5

  • Minor changes

0.3.4

  • Added ability to restart and stop a running container group

  • Add ‘–network-profile’ for passing in a network profile

  • Add ‘–subnet’, ‘–vnet_name’, to allow creating container groups in a VNET

  • Update the table output to show the status of the container group

0.3.3

  • Add ‘–secure-environment-variables’ for passing secure environment variables to a container

0.3.2

  • Do not require ‘–log-analytics-workspace-key’ for name or ID when in set subscription

0.3.1

  • Update PyYAML dependency to 3.13

0.3.0

  • BREAKING CHANGE: ‘show’ commands log error message and fail with exit code of 3 upon a missing resource.

  • Remove the requirement for username and password for non dockerhub registries

  • Fix error when creating container groups from yaml file

0.2.1

  • Update PyYAML dependency to 4.2b4

0.2.0

  • Default to long running operation for az container create

  • Add Log Analytics parameters ‘–log-analytics-workspace’ and ‘–log-analytics-workspace-key’

  • Add –protocol parameter to specify which network protocol to use

0.1.24

  • Allow exporting a container group in yaml format.

  • Allow using a yaml file to create / update a container group.

0.1.23

  • Do not require –registry-server for az container create when a registry server is included in the image name.

0.1.22

  • Add Git Repo volume mount parameters ‘–gitrepo-url’ ‘–gitrepo-dir’ ‘–gitrepo-revision’ and ‘–gitrepo-mount-path’

0.1.21

0.1.20

  • Add ‘az container exec’ command that allows for exec commands in a container for a running container group.

  • Allow table output for creating and updating a container group.

0.1.19

  • Add ‘–secrets’ and ‘–secrets-mount-path’ options to ‘az container create’ for using secrets in ACI

0.1.18

  • Add ‘–follow’ option to ‘az container logs’ for streaming logs

  • Add ‘az container attach’ command that attaches local standard output and error streams to a container in a container group.

0.1.17

  • Minor fixes

0.1.16

  • Update for CLI core changes.

0.1.15

  • Fix incorrect order of parameters for container logs

0.1.14

  • Fixed default ports regression

0.1.13

  • minor fixes

  • Added support to open multiple ports

  • Added container group restart policy

  • Added support to mount Azure File share as a volume

  • Updated helper docs

0.1.12

  • minor fixes

0.1.11 (2017-09-22)

  • minor fixes

0.1.10 (2017-09-11)

  • minor fixes

0.1.9 (2017-08-28)

  • minor fixes

0.1.8 (2017-08-11)

  • container create: Fixes issue where equals sign was not allowed inside an environment variable.

0.1.7 (2017-07-27)

  • Preview release.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

azure-cli-container-0.3.13.tar.gz (23.2 kB view hashes)

Uploaded Source

Built Distribution

azure_cli_container-0.3.13-py2.py3-none-any.whl (23.0 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page