az aks addon

Referência

Observação

Essa referência faz parte da extensão aks-preview para a CLI do Azure (versão 2.56.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az aks addon . Saiba mais sobre extensões.

Comandos para gerenciar e exibir condições de complemento único.

Comandos

Nome	Description	Tipo	Status
az aks addon disable	Desative um complemento do Kubernetes habilitado em um cluster.	Extensão	GA
az aks addon enable	Habilite um complemento do Kubernetes.	Extensão	GA
az aks addon list	Listar o status de todos os complementos do Kubernetes em determinado cluster.	Extensão	GA
az aks addon list-available	Lista de addons Kubernetes disponíveis.	Extensão	GA
az aks addon show	Mostrar o status e a configuração de um complemento do Kubernetes habilitado em um determinado cluster.	Extensão	GA
az aks addon update	Atualize um addon Kubernetes já habilitado.	Extensão	GA

az aks addon disable

Desative um complemento do Kubernetes habilitado em um cluster.

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

Exemplos

Desative o addon "monitoramento".

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

Parâmetros Exigidos

--addon -a

Especifique o complemento 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

--no-wait

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

valor padrão: False

Parâmetros Globais

--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc

valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az aks addon enable

Habilite um complemento do Kubernetes.

Estes addons estão disponíveis: http_application_routing - configurar 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, criará um. Especifique "--workspace-resource-id" para usar um espaço de trabalho existente. Se o addon de monitoramento estiver habilitado --no-wait argumento não terá efeito virtual-node - habilite AKS Virtual Node. Requer --subnet-name para fornecer o nome de uma sub-rede existente para o nó virtual usar. azure-policy - habilitar 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 complemento Application Gateway Ingress Controller (PREVIEW). open-service-mesh - ative o complemento Open Service Mesh (PREVIEW). gitops - ative o GitOps (PREVIEW). azure-keyvault-secrets-provider - habilite o addon do Provedor de Segredos do Azure Keyvault. web_application_routing - habilitar o complemento Web Application Routing (PREVIEW). Especifique "--dns-zone-resource-id" para configurar o DNS.

az aks addon enable --addon
                    --name
                    --resource-group
                    [--appgw-id]
                    [--appgw-name]
                    [--appgw-subnet-cidr]
                    [--appgw-subnet-id]
                    [--appgw-watch-namespace]
                    [--data-collection-settings]
                    [--dns-zone-resource-ids]
                    [--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. (gerado automaticamente)

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 addon open-service-mesh.

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

Parâmetros Exigidos

--addon -a

Especifique o complemento Kubernetes para habilitar.

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

--appgw-id

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

--appgw-name

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

--appgw-subnet-cidr

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

--appgw-subnet-id

ID de recurso de uma sub-rede existente usada para implantar o gateway de aplicativo. Use com addon ingress-azure.

--appgw-watch-namespace

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

--data-collection-settings

Versão Prévia

Caminho para o arquivo JSON que contém as configurações de coleta de dados para o Addon de monitoramento.

--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 usado com o complemento web_application_routing.

--enable-msi-auth-for-monitoring

Versão Prévia

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

valores aceitos: false, true

valor padrão: True

--enable-secret-rotation

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

valor padrão: False

--enable-sgxquotehelper

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

valor padrão: False

--enable-syslog

Versão Prévia

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

valores aceitos: false, true

valor padrão: False

--no-wait

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

valor padrão: False

--rotation-poll-interval

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

--subnet-name -s

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

--workspace-resource-id

O ID de recurso de um espaço de trabalho do Log Analytics existente para usar para dados de monitoramento armazenados.

Parâmetros Globais

--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc

valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az aks addon list

Listar o status de todos os complementos do Kubernetes em 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 o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc

valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az aks addon list-available

Lista de addons Kubernetes disponíveis.

az aks addon list-available

Parâmetros Globais

--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc

valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

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 configuração para "monitoramento" addon.

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

Parâmetros Exigidos

--addon -a

Especifique o complemento 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 o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc

valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az aks addon update

Atualize um addon Kubernetes já habilitado.

az aks addon update --addon
                    --name
                    --resource-group
                    [--appgw-id]
                    [--appgw-name]
                    [--appgw-subnet-cidr]
                    [--appgw-subnet-id]
                    [--appgw-watch-namespace]
                    [--data-collection-settings]
                    [--dns-zone-resource-ids]
                    [--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. (gerado automaticamente)

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

Atualize o complemento ingress-appgw com 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

Atualize o complemento de monitoramento com a ID do 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 Exigidos

--addon -a

Especifique o complemento 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

--appgw-id

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

--appgw-name

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

--appgw-subnet-cidr

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

--appgw-subnet-id

ID de recurso de uma sub-rede existente usada para implantar o gateway de aplicativo. Use com addon ingress-azure.

--appgw-watch-namespace

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

--data-collection-settings

Versão Prévia

Caminho para o arquivo JSON que contém as configurações de coleta de dados para o Addon de monitoramento.

--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 usado com o complemento web_application_routing.

--enable-msi-auth-for-monitoring

Versão Prévia

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

valores aceitos: false, true

--enable-secret-rotation

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

valor padrão: False

--enable-sgxquotehelper

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

valor padrão: False

--enable-syslog

Versão Prévia

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

valores aceitos: false, true

valor padrão: False

--no-wait

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

valor padrão: False

--rotation-poll-interval

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

--subnet-name -s

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

--workspace-resource-id

O ID de recurso de um espaço de trabalho do Log Analytics existente para usar para dados de monitoramento armazenados.

Parâmetros Globais

--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc

valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

Compartilhar via

az aks addon

Comandos

az aks addon disable

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az aks addon enable

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az aks addon list

Parâmetros Exigidos

az aks addon list-available

az aks addon show

Exemplos

Parâmetros Exigidos

az aks addon update

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

Comentários

Recursos adicionais