Partilhar via

az aks draft

Note

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

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

Comandos

Name Description Tipo Status
az aks draft create

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

 Extension disponibilidade geral
az aks draft generate-workflow

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

 Extension disponibilidade geral
az aks draft setup-gh

Configura o GitHub OIDC para a tua aplicação.

 Extension disponibilidade geral
az aks draft up

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

 Extension disponibilidade geral
az aks draft update

Atualize seu aplicativo para ser acessível pela Internet.

 Extension disponibilidade geral

az aks draft create

Gere um Dockerfile e os arquivos de implantação do Kubernetes mínimos necessários (helm, kustomize, manifests) 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

Prompt para gerar 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

Gera um Dockerfile e um ficheiro de deployment num projeto Java com um nome de aplicação num diretório específico do projeto.

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 tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

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

Especifique o nome da liberação do leme.

--change-reference

O ID de referência de alteração relacionado 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 somente arquivos de implantação (helm, kustomize, manifests) para a implantação do Kubernetes.

--destination

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

Propriedade Valor
Default value: .
--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

Transfira e utilize automaticamente o binário de rascunho na localização especificada.

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az aks draft generate-workflow

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

Antes de executar este comando, certifique-se de que configurou o GitHub OIDC para a sua aplicação. Também precisa de criar um grupo de recursos, um registo de contentores e um cluster Kubernetes no Azure e ligar 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

Pedido para gerar um fluxo de trabalho do GitHub no diretório atual.

az aks draft generate-workflow

Prompt para gerar um fluxo de trabalho do GitHub num diretório de projeto específico.

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

Gera um fluxo de trabalho no GitHub com um grupo de recursos, um nome de cluster AKS, um nome de registo de contentores num diretório específico de projeto.

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

Gera um fluxo de trabalho GitHub que seja implementado a partir do ramo principal com um grupo de recursos, um nome de cluster AKS, um nome de registo de contentor e um nome de imagem de contentor num diretório específico do projeto.

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 tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

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

Especifique a ramificação do GitHub a partir da qual se deve implementar automaticamente.

--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

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

Especifique o nome do cluster 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

Transfira e utilize automaticamente o binário de rascunho na localização especificada.

--registry-name

Especifique o caminho para o diretório do projeto.

--resource-group

Especifique o nome do grupo de recursos Azure.

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az aks draft setup-gh

Configura o GitHub OIDC para a tua aplicação.

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

Exemplos

Prompt para configurar o OIDC do GitHub para um repositório.

az aks draft setup-gh

Configura o OIDC do GitHub no Azure para um repositório específico.

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

Configura o OIDC do GitHub no Azure com ID de subscrição e grupo de recursos.

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

Configura o OIDC do GitHub com um nome de aplicação no Azure com ID de subscrição 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 tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

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

Especifique o nome do aplicador Azure Active Directory.

--change-reference

O ID de referência de alteração relacionado 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

Transfira e utilize automaticamente o binário de rascunho na localização especificada.

--provider

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

Propriedade Valor
Default value: azure
--resource-group

Especifique o nome do grupo de recursos Azure.

--subscription-id

Especifique o ID de subscrição do Azure.

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az aks draft up

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

Este 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 automática e implementação no AKS. Antes de executar este comando, crie um grupo de recursos, um registo de contentores e um cluster Kubernetes em Azure e ligue 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 para configurar o OIDC do GitHub e depois gerar um fluxo de trabalho do GitHub no diretório atual.

az aks draft up

Solicite para configurar o OIDC do GitHub e depois gerar um fluxo de trabalho do GitHub num diretório específico do projeto.

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

Peça para configurar o OIDC do GitHub para um repositório específico e depois gerar um fluxo de trabalho do GitHub num 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 tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

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

Especifique o nome do aplicativo.

--branch

Especifique a ramificação do GitHub a partir da qual se deve implementar automaticamente.

--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

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

Especifique o nome do cluster 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

Transfira e utilize automaticamente o binário de rascunho na localização especificada.

--provider

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

Propriedade Valor
Default value: 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 o ID de subscrição do Azure.

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az aks draft update

Atualize seu aplicativo para ser acessível pela Internet.

Este comando atualiza automaticamente seus arquivos yaml conforme necessário para que seu aplicativo seja capaz de receber solicitações externas.

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

Exemplos

Prompt para atualizar o aplicativo para ser acessível pela Internet.

az aks draft update

Prompt para atualizar o aplicativo para ser acessível pela 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 tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta 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

O ID de referência de alteração relacionado 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

Transfira e utilize automaticamente o binário de rascunho na localização especificada.

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False