Partilhar via


az aks addon

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 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
                     [--acquire-policy-token]
                     [--change-reference]
                     [--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.

--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
--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
--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. monitorização - ativa a monitorização do Log Analytics. Usa o Log Analytics Default Workspace se existir, caso contrário cria 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 - Enable Azure policy. O add-on Azure Policy para AKS permite aplicações e salvaguardas em larga escala nos seus clusters de forma centralizada e consistente. Saiba mais em aka.ms/aks/policy. application-load-balancer - ativar o addon Application Balanceador de Carga (Application Gateway for Containers) (PREVIEW). ingress-appgw - ativar o addon Application Gateway Enter Controller. open-service-mesh - ative o addon Open Service Mesh (PREVIEW). gitops - ative o GitOps (PREVIEW). azure-keyvault-secrets-provider - enable 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
                    [--acquire-policy-token]
                    [--ampls-resource-id]
                    [--appgw-id]
                    [--appgw-name]
                    [--appgw-subnet-cidr]
                    [--appgw-subnet-id]
                    [--appgw-watch-namespace]
                    [--change-reference]
                    [--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.

--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
--ampls-resource-id
Pré-visualizar

ID de recurso de Azure Monitor Private Link âmbito para Monitorização 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
--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
--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. Auto-ativado quando --enable-container-network-logs é especificado.

Propriedade Valor
Valores aceites: false, true
--enable-msi-auth-for-monitoring
Pré-visualizar

Envie dados de monitorização para o Log Analytics usando a identidade atribuída ao cluster (em vez da chave partilhada do Log Analytics Workspace).

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
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 de recurso de um Log Analytics Workspace existente para usar no armazenamento de dados de monitorização.

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 [--acquire-policy-token]
                            [--change-reference]

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
--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
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
                    [--acquire-policy-token]
                    [--ampls-resource-id]
                    [--appgw-id]
                    [--appgw-name]
                    [--appgw-subnet-cidr]
                    [--appgw-subnet-id]
                    [--appgw-watch-namespace]
                    [--change-reference]
                    [--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.

--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
--ampls-resource-id
Pré-visualizar

ID de recurso de Azure Monitor Private Link âmbito para Monitorização 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
--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
--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. Auto-ativado quando --enable-container-network-logs é especificado.

Propriedade Valor
Valores aceites: false, true
--enable-msi-auth-for-monitoring
Pré-visualizar

Envie dados de monitorização para o Log Analytics usando a identidade atribuída ao cluster (em vez da chave partilhada do Log Analytics Workspace).

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
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 de recurso de um Log Analytics Workspace existente para usar no armazenamento de dados de monitorização.

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