Partilhar via

az aks extension

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 az aks extension . Saiba mais sobre extensões.

Comandos para gerenciar extensões no cluster do Kubernetes.

Comandos

Nome Descrição Tipo Estado
az aks extension create

Cria a instância de extensão de cluster no cluster gerenciado. Consulte o exemplo no final para ver como criar uma extensão de cluster.

 Extension disponibilidade geral
az aks extension delete

Exclua uma extensão de cluster.

 Extension disponibilidade geral
az aks extension list

Listar extensões de cluster.

 Extension disponibilidade geral
az aks extension show

Mostrar uma extensão de cluster.

 Extension disponibilidade geral
az aks extension type

Gerencie tipos de extensão no Serviço Kubernetes do Azure.

 Extension disponibilidade geral
az aks extension type list

Liste os tipos de extensão de cluster disponíveis. As propriedades usadas para filtragem incluem versão do kubernetes, local do cluster.

 Extension disponibilidade geral
az aks extension type show

Mostrar propriedades de um Tipo de Extensão de Cluster. As propriedades usadas para filtragem incluem versão do kubernetes, local do cluster.

 Extension disponibilidade geral
az aks extension type version

Gerenciar a versão dos tipos de extensão no Serviço Kubernetes do Azure.

 Extension disponibilidade geral
az aks extension type version list

Liste as versões disponíveis do Tipo de Extensão de Cluster. As propriedades usadas para filtragem incluem versão do kubernetes, local do cluster.

 Extension disponibilidade geral
az aks extension type version show

Mostrar propriedades associadas a uma versão do Tipo de Extensão de Cluster. As propriedades usadas para filtragem incluem versão do kubernetes, local do cluster.

 Extension disponibilidade geral
az aks extension update

Atualize as propriedades mutáveis de uma Extensão de Cluster.

 Extension disponibilidade geral

az aks extension create

Cria a instância de extensão de cluster no cluster gerenciado. Consulte o exemplo no final para ver como criar uma extensão de cluster.

Crie uma extensão de cluster. A saída inclui segredos que você deve proteger. Certifique-se de não incluir esses segredos no controle do código-fonte. Verifique também se nenhum segredo está presente nos logs do seu comando ou script. Para obter informações adicionais, consulte http://aka.ms/clisecrets.

az aks extension create --cluster-name
                        --extension-type
                        --name
                        --resource-group
                        [--config --configuration-settings]
                        [--config-file --config-settings-file]
                        [--config-protected --config-protected-settings]
                        [--config-protected-file --config-protected-settings-file]
                        [--no-wait]
                        [--release-namespace]
                        [--scope {cluster, namespace}]
                        [--target-namespace]

Exemplos

Instalar a extensão Cluster no cluster AKS com os parâmetros necessários

az aks extension create --resource-group my-resource-group --cluster-name mycluster --name myextension --extension-type microsoft.flux

Instalar extensão de cluster com definições de configuração de parâmetros opcionais

az aks extension create --resource-group abc --cluster-name test --name flux --extension-type microsoft.flux --config useKubeletIdentity=true

Parâmetros Obrigatórios

--cluster-name -c

Nome do cluster AKS.

--extension-type -t

Nome do tipo de extensão.

--name -n

Nome da instância de extensão.

--resource-group -g

Nome do grupo de recursos.

Parâmetros Opcionais

Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.

--config --configuration-settings

Definições de configuração como par chave=valor.

Definições de configuração como par chave=valor. Repita o parâmetro para cada configuração. Não use isso para segredos, pois esse valor é retornado em resposta. Se não for especificado, o valor padrão será Nenhum.

Propriedade Valor
Grupo de parâmetros: Configuration Arguments
--config-file --config-settings-file

Caminho do arquivo JSON para definições de configuração.

Caminho do arquivo JSON para definições de configuração. Se não for especificado, o valor padrão será Nenhum.

Propriedade Valor
Grupo de parâmetros: Configuration Arguments
--config-protected --config-protected-settings

Configurações protegidas como par chave=valor.

Definições de configuração como par chave=valor. Repita o parâmetro para cada configuração. Somente a chave é retornada em resposta, o valor não é. Se não for especificado, o valor padrão será Nenhum.

Propriedade Valor
Grupo de parâmetros: Configuration Arguments
--config-protected-file --config-protected-settings-file

Caminho do arquivo JSON para configurações protegidas.

Caminho do arquivo JSON para configurações protegidas. Se não for especificado, o valor padrão será Nenhum.

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

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

Propriedade Valor
Valor padrão: False
--release-namespace

Especifique o namespace para instalar a versão da extensão.

--scope

Especifique o escopo do tipo de extensão, inclua namespace ou cluster como escopo.

Especifique o escopo do tipo de extensão, aceita namespace ou cluster como o escopo Se não for especificado, o escopo padrão definido no registro do tipo de extensão será usado.

Propriedade Valor
Valores aceites: cluster, namespace
--target-namespace

Especifique o namespace de destino no qual instalar para a instância de extensão. Este parâmetro é necessário se o escopo da extensão estiver definido como 'namespace'.

Parâmetros globais
--debug

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

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

Mostrar esta mensagem de ajuda e sair.

--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 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
Valor padrão: False

az aks extension delete

Exclua uma extensão de cluster.

az aks extension delete --cluster-name
                        --name
                        --resource-group
                        [--force]
                        [--no-wait]
                        [--yes]

Exemplos

Excluir uma extensão de cluster existente no cluster AKS

az aks extension delete --resource-group resource-group --cluster-name cluster --name ext

Excluir uma extensão de cluster existente no cluster AKS com parâmetros opcionais

az aks extension delete --resource-group resource-group --cluster-name cluster --name ext --yes --force

Parâmetros Obrigatórios

--cluster-name -c

Nome do cluster AKS.

--name -n

Nome da instância de extensão.

--resource-group -g

Nome do grupo de recursos.

Parâmetros Opcionais

Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.

--force

Especifique se a exclusão da extensão do cluster deve ser forçada.

Especifique se deseja forçar a exclusão da extensão do cluster Se não for especificado, o valor padrão será false.

Propriedade Valor
Valor padrão: False
--no-wait

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

Propriedade Valor
Valor padrão: False
--yes -y

Ignora o prompt de confirmação.

Ignora o prompt de confirmação. Se não for especificado, o valor padrão será false.

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

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

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

Mostrar esta mensagem de ajuda e sair.

--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 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
Valor padrão: False

az aks extension list

Listar extensões de cluster.

Liste todas as Extensões de Cluster em um cluster, incluindo suas propriedades. A saída inclui segredos que você deve proteger. Certifique-se de não incluir esses segredos no controle do código-fonte. Verifique também se nenhum segredo está presente nos logs do seu comando ou script. Para obter informações adicionais, consulte http://aka.ms/clisecrets.

az aks extension list --cluster-name
                      --resource-group

Exemplos

Listar todas as extensões de cluster em um cluster

az aks extension list --resource-group <group> --cluster-name <name>

Parâmetros Obrigatórios

--cluster-name -c

Nome do cluster AKS.

--resource-group -g

Nome do grupo de recursos.

Parâmetros globais
--debug

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

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

Mostrar esta mensagem de ajuda e sair.

--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 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
Valor padrão: False

az aks extension show

Mostrar uma extensão de cluster.

Mostrar uma Extensão de Cluster incluindo suas propriedades. A saída inclui segredos que você deve proteger. Certifique-se de não incluir esses segredos no controle do código-fonte. Verifique também se nenhum segredo está presente nos logs do seu comando ou script. Para obter informações adicionais, consulte http://aka.ms/clisecrets.

az aks extension show --cluster-name
                      --name
                      --resource-group

Exemplos

Mostrar detalhes de uma extensão de cluster

az aks extension show --resource-group my-resource-group --cluster-name mycluster --name myextension

Parâmetros Obrigatórios

--cluster-name -c

Nome do cluster AKS.

--name -n

Nome da instância de extensão.

--resource-group -g

Nome do grupo de recursos.

Parâmetros globais
--debug

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

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

Mostrar esta mensagem de ajuda e sair.

--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 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
Valor padrão: False

az aks extension update

Atualize as propriedades mutáveis de uma Extensão de Cluster.

Para atualizar ConfigSettings e ConfigProtectedSettings, consulte a documentação do serviço de extensão de cluster para verificar se há suporte para a atualização dessas propriedades antes de atualizá-las. A saída inclui segredos que você deve proteger. Certifique-se de não incluir esses segredos no controle do código-fonte. Verifique também se nenhum segredo está presente nos logs do seu comando ou script. Para obter informações adicionais, consulte http://aka.ms/clisecrets.

az aks extension update --cluster-name
                        --name
                        --resource-group
                        [--config --configuration-settings]
                        [--config-file --config-settings-file]
                        [--config-protected --config-protected-settings]
                        [--config-protected-file --config-protected-settings-file]
                        [--no-wait]
                        [--yes]

Exemplos

Atualizar extensão de cluster no cluster AKS

az aks extension update --resource-group my-resource-group --cluster-name mycluster --name myextension

Atualizar extensão de cluster no cluster AKS com parâmetros opcionais incluídos

az aks extension update --resource-group my-resource-group --cluster-name mycluster --name myextension --configuration-settings settings-key=settings-value --config-protected-settings protected-settings-key=protected-value --config-settings-file=config-settings-file --config-protected-file=protected-settings-file

Parâmetros Obrigatórios

--cluster-name -c

Nome do cluster AKS.

--name -n

Nome da instância de extensão.

--resource-group -g

Nome do grupo de recursos.

Parâmetros Opcionais

Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.

--config --configuration-settings

Definições de configuração como par chave=valor.

Definições de configuração como par chave=valor. Repita o parâmetro para cada configuração. Não use isso para segredos, pois esse valor é retornado em resposta. Se não for especificado, o valor padrão será Nenhum.

Propriedade Valor
Grupo de parâmetros: Configuration Arguments
--config-file --config-settings-file

Caminho do arquivo JSON para definições de configuração.

Caminho do arquivo JSON para definições de configuração. Se não for especificado, o valor padrão será Nenhum.

Propriedade Valor
Grupo de parâmetros: Configuration Arguments
--config-protected --config-protected-settings

Configurações protegidas como par chave=valor.

Definições de configuração como par chave=valor. Repita o parâmetro para cada configuração. Somente a chave é retornada em resposta, o valor não é. Se não for especificado, o valor padrão será Non.

Propriedade Valor
Grupo de parâmetros: Configuration Arguments
--config-protected-file --config-protected-settings-file

Caminho do arquivo JSON para configurações protegidas.

Caminho do arquivo JSON para configurações protegidas. Se não for especificado, o valor padrão será Nenhum.

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

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

Propriedade Valor
Valor padrão: False
--yes -y

Ignora o prompt de confirmação.

Ignora o prompt de confirmação. Se não for especificado, o valor padrão será false.

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

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

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

Mostrar esta mensagem de ajuda e sair.

--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 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
Valor padrão: False