az connectedk8s

Nota

Essa referência faz parte da extensão connectedk8s para a CLI do Azure (versão 2.70.0 ou superior). A extensão instalará automaticamente na primeira vez que você executar um comando az connectedk8s. Saiba mais sobre extensões.

Comandos para gerenciar clusters kubernetes conectados.

Comandos

Nome	Description	Tipo	Status
az connectedk8s connect	Integrar um cluster kubernetes conectado ao azure.	Extensão	GA
az connectedk8s delete	Exclua um cluster kubernetes conectado junto com agentes de cluster conectados.	Extensão	GA
az connectedk8s disable-features	Desabilita os recursos seletivos no cluster conectado.	Extensão	Visualizar
az connectedk8s enable-features	Habilita os recursos seletivos no cluster conectado.	Extensão	Visualizar
az connectedk8s list	Listar clusters kubernetes conectados.	Extensão	GA
az connectedk8s proxy	Obtenha acesso a um cluster kubernetes conectado.	Extensão	GA
az connectedk8s show	Mostrar detalhes de um cluster kubernetes conectado.	Extensão	GA
az connectedk8s troubleshoot	Execute verificações de diagnóstico em um cluster kubernetes habilitado para Arc.	Extensão	Visualizar
az connectedk8s update	Atualize as propriedades do cluster kubernetes integrado ao arco.	Extensão	GA
az connectedk8s upgrade	Atualize atomicamente agentes integrados para a versão específica ou padrão para a versão mais recente.	Extensão	GA

az connectedk8s connect

Integrar um cluster kubernetes conectado ao azure.

O cluster kubernetes a ser integrado como um cluster conectado deve ser o cluster padrão no kubeconfig. Execute os contextos de obtenção de configuração do kubectl para confirmar o nome do contexto de destino. Em seguida, defina o contexto padrão para o cluster certo executando kubectl config use-context target-cluster-name.

az connectedk8s connect --name
                        --resource-group
                        [--azure-hybrid-benefit {False, NotApplicable, True}]
                        [--config]
                        [--config-protected]
                        [--container-log-path]
                        [--correlation-id]
                        [--custom-ca-cert]
                        [--custom-locations-oid]
                        [--disable-auto-upgrade]
                        [--distribution {aks, aks_edge_k3s, aks_edge_k8s, aks_engine, aks_management, aks_workload, canonical, capz, eks, generic, gke, k3s, karbon, kind, minikube, openshift, rancher_rke, tkg}]
                        [--distribution-version]
                        [--enable-oidc-issuer {false, true}]
                        [--enable-private-link {false, true}]
                        [--enable-wi {false, true}]
                        [--gateway-resource-id]
                        [--infrastructure {LTSCWindows 10 Enterprise LTSC, Windows 10 Enterprise, Windows 10 Enterprise LTSC 2019, Windows 10 Enterprise LTSC 2021, Windows 10 Enterprise N, Windows 10 Enterprise N LTSC 2019, Windows 10 Enterprise N LTSC 2021, Windows 10 IoT Enterprise, Windows 10 IoT Enterprise LTSC 2019, Windows 10 IoT Enterprise LTSC 2021, Windows 10 Pro, Windows 11 Enterprise, Windows 11 Enterprise N, Windows 11 IoT Enterprise, Windows 11 Pro, Windows Server 2019, Windows Server 2019 Datacenter, Windows Server 2019 Standard, Windows Server 2022, Windows Server 2022 Datacenter, Windows Server 2022 Standard, aws, azure, azure_stack_edge, azure_stack_hci, azure_stack_hub, gcp, generic, vsphere, windows_server}]
                        [--kube-config]
                        [--kube-context]
                        [--location]
                        [--no-wait]
                        [--onboarding-timeout]
                        [--pls-arm-id]
                        [--proxy-http]
                        [--proxy-https]
                        [--proxy-skip-range]
                        [--self-hosted-issuer]
                        [--skip-ssl-verification]
                        [--tags]
                        [--yes]

Exemplos

Integrar um cluster kubernetes conectado com o contexto de kube e kube padrão.

az connectedk8s connect -g resourceGroupName -n connectedClusterName

Integre um cluster kubernetes conectado com o contexto de kube e kube padrão e desabilitando a atualização automática de agentes do arc.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --disable-auto-upgrade

Integre um cluster kubernetes conectado especificando o kubeconfig e o kubecontext.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --kube-config /path/to/kubeconfig --kube-context kubeContextName

Integre um cluster kubernetes conectado especificando o proxy https, o proxy http, nenhuma configuração de proxy.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --proxy-https https://proxy-url --proxy-http http://proxy-url --proxy-skip-range excludedIP,excludedCIDR,exampleCIDRfollowed,10.0.0.0/24

Integre um cluster kubernetes conectado especificando o proxy https, proxy http, nenhum proxy com configurações de certificado.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --proxy-cert /path/to/crt --proxy-https https://proxy-url --proxy-http http://proxy-url --proxy-skip-range excludedIP,excludedCIDR,exampleCIDRfollowed,10.0.0.0/24

Integre um cluster kubernetes conectado com o recurso de link privado habilitado especificando parâmetros de link privado.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --enable-private-link true --private-link-scope-resource-id pls/resource/arm/id

Integrar um cluster kubernetes conectado com tempo limite de integração personalizado.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --onboarding-timeout 600

Integre um cluster kubernetes conectado com o emissor oidc e o webhook de identidade de carga de trabalho habilitado.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --enable-oidc-issuer --enable-workload-identity

Integre um cluster kubernetes conectado com o emissor oidc habilitado usando uma URL do emissor auto-hospedada para o cluster de nuvem pública.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --enable-oidc-issuer --self-hosted-issuer aksissuerurl

Integrar um cluster kubernetes conectado com o recurso de gateway do Azure habilitado.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --gateway-resource-id gatewayResourceId

Parâmetros Exigidos

--name -n

O nome do cluster conectado.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--azure-hybrid-benefit

Sinalizar para habilitar/desabilitar o recurso benefício híbrido do Azure.

Valores aceitos: False, NotApplicable, True

--config --configuration-settings

Versão Prévia

Configuração Configurações como chave=par de valor. Repita o parâmetro para cada configuração. Não use isso para segredos, pois esse valor é retornado em resposta.

--config-protected --config-protected-settings

Versão Prévia

Configuração Configurações Protegidas como chave=par de valor. Repita o parâmetro para cada configuração. Somente a chave é retornada em resposta, o valor não é.

--container-log-path

Substitua o caminho de log de contêiner padrão para habilitar o registro em log de bit fluente.

--correlation-id

Um guid usado para controlar internamente a origem da integração do cluster. Não modifique-o, a menos que seja aconselhável.

--custom-ca-cert --proxy-cert

Caminho para o arquivo de certificado para proxy ou autoridade de certificação personalizada.

--custom-locations-oid

OID do aplicativo 'custom-locations'.

--disable-auto-upgrade

Sinalizar para desabilitar a atualização automática de agentes do arc.

Valor padrão: False

--distribution

A distribuição do Kubernetes que será executada nesse cluster conectado.

Valores aceitos: aks, aks_edge_k3s, aks_edge_k8s, aks_engine, aks_management, aks_workload, canonical, capz, eks, generic, gke, k3s, karbon, kind, minikube, openshift, rancher_rke, tkg

Valor padrão: generic

--distribution-version

A versão de distribuição do Kubernetes do cluster conectado.

--enable-oidc-issuer

Versão Prévia

Habilite a criação da URL do emissor OIDC usada para a federação de identidade de carga de trabalho.

Valores aceitos: false, true

Valor padrão: False

--enable-private-link

Versão Prévia

Sinalizar para habilitar/desabilitar o suporte de link privado em um recurso de cluster conectado. Valores permitidos: false, true.

Valores aceitos: false, true

--enable-wi --enable-workload-identity

Versão Prévia

Habilite o webhook de identidade de carga de trabalho.

Valores aceitos: false, true

Valor padrão: False

--gateway-resource-id

Versão Prévia

ArmID do recurso do Gateway do Arc.

--infrastructure

A infraestrutura na qual o cluster kubernetes representado por esse cluster conectado será executado.

Valores aceitos: LTSCWindows 10 Enterprise LTSC, Windows 10 Enterprise, Windows 10 Enterprise LTSC 2019, Windows 10 Enterprise LTSC 2021, Windows 10 Enterprise N, Windows 10 Enterprise N LTSC 2019, Windows 10 Enterprise N LTSC 2021, Windows 10 IoT Enterprise, Windows 10 IoT Enterprise LTSC 2019, Windows 10 IoT Enterprise LTSC 2021, Windows 10 Pro, Windows 11 Enterprise, Windows 11 Enterprise N, Windows 11 IoT Enterprise, Windows 11 Pro, Windows Server 2019, Windows Server 2019 Datacenter, Windows Server 2019 Standard, Windows Server 2022, Windows Server 2022 Datacenter, Windows Server 2022 Standard, aws, azure, azure_stack_edge, azure_stack_hci, azure_stack_hub, gcp, generic, vsphere, windows_server

Valor padrão: generic

--kube-config

Caminho para o arquivo de configuração kube.

--kube-context

Contexto kubconfig do computador atual.

--location -l

Localização. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--no-wait

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

Valor padrão: False

--onboarding-timeout

Tempo necessário (em segundos) para que os pods do arc-agent sejam instalados no cluster kubernetes. Substitua esse valor se as restrições de hardware/rede no cluster exigirem mais tempo para instalar os pods do arc-agent.

Valor padrão: 1200

--pls-arm-id --private-link-scope-resource-id

Versão Prévia

ID de recurso arm do recurso de escopo de link privado ao qual esse cluster conectado está associado.

--proxy-http

URL de proxy http a ser usada.

--proxy-https

URL de proxy https a ser usada.

--proxy-skip-range

Lista de URLs/CIDRs para as quais o proxy não deve ser usado.

--self-hosted-issuer

Versão Prévia

URL do emissor auto-hospedado para clusters de nuvem pública – AKS, GKE, EKS.

--skip-ssl-verification

Ignore a verificação SSL para qualquer conexão de cluster.

Valor padrão: False

--tags

Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.

--yes -y

Não solicite confirmação.

Valor padrão: False

Parâmetros Globais

--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az connectedk8s delete

Exclua um cluster kubernetes conectado junto com agentes de cluster conectados.

az connectedk8s delete [--force]
                       [--ids]
                       [--kube-config]
                       [--kube-context]
                       [--name]
                       [--no-wait]
                       [--resource-group]
                       [--skip-ssl-verification]
                       [--subscription]
                       [--yes]

Exemplos

Exclua um cluster kubernetes conectado e agentes de cluster conectados com kubeconfig e kubecontext padrão.

az connectedk8s delete -g resourceGroupName -n connectedClusterName

Exclua um cluster kubernetes conectado especificando o kubeconfig e o kubecontext para exclusão de agentes de cluster conectados.

az connectedk8s delete -g resourceGroupName -n connectedClusterName --kube-config /path/to/kubeconfig --kube-context kubeContextName

Parâmetros Opcionais

--force

Force a exclusão para remover todos os recursos do azure-arc do cluster.

Valor padrão: False

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--kube-config

Caminho para o arquivo de configuração kube.

--kube-context

Contexto kubconfig do computador atual.

--name -n

O nome do cluster conectado.

--no-wait

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

Valor padrão: False

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--skip-ssl-verification

Ignore a verificação SSL para qualquer conexão de cluster.

Valor padrão: False

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--yes -y

Não solicite confirmação.

Valor padrão: False

Parâmetros Globais

--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az connectedk8s disable-features

Versão Prévia

Esse comando está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Desabilita os recursos seletivos no cluster conectado.

az connectedk8s disable-features --features {azure-rbac, cluster-connect, custom-locations}
                                 [--ids]
                                 [--kube-config]
                                 [--kube-context]
                                 [--name]
                                 [--resource-group]
                                 [--skip-ssl-verification]
                                 [--subscription]
                                 [--yes]

Exemplos

Desabilita o recurso azure-rbac.

az connectedk8s disable-features -n clusterName -g resourceGroupName --features azure-rbac

Desabilite vários recursos.

az connectedk8s disable-features -n clusterName -g resourceGroupName --features custom-locations azure-rbac

Parâmetros Exigidos

--features

Lista separada por espaço de recursos que você deseja desabilitar.

Valores aceitos: azure-rbac, cluster-connect, custom-locations

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--kube-config

Caminho para o arquivo de configuração kube.

--kube-context

Contexto kubconfig do computador atual.

--name -n

O nome do cluster conectado.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--skip-ssl-verification

Ignore a verificação SSL para qualquer conexão de cluster.

Valor padrão: False

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--yes -y

Não solicite confirmação.

Valor padrão: False

Parâmetros Globais

--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az connectedk8s enable-features

Versão Prévia

Esse comando está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Habilita os recursos seletivos no cluster conectado.

az connectedk8s enable-features --features {azure-rbac, cluster-connect, custom-locations}
                                [--custom-locations-oid]
                                [--ids]
                                [--kube-config]
                                [--kube-context]
                                [--name]
                                [--resource-group]
                                [--skip-azure-rbac-list]
                                [--skip-ssl-verification]
                                [--subscription]

Exemplos

Habilita o recurso Cluster-Connect.

az connectedk8s enable-features -n clusterName -g resourceGroupName --features cluster-connect

Habilitar o recurso RBAC do Azure.

az connectedk8s enable-features -n clusterName -g resourceGroupName --features azure-rbac --skip-azure-rbac-list "user1@domain.com,spn_oid"

Habilite vários recursos.

az connectedk8s enable-features -n clusterName -g resourceGroupName --features cluster-connect custom-locations

Parâmetros Exigidos

--features

Lista separada por espaço dos recursos que você deseja habilitar.

Valores aceitos: azure-rbac, cluster-connect, custom-locations

Parâmetros Opcionais

--custom-locations-oid

OID do aplicativo 'custom-locations'.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--kube-config

Caminho para o arquivo de configuração kube.

--kube-context

Contexto kubconfig do computador atual.

--name -n

O nome do cluster conectado.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--skip-azure-rbac-list

Lista separada por vírgulas de nomes de usuário/email/oid. O RBAC do Azure será ignorado para esses usuários. Especifique ao habilitar o azure-rbac.

--skip-ssl-verification

Ignore a verificação SSL para qualquer conexão de cluster.

Valor padrão: False

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Parâmetros Globais

--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az connectedk8s list

Listar clusters kubernetes conectados.

az connectedk8s list [--resource-group]

Exemplos

Listar todos os clusters kubernetes conectados em um grupo de recursos.

az connectedk8s list -g resourceGroupName --subscription subscriptionName

Liste todos os clusters kubernetes conectados em uma assinatura.

az connectedk8s list --subscription subscriptionName

Parâmetros Opcionais

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az connectedk8s proxy

Obtenha acesso a um cluster kubernetes conectado.

az connectedk8s proxy [--file]
                      [--ids]
                      [--kube-context]
                      [--name]
                      [--port]
                      [--resource-group]
                      [--subscription]
                      [--token]

Exemplos

Obtenha acesso a um cluster kubernetes conectado.

az connectedk8s proxy -n clusterName -g resourceGroupName

Obter acesso a um cluster kubernetes conectado com porta personalizada

az connectedk8s proxy -n clusterName -g resourceGroupName --port portValue

Obter acesso a um cluster kubernetes conectado com o token de conta de serviço

az connectedk8s proxy -n clusterName -g resourceGroupName --token tokenValue

Obter acesso a um cluster kubernetes conectado especificando o local de kubeconfig personalizado

az connectedk8s proxy -n clusterName -g resourceGroupName -f path/to/kubeconfig

Obter acesso a um cluster kubernetes conectado especificando o contexto personalizado

az connectedk8s proxy -n clusterName -g resourceGroupName --kube-context contextName

Parâmetros Opcionais

--file -f

Arquivo de configuração do Kubernetes a ser atualizado. Se não for fornecido, atualizará o arquivo '~/.kube/config'. Use '-' para imprimir YAML para stdout em vez disso.

Valor padrão: ~\.kube\config

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--kube-context

Se especificado, substitua o nome de contexto padrão.

--name -n

O nome do cluster conectado.

--port

Porta usada para acessar o cluster conectado.

Valor padrão: 47011

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--token

Token de conta de serviço a ser usado para autenticar no cluster kubernetes.

Parâmetros Globais

--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az connectedk8s show

Mostrar detalhes de um cluster kubernetes conectado.

az connectedk8s show [--ids]
                     [--name]
                     [--resource-group]
                     [--subscription]

Exemplos

Mostrar os detalhes de um cluster kubernetes conectado

az connectedk8s show -g resourceGroupName -n connectedClusterName

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--name -n

O nome do cluster conectado.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Parâmetros Globais

--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az connectedk8s troubleshoot

Versão Prévia

Esse comando está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Execute verificações de diagnóstico em um cluster kubernetes habilitado para Arc.

az connectedk8s troubleshoot --name
                             --resource-group
                             [--kube-config]
                             [--kube-context]
                             [--skip-ssl-verification]
                             [--tags]

Exemplos

Execute verificações de diagnóstico em um cluster kubernetes habilitado para Arc.

az connectedk8s troubleshoot -n clusterName -g resourceGroupName

Parâmetros Exigidos

--name -n

O nome do cluster conectado.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--kube-config

Caminho para o arquivo de configuração kube.

--kube-context

Contexto kubeconfig do computador atual.

--skip-ssl-verification

Ignore a verificação SSL para qualquer conexão de cluster.

Valor padrão: False

--tags

Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.

Parâmetros Globais

--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az connectedk8s update

Atualize as propriedades do cluster kubernetes integrado ao arco.

az connectedk8s update [--auto-upgrade {false, true}]
                       [--azure-hybrid-benefit {False, NotApplicable, True}]
                       [--config]
                       [--config-protected]
                       [--container-log-path]
                       [--custom-ca-cert]
                       [--disable-gateway {false, true}]
                       [--disable-proxy]
                       [--disable-wi {false, true}]
                       [--distribution {aks, aks_edge_k3s, aks_edge_k8s, aks_engine, aks_management, aks_workload, canonical, capz, eks, generic, gke, k3s, karbon, kind, minikube, openshift, rancher_rke, tkg}]
                       [--distribution-version]
                       [--enable-oidc-issuer {false, true}]
                       [--enable-wi {false, true}]
                       [--gateway-resource-id]
                       [--ids]
                       [--kube-config]
                       [--kube-context]
                       [--name]
                       [--proxy-http]
                       [--proxy-https]
                       [--proxy-skip-range]
                       [--resource-group]
                       [--self-hosted-issuer]
                       [--skip-ssl-verification]
                       [--subscription]
                       [--tags]
                       [--yes]

Exemplos

Atualizar valores de proxy para os agentes

az connectedk8s update -g resourceGroupName -n connectedClusterName  --proxy-cert /path/to/crt --proxy-https https://proxy-url --proxy-http http://proxy-url --proxy-skip-range excludedIP,excludedCIDR,exampleCIDRfollowed,10.0.0.0/24

Desabilitar configurações de proxy para agentes

az connectedk8s update -g resourceGroupName -n connectedClusterName --disable-proxy

Desabilitar a atualização automática de agentes

az connectedk8s update -g resourceGroupName -n connectedClusterName --auto-upgrade false

Atualize um cluster kubernetes conectado com o emissor oidc e o webhook de identidade de carga de trabalho habilitado.

az connectedk8s update -g resourceGroupName -n connectedClusterName --enable-oidc-issuer --enable-workload-identity

Atualize um cluster kubernetes conectado com o emissor oidc habilitado usando uma URL do emissor auto-hospedada para o cluster de nuvem pública.

az connectedk8s update -g resourceGroupName -n connectedClusterName --enable-oidc-issuer --self-hosted-issuer aksissuerurl

Desabilite o webhook de identidade de carga de trabalho em um cluster kubernetes conectado.

az connectedk8s update -g resourceGroupName -n connectedClusterName --disable-workload-identity

Atualize um cluster kubernetes conectado com o recurso de gateway do Azure habilitado.

az connectedk8s update -g resourceGroupName -n connectedClusterName --gateway-resource-id gatewayResourceId

Desabilite o recurso de gateway do azure em um cluster kubernetes conectado.

az connectedk8s update -g resourceGroupName -n connectedClusterName --disable-gateway

Parâmetros Opcionais

--auto-upgrade

Sinalizar para habilitar/desabilitar a atualização automática de agentes arc. Por padrão, a atualização automática de agentes está habilitada.

Valores aceitos: false, true

--azure-hybrid-benefit

Sinalizar para habilitar/desabilitar o recurso benefício híbrido do Azure.

Valores aceitos: False, NotApplicable, True

--config --configuration-settings

Versão Prévia

Configuração Configurações como chave=par de valor. Repita o parâmetro para cada configuração. Não use isso para segredos, pois esse valor é retornado em resposta.

--config-protected --config-protected-settings

Versão Prévia

Configuração Configurações Protegidas como chave=par de valor. Repita o parâmetro para cada configuração. Somente a chave é retornada em resposta, o valor não é.

--container-log-path

Substitua o caminho de log de contêiner padrão para habilitar o registro em log de bit fluente.

--custom-ca-cert --proxy-cert

Caminho para o arquivo de certificado para proxy ou autoridade de certificação personalizada.

--disable-gateway

Versão Prévia

Sinalizar para desabilitar o Gateway do Arc.

Valores aceitos: false, true

Valor padrão: False

--disable-proxy

Desabilita as configurações de proxy para agentes.

Valor padrão: False

--disable-wi --disable-workload-identity

Versão Prévia

Desabilite o webhook de identidade de carga de trabalho.

Valores aceitos: false, true

--distribution

A distribuição do Kubernetes que será executada nesse cluster conectado.

Valores aceitos: aks, aks_edge_k3s, aks_edge_k8s, aks_engine, aks_management, aks_workload, canonical, capz, eks, generic, gke, k3s, karbon, kind, minikube, openshift, rancher_rke, tkg

--distribution-version

A versão de distribuição do Kubernetes do cluster conectado.

--enable-oidc-issuer

Versão Prévia

Habilite a criação da URL do emissor OIDC usada para a federação de identidade de carga de trabalho.

Valores aceitos: false, true

--enable-wi --enable-workload-identity

Versão Prévia

Habilite o webhook de identidade de carga de trabalho.

Valores aceitos: false, true

--gateway-resource-id

Versão Prévia

ArmID do recurso do Gateway do Arc.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--kube-config

Caminho para o arquivo de configuração kube.

--kube-context

Contexto kubconfig do computador atual.

--name -n

O nome do cluster conectado.

--proxy-http

URL de proxy http a ser usada.

--proxy-https

URL de proxy https a ser usada.

--proxy-skip-range

Lista de URLs/CIDRs para as quais o proxy não deve ser usado.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--self-hosted-issuer

Versão Prévia

URL do emissor auto-hospedado para clusters de nuvem pública – AKS, GKE, EKS.

--skip-ssl-verification

Ignore a verificação SSL para qualquer conexão de cluster.

Valor padrão: False

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--tags

Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.

--yes -y

Não solicite confirmação.

Valor padrão: False

Parâmetros Globais

--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az connectedk8s upgrade

Atualize atomicamente agentes integrados para a versão específica ou padrão para a versão mais recente.

az connectedk8s upgrade [--agent-version]
                        [--ids]
                        [--kube-config]
                        [--kube-context]
                        [--name]
                        [--resource-group]
                        [--skip-ssl-verification]
                        [--subscription]
                        [--upgrade-timeout]

Exemplos

Atualizar os agentes para a versão mais recente

az connectedk8s upgrade -g resourceGroupName -n connectedClusterName

Atualizar os agentes para uma versão específica

az connectedk8s upgrade -g resourceGroupName -n connectedClusterName --agent-version 0.2.62

Atualize os agentes com tempo limite de atualização personalizado.

az connectedk8s upgrade -g resourceGroupName -n connectedClusterName --upgrade-timeout 600

Parâmetros Opcionais

--agent-version

Versão do agente para a qual atualizar os gráficos do helm.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--kube-config

Caminho para o arquivo de configuração kube.

--kube-context

Contexto kubconfig do computador atual.

--name -n

O nome do cluster conectado.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--skip-ssl-verification

Ignore a verificação SSL para qualquer conexão de cluster.

Valor padrão: False

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--upgrade-timeout

Tempo necessário (em segundos) para que os pods do arc-agent sejam atualizados no cluster kubernetes. Substitua esse valor se as restrições de hardware/rede no cluster exigirem mais tempo para atualizar os pods do arc-agent.

Valor padrão: 600

Parâmetros Globais

--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.