Partilhar via


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 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.

Extension disponibilidade geral
az aks addon enable

Habilite um addon do Kubernetes.

Extension disponibilidade geral
az aks addon list

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

Extension disponibilidade geral
az aks addon list-available

Liste os addons disponíveis do Kubernetes.

Extension disponibilidade geral
az aks addon show

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

Extension disponibilidade geral
az aks addon update

Atualize um addon do Kubernetes já habilitado.

Extension disponibilidade geral

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

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

--no-wait

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

Propriedade Valor
Default value: False
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 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 - ative o complemento de roteamento de aplicativos (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. (autogenerated)

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

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

--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.

Propriedade Valor
Grupo de parâmetros: Application Gateway Arguments
--appgw-name

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

Propriedade Valor
Grupo de parâmetros: Application Gateway Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Application Gateway Arguments
--appgw-subnet-id

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

Propriedade Valor
Grupo de parâmetros: Application Gateway Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Application Gateway Arguments
--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 complemento de Roteamento de Aplicativos.

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

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

Propriedade Valor
Default value: False
Valores aceites: false, true
--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).

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

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

Propriedade Valor
Default value: False
--enable-sgxquotehelper

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

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

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

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

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

Propriedade Valor
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.

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 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

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.

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 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.

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 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

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.

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 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. (autogenerated)

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

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

--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.

Propriedade Valor
Grupo de parâmetros: Application Gateway Arguments
--appgw-name

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

Propriedade Valor
Grupo de parâmetros: Application Gateway Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Application Gateway Arguments
--appgw-subnet-id

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

Propriedade Valor
Grupo de parâmetros: Application Gateway Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Application Gateway Arguments
--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 complemento de Roteamento de Aplicativos.

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

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

Propriedade Valor
Default value: False
Valores aceites: false, true
--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).

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

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

Propriedade Valor
Default value: False
--enable-sgxquotehelper

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

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

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

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

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

Propriedade Valor
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.

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