Compartilhar via

az aks draft

Note

Essa referência faz parte da extensão aks-preview para o CLI do Azure (versão 2.73.0 ou superior). A extensão instalará automaticamente na primeira vez que você executar um comando az aks draft. Saiba mais sobre extensões.

Comandos para criar arquivos de implantação em um diretório de projeto e implantar em um cluster do AKS.

Comandos

Nome Description Tipo Status
az aks draft create

Gere um Dockerfile e os arquivos mínimos de implantação do Kubernetes necessários (helm, kustomize, manifestos) para o diretório do projeto.

 Extension GA
az aks draft generate-workflow

Gere um fluxo de trabalho GitHub para compilação automática e implantação no AKS.

 Extension GA
az aks draft setup-gh

Configure GitHub OIDC para seu aplicativo.

 Extension GA
az aks draft up

Execute az aks draft setup-gh então az aks draft generate-workflow.

 Extension GA
az aks draft update

Atualize seu aplicativo para ser acessível pela Internet.

 Extension GA

az aks draft create

Gere um Dockerfile e os arquivos mínimos de implantação do Kubernetes necessários (helm, kustomize, manifestos) para o diretório do projeto.

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

Exemplos

Solicitar a geração de um Dockerfile e arquivos de implantação no diretório atual.

az aks draft create

Gere apenas o Dockerfile no diretório atual.

az aks draft create --dockerfile-only=true

Gere apenas os arquivos de implantação no diretório atual.

az aks draft create --deployment-only=true

Gere um Dockerfile e um arquivo de implantação em um projeto Java com um nome de aplicativo em um diretório de projeto específico.

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--app

Especifique o nome da versão do helm.

--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--create-config

Especifique o caminho para o arquivo de configuração.

--deployment-only

Gere apenas arquivos de implantação (helm, kustomize, manifestos) para a implantação do Kubernetes.

--destination

Especifique o caminho para o diretório do projeto (o padrão é .).

Propriedade Valor
Valor padrão: .
--dockerfile-only

Gere apenas o Dockerfile para a implantação do Kubernetes.

--language

Especifique o idioma usado para criar a implantação do Kubernetes.

--path

Baixe e use automaticamente o binário De rascunho no local especificado.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az aks draft generate-workflow

Gere um fluxo de trabalho GitHub para compilação automática e implantação no AKS.

Antes de executar esse comando, verifique se você configurou GitHub OIDC para seu aplicativo. Você também precisa criar um grupo de recursos, um registro de contêiner e um cluster kubernetes no Azure e vincular os três recursos usando 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]

Exemplos

Solicitar a geração de um fluxo de trabalho GitHub no diretório atual.

az aks draft generate-workflow

Solicitar a geração de um fluxo de trabalho GitHub em um diretório de projeto específico.

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

Gere um fluxo de trabalho GitHub com um grupo de recursos, um nome de cluster do AKS, um nome de registro de contêiner em um diretório de projeto específico.

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

Gere um fluxo de trabalho GitHub que é implantado do branch principal com um grupo de recursos, um nome de cluster do AKS, um nome de registro de contêiner e um nome de imagem de contêiner em um diretório de projeto específico.

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--branch

Especifique o branch GitHub do qual implantar automaticamente.

--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--cluster-name

Especifique o nome do cluster do AKS.

--container-name

Especifique o nome da imagem do contêiner.

--destination

Especifique o caminho para o diretório do projeto (o padrão é .).

--path

Baixe e use automaticamente o binário De rascunho no local especificado.

--registry-name

Especifique o caminho para o diretório do projeto.

--resource-group

Especifique o nome do grupo de recursos Azure.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az aks draft setup-gh

Configure GitHub OIDC para seu aplicativo.

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

Exemplos

Solicitar a instalação do OIDC GitHub para um repositório.

az aks draft setup-gh

Configure o GitHub OIDC em Azure para um repositório específico.

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

Configure o OIDC GitHub em Azure com a ID da assinatura e o grupo de recursos.

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

Configure o GitHub OIDC com um nome de aplicativo em Azure com iD de assinatura e grupo de recursos para um repositório específico.

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--app

Especifique o nome do applicaton Azure Active Directory.

--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--gh-repo

Especifique o repositório GitHub (organização/repo_name).

--path

Baixe e use automaticamente o binário De rascunho no local especificado.

--provider

Especifique o provedor de nuvem (o padrão é o azure).

Propriedade Valor
Valor padrão: azure
--resource-group

Especifique o nome do grupo de recursos Azure.

--subscription-id

Especifique a ID da assinatura Azure.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az aks draft up

Execute az aks draft setup-gh então az aks draft generate-workflow.

Esse comando combina az aks draft setup-gh e az aks draft generate-workflow para configurar GitHub OIDC e gerar um fluxo de trabalho GitHub para compilação e implantação automática no AKS. Antes de executar esse comando, crie um grupo de recursos, um registro de contêiner e um cluster kubernetes no Azure e vincule os três recursos usando 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]

Exemplos

Solicite a instalação do OIDC de GitHub e, em seguida, gere um fluxo de trabalho GitHub no diretório atual.

az aks draft up

Solicite a instalação do OIDC de GitHub e, em seguida, gere um fluxo de trabalho GitHub em um diretório de projeto específico.

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

Solicite a instalação do OIDC GitHub para um repositório específico e, em seguida, gere um fluxo de trabalho GitHub em um diretório de projeto específico.

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--app

Especifique o nome do aplicativo.

--branch

Especifique o branch GitHub do qual implantar automaticamente.

--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--cluster-name

Especifique o nome do cluster do AKS.

--container-name

Especifique o nome da imagem do contêiner.

--destination

Especifique o caminho para o diretório do projeto (o padrão é .).

--gh-repo

Especifique o repositório GitHub (organização/repo_name).

--path

Baixe e use automaticamente o binário De rascunho no local especificado.

--provider

Especifique o provedor de nuvem (o padrão é o azure).

Propriedade Valor
Valor padrão: azure
--registry-name

Especifique o caminho para o diretório do projeto.

--resource-group

Especifique o nome do grupo de recursos Azure.

--subscription-id

Especifique a ID da assinatura Azure.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az aks draft update

Atualize seu aplicativo para ser acessível pela Internet.

Esse comando atualiza automaticamente seus arquivos yaml conforme necessário para que seu aplicativo possa receber solicitações externas.

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

Exemplos

Solicite a atualização do aplicativo para ser acessível pela Internet.

az aks draft update

Solicite a atualização do aplicativo para ser acessível à Internet em um diretório de projeto específico.

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

Atualize o aplicativo para ser acessível pela Internet com um host do recurso de entrada e um certificado Keyvault em um diretório de projeto específico.

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--certificate

Especifique o URI do certificado Keyvault a ser apresentado.

--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--destination

Especifique o caminho para o diretório do projeto (o padrão é .).

--host

Especifique o host do recurso de entrada.

--path

Baixe e use automaticamente o binário De rascunho no local especificado.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False