az acs

Manage Azure Container Services.

ACS will be retired as a standalone service on January 31, 2020.

If you use the Kubernetes orchestrator, please migrate to AKS by January 31, 2020.

Commands

az acs browse	Show the dashboard for a service container's orchestrator in a web browser.
az acs create	Create a new container service.
az acs dcos	Commands to manage a DC/OS-orchestrated Azure Container Service.
az acs dcos browse	Creates an SSH tunnel to the Azure container service, and opens the Mesosphere DC/OS dashboard in the browser.
az acs dcos install-cli	Download and install the DC/OS command-line tool for a cluster.
az acs delete	Delete a container service.
az acs kubernetes	Commands to manage a Kubernetes-orchestrated Azure Container Service.
az acs kubernetes browse	Launch a proxy and browse the Kubernetes web UI.
az acs kubernetes get-credentials	Download and install credentials to access a cluster. This command requires the same private-key used to create the cluster.
az acs kubernetes install-cli	Download and install the Kubernetes command-line tool for a cluster.
az acs list	List container services.
az acs list-locations	List locations where Azure Container Service is in preview and in production.
az acs scale	Change the private agent count of a container service.
az acs show	Show the details for a container service.
az acs wait	Wait for a container service to reach a desired state.

az acs browse

Edit

Show the dashboard for a service container's orchestrator in a web browser.

az acs browse --name
              --resource-group
              [--disable-browser]
              [--ssh-key-file]
              [--subscription]

Examples

Show the dashboard for a service container's orchestrator in a web browser. (autogenerated)

az acs browse --name MyContainerService --resource-group MyResourceGroup

Required Parameters

--name -n

Name of the container service. You can configure the default using az configure --defaults acs=<name>.

--resource-group -g

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

Optional Parameters

--disable-browser

Do not open browser after opening a proxy to the cluster web user interface.

--ssh-key-file

If set a path to an SSH key to use, only applies to DCOS.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az acs create

Edit

Create a new container service.

az acs create --name
              --resource-group
              [--admin-password]
              [--admin-username]
              [--agent-count]
              [--agent-osdisk-size]
              [--agent-ports]
              [--agent-profiles]
              [--agent-storage-profile {ManagedDisks, StorageAccount}]
              [--agent-vm-size]
              [--agent-vnet-subnet-id]
              [--api-version]
              [--client-secret]
              [--dns-prefix]
              [--generate-ssh-keys]
              [--location]
              [--master-count]
              [--master-first-consecutive-static-ip]
              [--master-osdisk-size]
              [--master-profile]
              [--master-storage-profile {ManagedDisks, StorageAccount}]
              [--master-vm-size]
              [--master-vnet-subnet-id]
              [--no-wait]
              [--orchestrator-type {Custom, DCOS, DockerCE, Kubernetes, Swarm}]
              [--orchestrator-version]
              [--service-principal]
              [--ssh-key-value]
              [--subscription]
              [--tags]
              [--validate]
              [--windows]

Examples

Create a DCOS cluster with an existing SSH key.

az acs create --orchestrator-type DCOS -g MyResourceGroup -n MyContainerService \
  --ssh-key-value /path/to/publickey

Create a DCOS cluster with two agent pools.

az acs create -g MyResourceGroup -n MyContainerService --agent-profiles '[ \
  { \
    "name": "agentpool1" \
  }, \
  { \
    "name": "agentpool2" \
  }]'

Create a DCOS cluster where the second agent pool has a vmSize specified.

az acs create -g MyResourceGroup -n MyContainerService --agent-profiles '[ \
  { \
    "name": "agentpool1" \
  }, \
  { \
    "name": "agentpool2", \
    "vmSize": "Standard_D2" \
  }]'

Create a DCOS cluster with agent-profiles specified from a file.

az acs create -g MyResourceGroup -n MyContainerService --agent-profiles MyAgentProfiles.json

Required Parameters

--name -n

Name of the container service. You can configure the default using az configure --defaults acs=<name>.

--resource-group -g

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

Optional Parameters

--admin-password

The adminstration password for Windows nodes. Only available if --windows=true.

--admin-username -u

User name for the Linux Virtual Machines.

default value: azureuser

--agent-count

Set the default number of agents for the agent pools.

default value: 3

--agent-osdisk-size

Feature in preview, only in canadacentral, canadaeast, centralindia, koreasouth, koreacentral, southindia, uksouth, ukwest, westcentralus, westindia, westus2. Set the default disk size for agent pools vms. Unit in GB. Default: corresponding vmsize disk size.

--agent-ports

Feature in preview, only in canadacentral, canadaeast, centralindia, koreasouth, koreacentral, southindia, uksouth, ukwest, westcentralus, westindia, westus2. Set the default ports exposed on the agent pools. Only usable for non-Kubernetes. Default: 8080,4000,80.

--agent-profiles -a

Feature in preview, only in canadacentral, canadaeast, centralindia, koreasouth, koreacentral, southindia, uksouth, ukwest, westcentralus, westindia, westus2. The file or dictionary representation of the agent profiles. Note it will override any agent settings once set.

--agent-storage-profile

Feature in preview, only in canadacentral, canadaeast, centralindia, koreasouth, koreacentral, southindia, uksouth, ukwest, westcentralus, westindia, westus2. Set default storage profile for agent pools. Default: varies based on Orchestrator.

accepted values: ManagedDisks, StorageAccount

--agent-vm-size

Set the default size for agent pools vms.

default value: Standard_D2_v2

--agent-vnet-subnet-id

Feature in preview, only in canadacentral, canadaeast, centralindia, koreasouth, koreacentral, southindia, uksouth, ukwest, westcentralus, westindia, westus2. Set the default custom vnet subnet id for agent pools. Note agent need to used the same vnet if master set. Default: "".

--api-version

Feature in preview, only in canadacentral, canadaeast, centralindia, koreasouth, koreacentral, southindia, uksouth, ukwest, westcentralus, westindia, westus2. Use API version of ACS to perform az acs operations. Available options: 2017-01-31, 2017-07-01. Default: the latest version for the location.

--client-secret

Secret associated with the service principal. This argument is required if --service-principal is specified.

--dns-prefix -d

Sets the Domain name prefix for the cluster. The concatenation of the domain name and the regionalized DNS zone make up the fully qualified domain name associated with the public IP address.

--generate-ssh-keys

Generate SSH public and private key files if missing.

--location -l

Location. Values from: az account list-locations. You can configure the default location using az configure --defaults location=<location>.

--master-count

The number of masters for the cluster.

default value: 1

--master-first-consecutive-static-ip

Feature in preview, only in canadacentral, canadaeast, centralindia, koreasouth, koreacentral, southindia, uksouth, ukwest, westcentralus, westindia, westus2. The first consecutive ip used to specify static ip block.

default value: 10.240.255.5

--master-osdisk-size

Feature in preview, only in canadacentral, canadaeast, centralindia, koreasouth, koreacentral, southindia, uksouth, ukwest, westcentralus, westindia, westus2. The disk size for master pool vms. Unit in GB. Default: corresponding vmsize disk size.

--master-profile -m

Feature in preview, only in canadacentral, canadaeast, centralindia, koreasouth, koreacentral, southindia, uksouth, ukwest, westcentralus, westindia, westus2. The file or dictionary representation of the master profile. Note it will override any master settings once set.

--master-storage-profile

Feature in preview, only in canadacentral, canadaeast, centralindia, koreasouth, koreacentral, southindia, uksouth, ukwest, westcentralus, westindia, westus2. Default: varies based on Orchestrator.

accepted values: ManagedDisks, StorageAccount

--master-vm-size

Feature in preview, only in canadacentral, canadaeast, centralindia, koreasouth, koreacentral, southindia, uksouth, ukwest, westcentralus, westindia, westus2.

default value: Standard_D2_v2

--master-vnet-subnet-id

Feature in preview, only in canadacentral, canadaeast, centralindia, koreasouth, koreacentral, southindia, uksouth, ukwest, westcentralus, westindia, westus2. The custom vnet subnet id. Note agent need to used the same vnet if master set. Default: "".

--no-wait

Do not wait for the long-running operation to finish.

--orchestrator-type -t

The type of orchestrator used to manage the applications on the cluster.

accepted values: Custom, DCOS, DockerCE, Kubernetes, Swarm

default value: DCOS

--orchestrator-version

Feature in preview, only in canadacentral, canadaeast, centralindia, koreasouth, koreacentral, southindia, uksouth, ukwest, westcentralus, westindia, westus2. Use Orchestrator Version to specify the semantic version for your choice of orchestrator.

--service-principal

Service principal used for authentication to Azure APIs.

--ssh-key-value

Configure all linux machines with the SSH RSA public key string. Your key should include three parts, for example 'ssh-rsa AAAAB...snip...UcyupgH azureuser@linuxvm.

default value: ~\.ssh\id_rsa.pub

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--tags

Space-separated tags: key[=value] [key[=value] ...]. Use "" to clear existing tags.

--validate

Generate and validate the ARM template without creating any resources.

--windows

If true, set the default osType of agent pools to be Windows.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az acs delete

Edit

Delete a container service.

az acs delete --name
              --resource-group
              [--subscription]
              [--yes]

Examples

Delete a container service. (autogenerated)

az acs delete --name MyContainerService --resource-group MyResourceGroup

Required Parameters

--name -n

Name of the container service. You can configure the default using az configure --defaults acs=<name>.

--resource-group -g

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

Optional Parameters

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--yes -y

Do not prompt for confirmation.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az acs list

Edit

List container services.

az acs list [--resource-group]
            [--subscription]

Optional Parameters

--resource-group -g

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

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az acs list-locations

Edit

List locations where Azure Container Service is in preview and in production.

az acs list-locations [--subscription]

Optional Parameters

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az acs scale

Edit

Change the private agent count of a container service.

az acs scale --name
             --new-agent-count
             --resource-group
             [--subscription]

Examples

Change the private agent count of a container service. (autogenerated)

az acs scale --name MyContainerService --new-agent-count 10 --resource-group MyResourceGroup

Required Parameters

--name -n

Name of the container service. You can configure the default using az configure --defaults acs=<name>.

--new-agent-count

The number of agents for the container service.

--resource-group -g

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

Optional Parameters

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az acs show

Edit

Show the details for a container service.

az acs show --name
            --resource-group
            [--subscription]

Examples

Show the details for a container service. (autogenerated)

az acs show --name MyContainerService --resource-group MyResourceGroup

Required Parameters

--name -n

Name of the container service. You can configure the default using az configure --defaults acs=<name>.

--resource-group -g

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

Optional Parameters

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az acs wait

Edit

Wait for a container service to reach a desired state.

az acs wait --name
            --resource-group
            [--created]
            [--custom]
            [--deleted]
            [--exists]
            [--interval]
            [--subscription]
            [--timeout]
            [--updated]

Required Parameters

--name -n

Name of the container service. You can configure the default using az configure --defaults acs=<name>.

--resource-group -g

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

Optional Parameters

--created

Wait until created with 'provisioningState' at 'Succeeded'.

--custom

Wait until the condition satisfies a custom JMESPath query. E.g. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Wait until deleted.

--exists

Wait until the resource exists.

--interval

Polling interval in seconds.

default value: 30

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--timeout

Maximum wait in seconds.

default value: 3600

--updated

Wait until updated with provisioningState at 'Succeeded'.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az acs

Commands

az acs browse

Examples

Required Parameters

Optional Parameters

az acs create

Examples

Required Parameters

Optional Parameters

az acs delete

Examples

Required Parameters

Optional Parameters

az acs list

Optional Parameters

az acs list-locations

Optional Parameters

az acs scale

Examples

Required Parameters

Optional Parameters

az acs show

Examples

Required Parameters

Optional Parameters

az acs wait

Required Parameters

Optional Parameters

Is this page helpful?

Feedback

Is this page helpful?