az aks addon
Note
Essa referência faz parte da extensão aks-preview para a 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 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. |
Extension | GA |
| az aks addon enable |
Habilite um complemento do Kubernetes. |
Extension | GA |
| az aks addon list |
Liste o status de todos os complementos do Kubernetes em um determinado cluster. |
Extension | GA |
| az aks addon list-available |
Liste os complementos disponíveis do Kubernetes. |
Extension | GA |
| az aks addon show |
Mostrar o status e a configuração de um complemento do Kubernetes habilitado em um determinado cluster. |
Extension | GA |
| az aks addon update |
Atualize um complemento do Kubernetes já habilitado. |
Extension | 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
Desabilite o complemento "monitoramento".
az aks addon disable -g myResourceGroup -n myAKSCluster -a monitoring
Parâmetros Exigidos
Especifique o complemento do Kubernetes a ser desabilitado.
Nome do cluster gerenciado.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
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.
Não aguarde a conclusão da operação de execução prolongada.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
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 Aplicativos (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. (autogenerated)
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
Especifique o complemento do Kubernetes a ser habilitado.
Nome do cluster gerenciado.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
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.
ID do recurso do escopo do Link Privado do Azure Monitor para o Complemento de Monitoramento.
ID do recurso de um Gateway de Aplicativo existente a ser usado com o AGIC. Use com o complemento ingress-azure.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Application Gateway Arguments |
Nome do gateway de aplicativo a ser criado/usado no grupo de recursos do nó. Use com o complemento ingress-azure.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Application Gateway Arguments |
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.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Application Gateway Arguments |
ID do recurso de uma sub-rede existente usada para implantar o Gateway de Aplicativo. Use com o complemento ingress-azure.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Application Gateway Arguments |
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.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Application Gateway Arguments |
Caminho para o arquivo JSON que contém as configurações de coleta de dados para o complemento Monitoring.
Uma lista separada por vírgulas de IDs de recurso do recurso de zona DNS a ser usada com o complemento de Roteamento de Aplicativos.
Habilite o modo de alta escala de log para logs de contêiner.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
| Valores aceitos: | false, true |
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).
| Propriedade | Valor |
|---|---|
| Valor padrão: | True |
| Valores aceitos: | false, true |
Ative a rotação de segredos. Use com o complemento azure-keyvault-secrets-provider.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Habilite o auxiliar de cotação SGX para o complemento confcom.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Ative a coleta de dados de syslog para o complemento Monitoring.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
| Valores aceitos: | false, true |
Não aguarde a conclusão da operação de execução prolongada.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Defina o intervalo da pesquisa de rotação. Use com o complemento azure-keyvault-secrets-provider.
O nome da sub-rede para o nó virtual a ser usado.
O ID de recurso de um espaço de trabalho do Log Analytics existente para usar para dados de monitoramento armazenados.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
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
Nome do cluster gerenciado.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az aks addon list-available
Liste os complementos disponíveis do Kubernetes.
az aks addon list-available
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
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 a configuração do complemento "monitoramento".
az aks addon show -g myResourceGroup -n myAKSCluster -a monitoring
Parâmetros Exigidos
Especifique o complemento do Kubernetes.
Nome do cluster gerenciado.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
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. (autogenerated)
az aks addon update --addon virtual-node --name MyManagedCluster --resource-group MyResourceGroup --subnet-name VirtualNodeSubnet
Atualize o suplemento ingress-appgw com o prefixo de 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
Atualizar 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
Especifique o complemento do Kubernetes a ser atualizado.
Nome do cluster gerenciado.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
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.
ID do recurso do escopo do Link Privado do Azure Monitor para o Complemento de Monitoramento.
ID do recurso de um Gateway de Aplicativo existente a ser usado com o AGIC. Use com o complemento ingress-azure.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Application Gateway Arguments |
Nome do gateway de aplicativo a ser criado/usado no grupo de recursos do nó. Use com o complemento ingress-azure.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Application Gateway Arguments |
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.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Application Gateway Arguments |
ID do recurso de uma sub-rede existente usada para implantar o Gateway de Aplicativo. Use com o complemento ingress-azure.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Application Gateway Arguments |
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.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Application Gateway Arguments |
Caminho para o arquivo JSON que contém as configurações de coleta de dados para o complemento Monitoring.
Uma lista separada por vírgulas de IDs de recurso do recurso de zona DNS a ser usada com o complemento de Roteamento de Aplicativos.
Habilite o modo de alta escala de log para logs de contêiner.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
| Valores aceitos: | false, true |
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).
| Propriedade | Valor |
|---|---|
| Valores aceitos: | false, true |
Ative a rotação de segredos. Use com o complemento azure-keyvault-secrets-provider.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Habilite o auxiliar de cotação SGX para o complemento confcom.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Ative a coleta de dados de syslog para o complemento Monitoring.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
| Valores aceitos: | false, true |
Não aguarde a conclusão da operação de execução prolongada.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Defina o intervalo da pesquisa de rotação. Use com o complemento azure-keyvault-secrets-provider.
O nome da sub-rede para o nó virtual a ser usado.
O ID de recurso de um espaço de trabalho do Log Analytics existente para usar para dados de monitoramento armazenados.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |