你当前正在访问 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-ghaz 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 获取完整的调试日志。