您现在访问的是微软AZURE全球版技术文档网站,若需要访问由世纪互联运营的MICROSOFT AZURE中国区技术文档网站,请访问 https://docs.azure.cn.

az acs

管理 Azure 容器服务。

ACS 将在2020年1月31日作为独立服务停用。

如果使用 Kubernetes 业务流程协调程序,请于 2020 年 1 月 31 日之前迁移到 AKS。

命令

az acs browse

在 web 浏览器中显示服务容器 orchestrator 的仪表板。

az acs create

创建新的容器服务。

az acs dcos

用于管理 DC/OS 的 Azure 容器服务的命令。

az acs dcos browse

创建到 Azure 容器服务的 SSH 隧道,并在浏览器中打开 Mesosphere DC/OS 仪表板。

az acs dcos install-cli

下载并安装群集的 DC/OS 命令行工具。

az acs delete

删除容器服务。

az acs kubernetes

用于管理 Kubernetes 协调的 Azure 容器服务的命令。

az acs kubernetes browse

启动代理并浏览 Kubernetes web UI。

az acs kubernetes get-credentials

下载并安装用于访问群集的凭据。 此命令要求使用与创建群集相同的私钥。

az acs kubernetes install-cli

下载并安装群集的 Kubernetes 命令行工具。

az acs list

列出容器服务。

az acs list-locations

列出预览版Azure 容器服务生产环境的位置。

az acs scale

更改容器服务的专用代理计数。

az acs show

显示容器服务的详细信息。

az acs wait

等待容器服务达到所需状态。

az acs browse

在 web 浏览器中显示服务容器 orchestrator 的仪表板。

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

示例

在 web 浏览器中显示服务容器 orchestrator 的仪表板。 (自动生成)

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

必需参数

--name -n

容器服务的名称。 你可以使用配置默认的 az configure --defaults acs=<name>

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

可选参数

--disable-browser

在群集 web 用户界面中打开代理后,请不要打开浏览器。

--ssh-key-file

如果设置要使用的 SSH 密钥的路径,则仅适用于 DCOS。

--subscription

订阅的名称或 ID。 您可以使用配置默认订阅 az account set -s NAME_OR_ID

az acs create

创建新的容器服务。

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]

示例

使用现有的 SSH 密钥创建 DCOS 群集。

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

创建包含两个代理池的 DCOS 群集。

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

创建 DCOS 群集,其中的第二个代理池指定了 vmSize。

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

使用从文件指定的代理配置文件创建 DCOS 群集。

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

必需参数

--name -n

容器服务的名称。 你可以使用配置默认的 az configure --defaults acs=<name>

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

可选参数

--admin-password

Windows 节点的 "中的"。 仅当--windows = true 时可用。

--admin-username -u

Linux 虚拟机的用户名。

默认值: azureuser
--agent-count

设置代理池的默认代理数。

默认值: 3
--agent-osdisk-size

预览版中的功能,仅在 canadacentral、canadaeast、centralindia、koreasouth、koreacentral、southindia、uksouth、ukwest、westcentralus、westindia、westus2 中。 为代理池 vm 设置默认磁盘大小。 单位(GB)。 默认值:相应的 vmsize 磁盘大小。

--agent-ports

预览版中的功能,仅在 canadacentral、canadaeast、centralindia、koreasouth、koreacentral、southindia、uksouth、ukwest、westcentralus、westindia、westus2 中。 设置在代理池上公开的默认端口。 仅适用于非 Kubernetes。 默认值:8080、4000、80。

--agent-profiles -a

预览版中的功能,仅在 canadacentral、canadaeast、centralindia、koreasouth、koreacentral、southindia、uksouth、ukwest、westcentralus、westindia、westus2 中。 代理配置文件的文件或字典表示形式。 请注意,它将在设置后重写所有代理设置。

--agent-storage-profile

预览版中的功能,仅在 canadacentral、canadaeast、centralindia、koreasouth、koreacentral、southindia、uksouth、ukwest、westcentralus、westindia、westus2 中。 设置代理池的默认存储配置文件。 默认值:根据 Orchestrator 的不同而异。

接受的值: ManagedDisks, StorageAccount
--agent-vm-size

设置代理池 vm 的默认大小。

默认值: Standard_D2_v2
--agent-vnet-subnet-id

预览版中的功能,仅在 canadacentral、canadaeast、centralindia、koreasouth、koreacentral、southindia、uksouth、ukwest、westcentralus、westindia、westus2 中。 为代理池设置默认的自定义 vnet 子网 id。 注意如果主集,代理需要使用同一 vnet。 默认值: ""。

--api-version

预览版中的功能,仅在 canadacentral、canadaeast、centralindia、koreasouth、koreacentral、southindia、uksouth、ukwest、westcentralus、westindia、westus2 中。 使用 ACS 的 API 版本执行 az ACS 操作。 可用选项:2017-01-31、2017-07-01。 默认值:最新版本的位置。

--client-secret

与服务主体关联的机密。 如果指定了,则此参数是必需的 --service-principal

--dns-prefix -d

设置群集的域名前缀。 域名和区域化 DNS 区域的串联构成了与公共 IP 地址关联的完全限定域名。

--generate-ssh-keys

生成 SSH 公钥和私钥文件(如果缺少)。

--location -l

位置。 az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。

--master-count

群集的主机数。

默认值: 1
--master-first-consecutive-static-ip

预览版中的功能,仅在 canadacentral、canadaeast、centralindia、koreasouth、koreacentral、southindia、uksouth、ukwest、westcentralus、westindia、westus2 中。 用于指定静态 ip 块的第一个连续 ip。

默认值: 10.240.255.5
--master-osdisk-size

预览版中的功能,仅在 canadacentral、canadaeast、centralindia、koreasouth、koreacentral、southindia、uksouth、ukwest、westcentralus、westindia、westus2 中。 主池 vm 的磁盘大小。 单位(GB)。 默认值:相应的 vmsize 磁盘大小。

--master-profile -m

预览版中的功能,仅在 canadacentral、canadaeast、centralindia、koreasouth、koreacentral、southindia、uksouth、ukwest、westcentralus、westindia、westus2 中。 主配置文件的文件或字典表示形式。 请注意,在设置后,它将覆盖任何主设置。

--master-storage-profile

预览版中的功能,仅在 canadacentral、canadaeast、centralindia、koreasouth、koreacentral、southindia、uksouth、ukwest、westcentralus、westindia、westus2 中。 默认值:根据 Orchestrator 的不同而异。

接受的值: ManagedDisks, StorageAccount
--master-vm-size

预览版中的功能,仅在 canadacentral、canadaeast、centralindia、koreasouth、koreacentral、southindia、uksouth、ukwest、westcentralus、westindia、westus2 中。

默认值: Standard_D2_v2
--master-vnet-subnet-id

预览版中的功能,仅在 canadacentral、canadaeast、centralindia、koreasouth、koreacentral、southindia、uksouth、ukwest、westcentralus、westindia、westus2 中。 自定义 vnet 子网 id。注意如果主集,代理需要使用同一 vnet。 默认值: ""。

--no-wait

不等待长时间运行的操作完成。

--orchestrator-type -t

用于管理群集上的应用程序的 orchestrator 的类型。

接受的值: Custom, DCOS, DockerCE, Kubernetes, Swarm
默认值: DCOS
--orchestrator-version

预览版中的功能,仅在 canadacentral、canadaeast、centralindia、koreasouth、koreacentral、southindia、uksouth、ukwest、westcentralus、westindia、westus2 中。 使用 Orchestrator 版本为所选的 orchestrator 指定语义版本。

--service-principal

用于对 Azure API 进行身份验证的服务主体。

--ssh-key-value

配置具有 SSH RSA 公钥字符串的所有 linux 计算机。 你的密钥应包括三个部分,例如 "ssh-rsa AAAAB .。。截图 .。。Ssh-rsa aaaab3nz...<...>...ucyupgh azureuser@linuxvm 。

默认值: ~\.ssh\id_rsa.pub
--subscription

订阅的名称或 ID。 您可以使用配置默认订阅 az account set -s NAME_OR_ID

--tags

空格分隔标记:键 [= 值] [键 [= 值] ...]。使用 "" 清除现有标记。

--validate

生成并验证 ARM 模板,而无需创建任何资源。

--windows

如果为 true,则将代理池的默认 osType 设置为 Windows。

az acs delete

删除容器服务。

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

示例

删除容器服务。 (自动生成)

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

必需参数

--name -n

容器服务的名称。 你可以使用配置默认的 az configure --defaults acs=<name>

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

可选参数

--subscription

订阅的名称或 ID。 您可以使用配置默认订阅 az account set -s NAME_OR_ID

--yes -y

不提示确认。

az acs list

列出容器服务。

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

可选参数

--query-examples

建议 JMESPath 字符串。 可以复制其中一个查询并将其粘贴到 --query 参数的双引号内,以查看结果。 可以添加一个或多个位置关键字,以便我们可以基于这些关键字提供建议。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 配置默认订阅 az account set -s NAME_OR_ID

az acs list-locations

列出预览版Azure 容器服务生产环境的位置。

az acs list-locations [--subscription]

可选参数

--subscription

订阅的名称或 ID。 可以使用 配置默认订阅 az account set -s NAME_OR_ID

az acs scale

更改容器服务的专用代理计数。

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

示例

更改容器服务的专用代理计数。 (自动生成)

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

必需参数

--name -n

容器服务的名称。 可以使用 配置默认值 az configure --defaults acs=<name>

--new-agent-count

容器服务的代理数。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

可选参数

--subscription

订阅的名称或 ID。 可以使用 配置默认订阅 az account set -s NAME_OR_ID

az acs show

显示容器服务的详细信息。

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

示例

显示容器服务的详细信息。 (自动生成)

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

必需参数

--name -n

容器服务的名称。 可以使用 配置默认值 az configure --defaults acs=<name>

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

可选参数

--query-examples

建议使用 JMESPath 字符串。 可以复制其中一个查询并将其粘贴到 --query 参数的双引号内,以查看结果。 可以添加一个或多个位置关键字,以便我们可以基于这些关键字提供建议。

--subscription

订阅的名称或 ID。 可以使用 配置默认订阅 az account set -s NAME_OR_ID

az acs wait

等待容器服务达到所需状态。

如果容器服务上的操作中断或使用 启动,请使用此命令 --no-wait 等待该操作完成。

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

必需参数

--name -n

容器服务的名称。 可以使用 配置默认值 az configure --defaults acs=<name>

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

可选参数

--created

等到创建时"provisioningState"位于"Succeeded"。

--custom

等待条件满足自定义 JMESPath 查询。 例如 provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running']。

--deleted

等到删除。

--exists

等待资源存在。

--interval

轮询间隔(以秒为单位)。

默认值: 30
--subscription

订阅的名称或 ID。 可以使用 配置默认订阅 az account set -s NAME_OR_ID

--timeout

最大等待时间(以秒表示)。

默认值: 3600
--updated

等待,直到使用 provisioningState 更新为"Succeeded"。