Container Service - az acs

Manage Azure Container Services.

Commands

az acs browse Opens a browser to the web interface for the cluster orchestrator.
az acs create Create a container service with your preferred orchestrator.
az acs dcos Manage a DCOS 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 Downloads the dcos command line from Mesosphere.
az acs delete Delete a container service from your subscription.
az acs install-cli Download the DCOS/Kubernetes command line.
az acs kubernetes Manage a Kubernetes orchestrated Azure Container service.
az acs kubernetes browse Wrapper on the 'kubectl proxy' command, for consistency with 'az dcos browse'.
az acs kubernetes get-credentials Create a new Acs.
az acs kubernetes install-cli Downloads the kubectl command line from Kubernetes.
az acs list List the container services in your subscription.
az acs scale Change the private agent count of a container service.
az acs show Show a container service in your subscription.

az acs browse

Opens a browser to the web interface for the cluster orchestrator.

Synopsis

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

Required Parameters

  • --name -n
    ACS cluster name. You can configure the default using 'az configure --defaults acs='.
  • --resource-group -g
    Name of resource group. You can configure the default group using 'az configure --defaults group='.

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.
    default value: C:Usersappveyor.sshid_rsa

az acs create

Create a container service with your preferred orchestrator.

Synopsis

az acs create --name
--resource-group
[--admin-password]
[--admin-username]
[--agent-count]
[--agent-vm-size]
[--client-secret]
[--dns-prefix]
[--generate-ssh-keys]
[--location]
[--master-count]
[--orchestrator-type {Custom, DCOS, Kubernetes, Swarm}]
[--service-principal]
[--ssh-key-value]
[--tags]
[--windows]

Examples

Create a Kubernetes container service and generate keys.

az acs create -g MyResourceGroup -n MyContainer_service --orchestrator-type kubernetes --generate-ssh-keys

Required Parameters

  • --name -n
    ACS cluster name. You can configure the default using 'az configure --defaults acs='.
  • --resource-group -g
    Name of resource group. You can configure the default group using 'az configure --defaults group='.

Optional Parameters

  • --admin-password
    The adminstration password for Windows nodes. Only available if --windows=true.
  • --admin-username
    User name for the Linux Virtual Machines.
    default value: azureuser
  • --agent-count
    The number of agents for the cluster. Note, for DC/OS clusters you will also get 1 or 2 public agents in addition to these selected masters.
    default value: 3
  • --agent-vm-size
    The size of the Virtual Machine.
    default value: Standard_D2_v2
  • --client-secret
    Client secret to use with the service principal for making calls to Azure APIs.
  • --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. You can configure the default location using 'az configure --defaults location='.
  • --master-count
    The number of masters for the cluster.
    default value: 1
  • --orchestrator-type -t
    The type of orchestrator used to manage the applications on the cluster.
    accepted values: Custom, DCOS, Kubernetes, Swarm
    default value: dcos
  • --service-principal
    Service principal for making calls into Azure APIs.
  • --ssh-key-value
    SSH key file value or key file path.
    default value: ~.sshid_rsa.pub
  • --tags
    Tags object.
  • --windows
    If true, deploy a windows container cluster.

az acs delete

Delete a container service from your subscription.

Synopsis

az acs delete --name
--resource-group

Required Parameters

  • --name -n
    The name of the container service.
  • --resource-group -g
    Name of resource group. You can configure the default group using 'az configure --defaults group='.

az acs install-cli

Download the DCOS/Kubernetes command line.

Synopsis

az acs install-cli --name
--resource-group
[--client-version]
[--install-location]

Required Parameters

  • --name -n
    ACS cluster name. You can configure the default using 'az configure --defaults acs='.
  • --resource-group -g
    Name of resource group. You can configure the default group using 'az configure --defaults group='.

Optional Parameters

  • --client-version
  • --install-location

az acs list

List the container services in your subscription.

Synopsis

az acs list [--resource-group]

Optional Parameters

  • --resource-group -g
    Name of resource group. You can configure the default group using 'az configure --defaults group='.

az acs scale

Change the private agent count of a container service.

Synopsis

az acs scale --name
--new-agent-count
--resource-group

Required Parameters

  • --name -n
    The name of the container service.
  • --new-agent-count
    The number of agents for the cluster.
  • --resource-group -g
    Name of resource group. You can configure the default group using 'az configure --defaults group='.

az acs show

Show a container service in your subscription.

Synopsis

az acs show --name
--resource-group

Required Parameters

  • --name -n
    The name of the container service.
  • --resource-group -g
    Name of resource group. You can configure the default group using 'az configure --defaults group='.