az aks addon

Referência

Observação

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

Comandos para gerenciar e visualizar condições de complemento único.

Comandos

Nome	Description	Tipo	Status
az aks addon disable	Desabilite um complemento do Kubernetes habilitado em um cluster.	Extensão	GA
az aks addon enable	Habilite um complemento do Kubernetes.	Extensão	GA
az aks addon list	Liste o status de todos os complementos do Kubernetes em um determinado cluster.	Extensão	GA
az aks addon list-available	Liste os complementos disponíveis do Kubernetes.	Extensão	GA
az aks addon show	Mostrar o status e a configuração de um complemento do Kubernetes habilitado em um determinado cluster.	Extensão	GA
az aks addon update	Atualize um complemento do Kubernetes já habilitado.	Extensão	GA

az aks addon disable

Desabilite um complemento do Kubernetes habilitado em um cluster.

az aks addon disable --addon
                     --name
                     --resource-group
                     [--no-wait]

Exemplos

Desative o complemento "monitoramento".

az aks addon disable -g myResourceGroup -n myAKSCluster -a monitoring

Parâmetros Exigidos

--addon -a

Especifique o complemento do Kubernetes a ser desativado.

--name -n

Nome do cluster gerenciado.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--no-wait

Não aguarde a conclusão da operação de execução longa.

Valor padrão: False

Parâmetros Globais

--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az aks addon enable

Habilite um complemento do Kubernetes.

Esses complementos estão disponíveis: http_application_routing - configure a entrada com a criação automática de nomes DNS públicos. monitoramento – ative o monitoramento do Log Analytics. Usa o Espaço de Trabalho Padrão do Log Analytics se ele existir, caso contrário, cria um. Especifique "--workspace-resource-id" para usar um espaço de trabalho existente. Se o complemento de monitoramento estiver habilitado --no-wait argumento não terá efeito virtual-node - habilite o Nó Virtual do AKS. Requer que --subnet-name forneça o nome de uma sub-rede existente para o nó virtual usar. azure-policy – habilite o Azure Policy. O complemento Azure Policy para AKS permite imposições e proteções em escala em seus clusters de maneira centralizada e consistente. Saiba mais em aka.ms/aks/policy. ingress-appgw – habilite o complemento do Controlador de Entrada do Gateway de Aplicativo (VERSÃO PRÉVIA). open-service-mesh - habilita o complemento Open Service Mesh (VERSÃO PRÉVIA). gitops - habilita o GitOps (VERSÃO PRÉVIA). azure-keyvault-secrets-provider – habilite o complemento do Provedor de Segredos do Azure Keyvault. web_application_routing - habilite o complemento de roteamento de aplicativo Web (VERSÃO PRÉVIA). Especifique "--dns-zone-resource-id" para configurar o DNS.

az aks addon enable --addon
                    --name
                    --resource-group
                    [--ampls-resource-id]
                    [--appgw-id]
                    [--appgw-name]
                    [--appgw-subnet-cidr]
                    [--appgw-subnet-id]
                    [--appgw-watch-namespace]
                    [--data-collection-settings]
                    [--dns-zone-resource-ids]
                    [--enable-high-log-scale-mode {false, true}]
                    [--enable-msi-auth-for-monitoring {false, true}]
                    [--enable-secret-rotation]
                    [--enable-sgxquotehelper]
                    [--enable-syslog {false, true}]
                    [--no-wait]
                    [--rotation-poll-interval]
                    [--subnet-name]
                    [--workspace-resource-id]

Exemplos

Habilite um complemento do Kubernetes. (gerado automaticamente)

az aks addon enable --addon virtual-node --name MyManagedCluster --resource-group MyResourceGroup --subnet-name VirtualNodeSubnet

Habilite o complemento ingress-appgw com prefixo de sub-rede.

az aks addon enable --name MyManagedCluster --resource-group MyResourceGroup --addon ingress-appgw --appgw-subnet-cidr 10.2.0.0/16 --appgw-name gateway

Habilite o complemento open-service-mesh.

az aks addon enable --name MyManagedCluster --resource-group MyResourceGroup -a open-service-mesh

Parâmetros Exigidos

--addon -a

Especifique o complemento do Kubernetes a ser ativado.

--name -n

Nome do cluster gerenciado.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--ampls-resource-id

Versão Prévia

ID do recurso do escopo do Link Privado do Azure Monitor para o Complemento de Monitoramento.

--appgw-id

ID do recurso de um Gateway de Aplicativo existente a ser usado com o AGIC. Use com o complemento ingress-azure.

--appgw-name

Nome do gateway de aplicativo a ser criado/usado no grupo de recursos do nó. Use com o complemento ingress-azure.

--appgw-subnet-cidr

CIDR de sub-rede a ser usado para uma nova sub-rede criada para implantar o Gateway de Aplicativo. Use com o complemento ingress-azure.

--appgw-subnet-id

ID do recurso de uma sub-rede existente usada para implantar o Gateway de Aplicativo. Use com o complemento ingress-azure.

--appgw-watch-namespace

Especifique o namespace que o AGIC deve vigiar. Pode ser um único valor de cadeia de caracteres ou uma lista de namespaces separados por vírgula. Use com o complemento ingress-azure.

--data-collection-settings

Versão Prévia

Caminho para o arquivo JSON que contém as configurações de coleta de dados para o complemento Monitoring.

--dns-zone-resource-ids

Versão Prévia

Uma lista separada por vírgulas de IDs de recursos do recurso de zona DNS a ser usado com o complemento web_application_routing.

--enable-high-log-scale-mode

Versão Prévia

Habilite o modo de alta escala de log para logs de contêiner.

Valores aceitos: false, true

Valor padrão: False

--enable-msi-auth-for-monitoring

Versão Prévia

Envie dados de monitoramento para o Log Analytics usando a identidade atribuída do cluster (em vez da chave compartilhada do workspace do Log Analytics).

Valores aceitos: false, true

Valor padrão: True

--enable-secret-rotation

Ative a rotação de segredos. Use com o complemento azure-keyvault-secrets-provider.

Valor padrão: False

--enable-sgxquotehelper

Habilite o auxiliar de cotação SGX para o complemento confcom.

Valor padrão: False

--enable-syslog

Versão Prévia

Ative a coleta de dados de syslog para o complemento Monitoring.

Valores aceitos: false, true

Valor padrão: False

--no-wait

Não aguarde a conclusão da operação de execução longa.

Valor padrão: False

--rotation-poll-interval

Defina o intervalo da pesquisa de rotação. Use com o complemento azure-keyvault-secrets-provider.

--subnet-name -s

O nome da sub-rede para o nó virtual a ser usado.

--workspace-resource-id

O ID de recurso de um espaço de trabalho do Log Analytics existente para usar para dados de monitoramento armazenados.

Parâmetros Globais

--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az aks addon list

Liste o status de todos os complementos do Kubernetes em um determinado cluster.

az aks addon list --name
                  --resource-group

Parâmetros Exigidos

--name -n

Nome do cluster gerenciado.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais

--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az aks addon list-available

Liste os complementos disponíveis do Kubernetes.

az aks addon list-available

Parâmetros Globais

--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az aks addon show

Mostrar o status e a configuração de um complemento do Kubernetes habilitado em um determinado cluster.

az aks addon show --addon
                  --name
                  --resource-group

Exemplos

Mostrar configuração para o complemento "monitoramento".

az aks addon show -g myResourceGroup -n myAKSCluster -a monitoring

Parâmetros Exigidos

--addon -a

Especifique o complemento do Kubernetes.

--name -n

Nome do cluster gerenciado.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais

--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az aks addon update

Atualize um complemento do Kubernetes já habilitado.

az aks addon update --addon
                    --name
                    --resource-group
                    [--ampls-resource-id]
                    [--appgw-id]
                    [--appgw-name]
                    [--appgw-subnet-cidr]
                    [--appgw-subnet-id]
                    [--appgw-watch-namespace]
                    [--data-collection-settings]
                    [--dns-zone-resource-ids]
                    [--enable-high-log-scale-mode {false, true}]
                    [--enable-msi-auth-for-monitoring {false, true}]
                    [--enable-secret-rotation]
                    [--enable-sgxquotehelper]
                    [--enable-syslog {false, true}]
                    [--no-wait]
                    [--rotation-poll-interval]
                    [--subnet-name]
                    [--workspace-resource-id]

Exemplos

Atualize um complemento do Kubernetes. (gerado automaticamente)

az aks addon update --addon virtual-node --name MyManagedCluster --resource-group MyResourceGroup --subnet-name VirtualNodeSubnet

Atualize o complemento ingress-appgw com o prefixo da sub-rede.

az aks addon update --name MyManagedCluster --resource-group MyResourceGroup --addon ingress-appgw --appgw-subnet-cidr 10.2.0.0/16 --appgw-name gateway

Atualize o complemento de monitoramento com a ID do recurso do workspace.

az aks addon update -g $rg -n $cn -a monitoring --workspace-resource-id=/subscriptions/0000000-00000000-00000-000-000/resourcegroups/myresourcegroup/providers/microsoft.operationalinsights/workspaces/defaultlaworkspace

Parâmetros Exigidos

--addon -a

Especifique o complemento do Kubernetes a ser atualizado.

--name -n

Nome do cluster gerenciado.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--ampls-resource-id

Versão Prévia

ID do recurso do escopo do Link Privado do Azure Monitor para o Complemento de Monitoramento.

--appgw-id

ID do recurso de um Gateway de Aplicativo existente a ser usado com o AGIC. Use com o complemento ingress-azure.

--appgw-name

Nome do gateway de aplicativo a ser criado/usado no grupo de recursos do nó. Use com o complemento ingress-azure.

--appgw-subnet-cidr

CIDR de sub-rede a ser usado para uma nova sub-rede criada para implantar o Gateway de Aplicativo. Use com o complemento ingress-azure.

--appgw-subnet-id

ID do recurso de uma sub-rede existente usada para implantar o Gateway de Aplicativo. Use com o complemento ingress-azure.

--appgw-watch-namespace

Especifique o namespace que o AGIC deve vigiar. Pode ser um único valor de cadeia de caracteres ou uma lista de namespaces separados por vírgula. Use com o complemento ingress-azure.

--data-collection-settings

Versão Prévia

Caminho para o arquivo JSON que contém as configurações de coleta de dados para o complemento Monitoring.

--dns-zone-resource-ids

Versão Prévia

Uma lista separada por vírgulas de IDs de recursos do recurso de zona DNS a ser usado com o complemento web_application_routing.

--enable-high-log-scale-mode

Versão Prévia

Habilite o modo de alta escala de log para logs de contêiner.

Valores aceitos: false, true

Valor padrão: False

--enable-msi-auth-for-monitoring

Versão Prévia

Envie dados de monitoramento para o Log Analytics usando a identidade atribuída do cluster (em vez da chave compartilhada do workspace do Log Analytics).

Valores aceitos: false, true

--enable-secret-rotation

Ative a rotação de segredos. Use com o complemento azure-keyvault-secrets-provider.

Valor padrão: False

--enable-sgxquotehelper

Habilite o auxiliar de cotação SGX para o complemento confcom.

Valor padrão: False

--enable-syslog

Versão Prévia

Ative a coleta de dados de syslog para o complemento Monitoring.

Valores aceitos: false, true

Valor padrão: False

--no-wait

Não aguarde a conclusão da operação de execução longa.

Valor padrão: False

--rotation-poll-interval

Defina o intervalo da pesquisa de rotação. Use com o complemento azure-keyvault-secrets-provider.

--subnet-name -s

O nome da sub-rede para o nó virtual a ser usado.

--workspace-resource-id

O ID de recurso de um espaço de trabalho do Log Analytics existente para usar para dados de monitoramento armazenados.

Parâmetros Globais

--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

Compartilhar via

az aks addon

Comandos

az aks addon disable

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az aks addon enable

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az aks addon list

Parâmetros Exigidos

az aks addon list-available

az aks addon show

Exemplos

Parâmetros Exigidos

az aks addon update

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

Recursos adicionais