az aks draft
Note
This reference is part of the aks-preview extension for the Azure CLI (version 2.61.0 or higher). 该扩展将在首次运行 az aks draft 命令时自动安装。 Learn more about extensions.
用于在项目目录中生成部署文件的命令,并将其部署到 AKS 群集。
命令
名称 | 说明 | 类型 | Status |
---|---|---|---|
az aks draft create |
为项目目录生成 Dockerfile 和所需的最低 Kubernetes 部署文件(helm、kustomize、manifests)。 |
Extension | GA |
az aks draft generate-workflow |
生成 GitHub 工作流,以便自动生成并部署到 AKS。 |
Extension | GA |
az aks draft setup-gh |
为应用程序设置 GitHub OIDC。 |
Extension | GA |
az aks draft up |
然后 |
Extension | GA |
az aks draft update |
将应用程序更新为可访问 Internet。 |
Extension | 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
可选参数
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
指定 helm 版本的名称。
指定配置文件的路径。
仅为 Kubernetes 部署生成部署文件(helm、kustomize、manifests)。
指定项目目录的路径(默认值为 .)。
属性 | 值 |
---|---|
默认值: | . |
仅为 Kubernetes 部署生成 Dockerfile。
指定用于创建 Kubernetes 部署的语言。
自动下载并使用指定位置的草稿二进制文件。
全局参数
提高日志记录详细程度以显示所有调试日志。
属性 | 值 |
---|---|
默认值: | False |
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
属性 | 值 |
---|---|
默认值: | False |
Output format.
属性 | 值 |
---|---|
默认值: | json |
接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
属性 | 值 |
---|---|
默认值: | False |
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
可选参数
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
指定要从中自动部署的 GitHub 分支。
指定 AKS 群集名称。
指定容器映像的名称。
指定项目目录的路径(默认值为 .)。
自动下载并使用指定位置的草稿二进制文件。
指定项目目录的路径。
指定 Azure 资源组的名称。
全局参数
提高日志记录详细程度以显示所有调试日志。
属性 | 值 |
---|---|
默认值: | False |
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
属性 | 值 |
---|---|
默认值: | False |
Output format.
属性 | 值 |
---|---|
默认值: | json |
接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
属性 | 值 |
---|---|
默认值: | False |
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
可选参数
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
指定 Azure Active Directory 应用程序名称。
指定 GitHub 存储库(组织/repo_name)。
自动下载并使用指定位置的草稿二进制文件。
指定云提供商(默认值为 azure)。
属性 | 值 |
---|---|
默认值: | azure |
指定 Azure 资源组的名称。
指定 Azure 订阅 ID。
全局参数
提高日志记录详细程度以显示所有调试日志。
属性 | 值 |
---|---|
默认值: | False |
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
属性 | 值 |
---|---|
默认值: | False |
Output format.
属性 | 值 |
---|---|
默认值: | json |
接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 使用 --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 [--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
可选参数
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
指定应用程序的名称。
指定要从中自动部署的 GitHub 分支。
指定 AKS 群集名称。
指定容器映像的名称。
指定项目目录的路径(默认值为 .)。
指定 GitHub 存储库(组织/repo_name)。
自动下载并使用指定位置的草稿二进制文件。
指定云提供商(默认值为 azure)。
属性 | 值 |
---|---|
默认值: | azure |
指定项目目录的路径。
指定 Azure 资源组的名称。
指定 Azure 订阅 ID。
全局参数
提高日志记录详细程度以显示所有调试日志。
属性 | 值 |
---|---|
默认值: | False |
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
属性 | 值 |
---|---|
默认值: | False |
Output format.
属性 | 值 |
---|---|
默认值: | json |
接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
属性 | 值 |
---|---|
默认值: | False |
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
可选参数
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
指定要存在的 Keyvault 证书的 URI。
指定项目目录的路径(默认值为 .)。
指定入口资源的主机。
自动下载并使用指定位置的草稿二进制文件。
全局参数
提高日志记录详细程度以显示所有调试日志。
属性 | 值 |
---|---|
默认值: | False |
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
属性 | 值 |
---|---|
默认值: | False |
Output format.
属性 | 值 |
---|---|
默认值: | json |
接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
属性 | 值 |
---|---|
默认值: | False |