Partilhar via


az aks addon

Nota

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 addon az aks. Saiba mais sobre extensões.

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

Comandos

Name Description Tipo Status
az aks addon disable

Desative um addon do Kubernetes ativado em um cluster.

Extensão GA
az aks addon enable

Habilite um addon do Kubernetes.

Extensão GA
az aks addon list

Listar o status de todos os addons do Kubernetes em determinado cluster.

Extensão GA
az aks addon list-available

Liste os addons disponíveis do Kubernetes.

Extensão GA
az aks addon show

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

Extensão GA
az aks addon update

Atualize um addon do Kubernetes já habilitado.

Extensão GA

az aks addon disable

Desative um addon do Kubernetes ativado em um cluster.

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

Exemplos

Desative o addon de "monitoramento".

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

Parâmetros Obrigatórios

--addon -a

Especifique o complemento do Kubernetes para desabilitar.

--name -n

Nome do cluster gerenciado.

--resource-group -g

o 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 espere que a operação de longa duração termine.

Default value: False
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az aks addon enable

Habilite um addon do Kubernetes.

Estes addons 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 existir, caso contrário, criará um. Especifique "--workspace-resource-id" para usar um espaço de trabalho existente. Se o addon de monitoramento estiver habilitado --no-wait argument will have no effect virtual-node - enable AKS Virtual Node. Requer --subnet-name para fornecer o nome de uma sub-rede existente para o Nó Virtual usar. azure-policy - habilite a política do Azure. O complemento Política do Azure 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 addon Application Gateway Ingress Controller (PREVIEW). open-service-mesh - ative o addon Open Service Mesh (PREVIEW). gitops - ative o GitOps (PREVIEW). azure-keyvault-secrets-provider - habilite o Azure Keyvault Secrets Provider addon. web_application_routing - habilite o complemento de roteamento de aplicativos Web (PREVIEW). 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 addon do Kubernetes. (gerado automaticamente)

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

Habilite o addon ingress-appgw com o prefixo da 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 addon open-service-mesh.

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

Parâmetros Obrigatórios

--addon -a

Especifique o addon do Kubernetes a ser habilitado.

--name -n

Nome do cluster gerenciado.

--resource-group -g

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

Parâmetros Opcionais

--ampls-resource-id
Pré-visualizar

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

--appgw-id

ID de recurso de um Application Gateway existente para usar com o AGIC. Use com ingress-azure addon.

--appgw-name

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

--appgw-subnet-cidr

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

--appgw-subnet-id

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

--appgw-watch-namespace

Especifique o namespace, que AGIC deve observar. Isso pode ser um único valor de cadeia de caracteres ou uma lista de namespaces separados por vírgula. Use com ingress-azure addon.

--data-collection-settings
Pré-visualizar

Caminho para o arquivo JSON contendo configurações de coleta de dados para o Addon de monitoramento.

--dns-zone-resource-ids
Pré-visualizar

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

--enable-high-log-scale-mode
Pré-visualizar

Habilite o Modo de Alta Escala de Log para logs de contêiner.

Valores aceites: false, true
Default value: False
--enable-msi-auth-for-monitoring
Pré-visualizar

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

Valores aceites: false, true
Default value: True
--enable-secret-rotation

Habilite a rotação secreta. Use com azure-keyvault-secrets-provider addon.

Default value: False
--enable-sgxquotehelper

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

Default value: False
--enable-syslog
Pré-visualizar

Habilite a coleta de dados syslog para o addon de monitoramento.

Valores aceites: false, true
Default value: False
--no-wait

Não espere que a operação de longa duração termine.

Default value: False
--rotation-poll-interval

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

--subnet-name -s

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

--workspace-resource-id

O ID do recurso de um espaço de trabalho existente do Log Analytics a ser usado para armazenar dados de monitoramento.

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az aks addon list

Listar o status de todos os addons do Kubernetes em determinado cluster.

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

Parâmetros Obrigatórios

--name -n

Nome do cluster gerenciado.

--resource-group -g

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az aks addon list-available

Liste os addons disponíveis do Kubernetes.

az aks addon list-available
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az aks addon show

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

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

Exemplos

Mostrar configuração para "monitoramento" addon.

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

Parâmetros Obrigatórios

--addon -a

Especifique o addon do Kubernetes.

--name -n

Nome do cluster gerenciado.

--resource-group -g

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az aks addon update

Atualize um addon 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 addon do Kubernetes. (gerado automaticamente)

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

Atualize o addon 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

Complemento de monitoramento de atualização com ID de recurso do espaço de trabalho.

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 Obrigatórios

--addon -a

Especifique o complemento do Kubernetes a ser atualizado.

--name -n

Nome do cluster gerenciado.

--resource-group -g

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

Parâmetros Opcionais

--ampls-resource-id
Pré-visualizar

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

--appgw-id

ID de recurso de um Application Gateway existente para usar com o AGIC. Use com ingress-azure addon.

--appgw-name

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

--appgw-subnet-cidr

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

--appgw-subnet-id

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

--appgw-watch-namespace

Especifique o namespace, que AGIC deve observar. Isso pode ser um único valor de cadeia de caracteres ou uma lista de namespaces separados por vírgula. Use com ingress-azure addon.

--data-collection-settings
Pré-visualizar

Caminho para o arquivo JSON contendo configurações de coleta de dados para o Addon de monitoramento.

--dns-zone-resource-ids
Pré-visualizar

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

--enable-high-log-scale-mode
Pré-visualizar

Habilite o Modo de Alta Escala de Log para logs de contêiner.

Valores aceites: false, true
Default value: False
--enable-msi-auth-for-monitoring
Pré-visualizar

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

Valores aceites: false, true
--enable-secret-rotation

Habilite a rotação secreta. Use com azure-keyvault-secrets-provider addon.

Default value: False
--enable-sgxquotehelper

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

Default value: False
--enable-syslog
Pré-visualizar

Habilite a coleta de dados syslog para o addon de monitoramento.

Valores aceites: false, true
Default value: False
--no-wait

Não espere que a operação de longa duração termine.

Default value: False
--rotation-poll-interval

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

--subnet-name -s

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

--workspace-resource-id

O ID do recurso de um espaço de trabalho existente do Log Analytics a ser usado para armazenar dados de monitoramento.

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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