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

az aks draft

参考

注意

此参考是 Azure CLI（版本 2.61.0 或更高版本）的 aks-preview 扩展的一部分。该扩展将在首次运行 az aks draft 命令时自动安装。详细了解扩展。

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

命令

名称	说明	类型	Status
az aks draft create	为项目目录生成 Dockerfile 和所需的最低 Kubernetes 部署文件（helm、kustomize、manifests）。	扩展	GA
az aks draft generate-workflow	生成 GitHub 工作流，以便自动生成并部署到 AKS。	扩展	GA
az aks draft setup-gh	为应用程序设置 GitHub OIDC。	扩展	GA
az aks draft up	然后`az aks draft generate-workflow`运行 `az aks draft setup-gh` 。	扩展	GA
az aks draft update	将应用程序更新为可访问 Internet。	扩展	GA

az aks draft create

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

az aks draft create [--app]
                    [--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

可选参数

--app

指定 helm 版本的名称。

--create-config

指定配置文件的路径。

--deployment-only

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

--destination

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

默认值: .

--dockerfile-only

仅为 Kubernetes 部署生成 Dockerfile。

--language

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

--path

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

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

az aks draft generate-workflow

生成 GitHub 工作流，以便自动生成并部署到 AKS。

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

az aks draft generate-workflow [--branch]
                               [--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

可选参数

--branch

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

--cluster-name

指定 AKS 群集名称。

--container-name

指定容器映像的名称。

--destination

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

--path

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

--registry-name

指定项目目录的路径。

--resource-group

指定 Azure 资源组的名称。

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

az aks draft setup-gh

为应用程序设置 GitHub OIDC。

az aks draft setup-gh [--app]
                      [--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

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

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

可选参数

--app

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

--gh-repo

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

--path

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

--provider

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

默认值: azure

--resource-group

指定 Azure 资源组的名称。

--subscription-id

指定 Azure 订阅 ID。

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

az aks draft up

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

此命令合并 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 [--app]
                [--branch]
                [--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

可选参数

--app

指定应用程序的名称。

--branch

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

--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

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

az aks draft update

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

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

az aks draft update [--certificate]
                    [--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

可选参数

--certificate

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

--destination

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

--host

指定入口资源的主机。

--path

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

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

通过

az aks draft

命令

az aks draft create

示例

可选参数

az aks draft generate-workflow

示例

可选参数

az aks draft setup-gh

示例

可选参数

az aks draft up

示例

可选参数

az aks draft update

示例

可选参数

其他资源