Compartilhar via


az aks addon

Note

Essa referência faz parte da extensão aks-preview para o 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
                     [--acquire-policy-token]
                     [--change-reference]
                     [--no-wait]

Exemplos

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

--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 se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--no-wait

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

Propriedade Valor
Valor padrão: False
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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 Log Analytics monitoramento. Usa o Log Analytics Workspace Padrão 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- habilitar a política de Azure. O complemento Azure Policy para AKS permite imposição e proteções em escala em seus clusters de maneira centralizada e consistente. Saiba mais em aka.ms/aks/policy. application-load-balancer – habilite o suplemento application Load Balancer (Gateway de Aplicativo para Contêineres) (PREVIEW). ingress-appgw – habilitar o complemento controlador de entrada do Gateway de Aplicativo. 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 Azure complemento do Provedor de Segredos do 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
                    [--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 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

--addon -a

Especifique o complemento 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 se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--ampls-resource-id
Versão Prévia

ID do recurso do escopo Azure Monitor Link Privado 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.

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 o complemento ingress-azure.

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 Gateway de Aplicativo. Use com o complemento ingress-azure.

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

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

Propriedade Valor
Grupo de parâmetros: Application Gateway Arguments
--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--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 recurso do recurso de zona DNS a ser usada com o complemento de Roteamento de Aplicativos.

--enable-high-log-scale-mode
Versão Prévia

Habilite o modo de alta escala de log para logs de contêiner. Habilitado automaticamente quando --enable-container-network-logs é especificado.

Propriedade Valor
Valores aceitos: false, true
--enable-msi-auth-for-monitoring
Versão Prévia

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

Propriedade Valor
Valor padrão: True
Valores aceitos: false, true
--enable-secret-rotation

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

Propriedade Valor
Valor padrão: False
--enable-sgxquotehelper

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

Propriedade Valor
Valor padrão: False
--enable-syslog
Versão Prévia

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

Propriedade Valor
Valores aceitos: false, true
--no-wait

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

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

A ID de recurso de um workspace Log Analytics existente a ser usado para armazenar dados de monitoramento.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

--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 a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

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.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

--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 a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

--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 se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--ampls-resource-id
Versão Prévia

ID do recurso do escopo Azure Monitor Link Privado 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.

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 o complemento ingress-azure.

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 Gateway de Aplicativo. Use com o complemento ingress-azure.

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

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

Propriedade Valor
Grupo de parâmetros: Application Gateway Arguments
--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--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 recurso do recurso de zona DNS a ser usada com o complemento de Roteamento de Aplicativos.

--enable-high-log-scale-mode
Versão Prévia

Habilite o modo de alta escala de log para logs de contêiner. Habilitado automaticamente quando --enable-container-network-logs é especificado.

Propriedade Valor
Valores aceitos: false, true
--enable-msi-auth-for-monitoring
Versão Prévia

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

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

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

Propriedade Valor
Valor padrão: False
--enable-sgxquotehelper

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

Propriedade Valor
Valor padrão: False
--enable-syslog
Versão Prévia

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

Propriedade Valor
Valores aceitos: false, true
--no-wait

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

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

A ID de recurso de um workspace Log Analytics existente a ser usado para armazenar dados de monitoramento.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False