通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az aks draft

Note

此参考是Azure CLI版本 2.73.0 或更高版本的 aks-preview 扩展的一部分。 该扩展将在首次运行 az aks draft 命令时自动安装。 了解更多关于扩展的信息。

用于在项目目录中生成部署文件的命令，并将其部署到 AKS 群集。

命令

名称 说明 类型 Status
az aks draft create

为项目目录生成 Dockerfile 和所需的最低 Kubernetes 部署文件（helm、kustomize、manifests）。

 Extension GA
az aks draft generate-workflow

生成用于自动生成并部署到 AKS 的GitHub工作流。

 Extension GA
az aks draft setup-gh

为应用程序设置GitHub OIDC。

 Extension GA
az aks draft up

然后az aks draft setup-gh运行 az aks draft generate-workflow 。

 Extension GA
az aks draft update

将应用程序更新为可访问 Internet。

 Extension GA

az aks draft create

为项目目录生成 Dockerfile 和所需的最低 Kubernetes 部署文件（helm、kustomize、manifests）。

az aks draft create [--acquire-policy-token]
                    [--app]
                    [--change-reference]
                    [--create-config]
                    [--deployment-only]
                    [--destination]
                    [--dockerfile-only]
                    [--language]
                    [--path]

示例

提示在当前目录中生成 Dockerfile 和部署文件。

az aks draft create

仅生成当前目录中的 Dockerfile。

az aks draft create --dockerfile-only=true

仅生成当前目录中的部署文件。

az aks draft create --deployment-only=true

在特定项目目录中生成具有应用名称的 Java 项目中的 Dockerfile 和部署文件。

az aks draft create --language=java --app=some_app --destination=/projects/some_project

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--acquire-policy-token

为此资源操作自动获取Azure Policy令牌。

属性 值
参数组: Global Policy Arguments
--app

指定 helm 版本的名称。

--change-reference

此资源操作的相关更改引用 ID。

属性 值
参数组: Global Policy Arguments
--create-config

指定配置文件的路径。

--deployment-only

仅为 Kubernetes 部署生成部署文件（helm、kustomize、manifests）。

--destination

指定项目目录的路径（默认值为 .）。

属性 值
默认值: .
--dockerfile-only

仅为 Kubernetes 部署生成 Dockerfile。

--language

指定用于创建 Kubernetes 部署的语言。

--path

自动下载并使用指定位置的草稿二进制文件。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

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

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False

az aks draft generate-workflow

生成用于自动生成并部署到 AKS 的GitHub工作流。

运行此命令之前，请确保已为应用程序设置 GitHub OIDC。 还需要在Azure上创建资源组、容器注册表和 Kubernetes 群集，并使用 az aks update -n <cluster-name> -g <resource-group-name> --attach-acr <acr-name>链接三个资源。

az aks draft generate-workflow [--acquire-policy-token]
                               [--branch]
                               [--change-reference]
                               [--cluster-name]
                               [--container-name]
                               [--destination]
                               [--path]
                               [--registry-name]
                               [--resource-group]

示例

提示在当前目录中生成GitHub工作流。

az aks draft generate-workflow

提示在特定项目目录中生成GitHub工作流。

az aks draft generate-workflow --destination=/projects/some_project

使用资源组、AKS 群集名称、特定项目目录中的容器注册表名称生成GitHub工作流。

az aks draft generate-workflow --resource-group=some_rg --cluster-name=some_cluster --registry-name=some_registry --destination=/projects/some_project

生成一个GitHub工作流，该工作流使用资源组、AKS 群集名称、容器注册表名称和特定项目目录中的容器映像名称从主分支部署。

az aks draft generate-workflow --branch=main --resource-group=some_rg --cluster-name=some_cluster --registry-name=some_registry --container-name=some_image --destination=/projects/some_project

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--acquire-policy-token

为此资源操作自动获取Azure Policy令牌。

属性 值
参数组: Global Policy Arguments
--branch

指定要从中自动部署的GitHub分支。

--change-reference

此资源操作的相关更改引用 ID。

属性 值
参数组: Global Policy Arguments
--cluster-name

指定 AKS 群集名称。

--container-name

指定容器映像的名称。

--destination

指定项目目录的路径（默认值为 .）。

--path

自动下载并使用指定位置的草稿二进制文件。

--registry-name

指定项目目录的路径。

--resource-group

指定Azure资源组的名称。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

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

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False

az aks draft setup-gh

为应用程序设置GitHub OIDC。

az aks draft setup-gh [--acquire-policy-token]
                      [--app]
                      [--change-reference]
                      [--gh-repo]
                      [--path]
                      [--provider]
                      [--resource-group]
                      [--subscription-id]

示例

提示为存储库设置 GitHub OIDC。

az aks draft setup-gh

为特定存储库设置Azure上的 GitHub OIDC。

az aks draft setup-gh --provider=azure --gh-repo=some_organization/some_repo

使用订阅 ID 和资源组在Azure上设置 GitHub OIDC。

az aks draft setup-gh --provider=azure --subscription-id=some_subscription --resource-group=some_rg

使用特定存储库的订阅 ID 和资源组Azure上的应用程序名称设置GitHub OIDC。

az aks draft setup-gh --app=some_app --provider=azure --subscription-id=some_subscription --resource-group=some_rg --gh-repo=some_organization/some_repo

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--acquire-policy-token

为此资源操作自动获取Azure Policy令牌。

属性 值
参数组: Global Policy Arguments
--app

指定Azure Active Directory应用程序名称。

--change-reference

此资源操作的相关更改引用 ID。

属性 值
参数组: Global Policy Arguments
--gh-repo

指定GitHub存储库（组织/repo_name）。

--path

自动下载并使用指定位置的草稿二进制文件。

--provider

指定云提供商（默认值为 azure）。

属性 值
默认值: azure
--resource-group

指定Azure资源组的名称。

--subscription-id

指定Azure订阅 ID。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

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

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False

az aks draft up

然后az aks draft setup-gh运行 az aks draft generate-workflow 。

此命令结合了 az aks draft setup-gh 和 az aks draft generate-workflow来设置 GitHub OIDC 并生成用于自动生成和部署到 AKS 的GitHub工作流。 运行此命令之前，请在Azure上创建资源组、容器注册表和 Kubernetes 群集，并使用 az aks update -n <cluster-name> -g <resource-group-name> --attach-acr <acr-name> 链接三个资源。

az aks draft up [--acquire-policy-token]
                [--app]
                [--branch]
                [--change-reference]
                [--cluster-name]
                [--container-name]
                [--destination]
                [--gh-repo]
                [--path]
                [--provider]
                [--registry-name]
                [--resource-group]
                [--subscription-id]

示例

提示设置 GitHub OIDC，然后在当前目录中生成GitHub工作流。

az aks draft up

提示设置 GitHub OIDC，然后在特定项目目录中生成GitHub工作流。

az aks draft up --destination=/projects/some_project

提示为特定存储库设置 GitHub OIDC，然后在特定项目目录中生成GitHub工作流。

az aks draft up --gh-repo=some_organization/some_repo --destination=/projects/some_project

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--acquire-policy-token

为此资源操作自动获取Azure Policy令牌。

属性 值
参数组: Global Policy Arguments
--app

指定应用程序的名称。

--branch

指定要从中自动部署的GitHub分支。

--change-reference

此资源操作的相关更改引用 ID。

属性 值
参数组: Global Policy Arguments
--cluster-name

指定 AKS 群集名称。

--container-name

指定容器映像的名称。

--destination

指定项目目录的路径（默认值为 .）。

--gh-repo

指定GitHub存储库（组织/repo_name）。

--path

自动下载并使用指定位置的草稿二进制文件。

--provider

指定云提供商（默认值为 azure）。

属性 值
默认值: azure
--registry-name

指定项目目录的路径。

--resource-group

指定Azure资源组的名称。

--subscription-id

指定Azure订阅 ID。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

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

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False

az aks draft update

将应用程序更新为可访问 Internet。

此命令根据需要自动更新 yaml 文件，以便应用程序能够接收外部请求。

az aks draft update [--acquire-policy-token]
                    [--certificate]
                    [--change-reference]
                    [--destination]
                    [--host]
                    [--path]

示例

提示将应用程序更新为可访问 Internet。

az aks draft update

提示更新应用程序以在特定项目目录中访问 Internet。

az aks draft update --destination=/projects/some_project

使用特定项目目录中的入口资源和 Keyvault 证书的主机更新应用程序以访问 Internet。

az aks draft update --host=some_host --certificate=some_certificate --destination=/projects/some_project

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--acquire-policy-token

为此资源操作自动获取Azure Policy令牌。

属性 值
参数组: Global Policy Arguments
--certificate

指定要存在的 Keyvault 证书的 URI。

--change-reference

此资源操作的相关更改引用 ID。

属性 值
参数组: Global Policy Arguments
--destination

指定项目目录的路径（默认值为 .）。

--host

指定入口资源的主机。

--path

自动下载并使用指定位置的草稿二进制文件。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

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

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False