az connectedk8s

Nota

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

Comandos para gerenciar clusters kubernetes conectados.

Comandos

Name Description Tipo Estado
az connectedk8s connect

Integre 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 Pré-visualizar
az connectedk8s enable-features

Habilita os recursos seletivos no cluster conectado.

Extensão Pré-visualizar
az connectedk8s list

Liste 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 Pré-visualizar
az connectedk8s update

Atualize as propriedades do cluster kubernetes integrado ao arc.

Extensão GA
az connectedk8s upgrade

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

Extensão GA

az connectedk8s connect

Integre um cluster kubernetes conectado ao azure.

az connectedk8s connect --name
                        --resource-group
                        [--azure-hybrid-benefit {False, NotApplicable, True}]
                        [--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-private-link {false, true}]
                        [--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]
                        [--skip-ssl-verification]
                        [--tags]
                        [--yes]

Exemplos

Integre um cluster kubernetes conectado com configuração kube padrão e contexto kube.

az connectedk8s connect -g resourceGroupName -n connectedClusterName

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

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

Integre um cluster kubernetes conectado especificando kubeconfig e 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, proxy http, sem configurações 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 cert.

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

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

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

Parâmetros Obrigatórios

--name -n

O nome do cluster conectado.

--resource-group -g

o 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 aceites: False, NotApplicable, True
--container-log-path

Substitua o caminho de log de contêiner padrão para habilitar o log de bits fluentes.

--correlation-id

Um guid que é usado para rastrear internamente a origem da integração do cluster. Por favor, não o modifique, a menos que seja aconselhado.

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

Sinalizador para desativar a atualização automática de agentes de arco.

valor predefinido: False
--distribution

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

valores aceites: 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 predefinido: generic
--distribution-version

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

--enable-private-link
Pré-visualizar

Sinalizador para ativar/desativar o suporte a links privados em um recurso de cluster conectado. Valores permitidos: false, true.

valores aceites: false, true
--infrastructure

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

valores aceites: 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 predefinido: generic
--kube-config

Caminho para o arquivo de configuração kube.

--kube-context

Contexto Kubconfig da máquina 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 espere que a operação de longa duração termine.

valor predefinido: 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 em seu cluster exigirem mais tempo para instalar os pods do arc-agent.

valor predefinido: 600
--pls-arm-id --private-link-scope-resource-id
Pré-visualizar

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

--proxy-http

URL do proxy http a ser usado.

--proxy-https

URL do proxy Https a ser usado.

--proxy-skip-range

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

--skip-ssl-verification

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

valor predefinido: False
--tags

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

--yes -y

Não solicite confirmação.

valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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 kubeconfig e 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

Forçar exclusão para remover todos os recursos azure-arc do cluster.

valor predefinido: False
--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--kube-config

Caminho para o arquivo de configuração kube.

--kube-context

Contexto Kubconfig da máquina atual.

--name -n

O nome do cluster conectado.

--no-wait

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

valor predefinido: False
--resource-group -g

o 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 predefinido: False
--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--yes -y

Não solicite confirmação.

valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az connectedk8s disable-features

Pré-visualizar

Este comando está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: 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

Desativa o recurso azure-rbac.

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

Desative vários recursos.

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

Parâmetros Obrigatórios

--features

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

valores aceites: azure-rbac, cluster-connect, custom-locations

Parâmetros Opcionais

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--kube-config

Caminho para o arquivo de configuração kube.

--kube-context

Contexto Kubconfig da máquina atual.

--name -n

O nome do cluster conectado.

--resource-group -g

o 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 predefinido: False
--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--yes -y

Não solicite confirmação.

valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az connectedk8s enable-features

Pré-visualizar

Este comando está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: 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

Habilite 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 Obrigatórios

--features

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

valores aceites: azure-rbac, cluster-connect, custom-locations

Parâmetros Opcionais

--custom-locations-oid

OID do aplicativo 'custom-locations'.

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--kube-config

Caminho para o arquivo de configuração kube.

--kube-context

Contexto Kubconfig da máquina atual.

--name -n

O nome do cluster conectado.

--resource-group -g

o 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/e-mail/oid. O RBAC do Azure será ignorado para esses usuários. Especifique ao habilitar azure-rbac.

--skip-ssl-verification

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

valor predefinido: False
--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az connectedk8s list

Liste clusters kubernetes conectados.

az connectedk8s list [--resource-group]

Exemplos

Liste 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

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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 token de conta de serviço

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

Obtenha acesso a um cluster kubernetes conectado especificando o local kubeconfig personalizado

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

Obter acesso a um cluster kubernetes conectado especificando 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, atualiza o arquivo '~/.kube/config'. Em vez disso, use '-' para imprimir YAML para stdout.

valor predefinido: ~\.kube\config
--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--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 predefinido: 47011
--resource-group -g

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--token

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name -n

O nome do cluster conectado.

--resource-group -g

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az connectedk8s troubleshoot

Pré-visualizar

Este comando está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: 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 Obrigatórios

--name -n

O nome do cluster conectado.

--resource-group -g

o 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 da máquina atual.

--skip-ssl-verification

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

valor predefinido: False
--tags

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az connectedk8s update

Atualize as propriedades do cluster kubernetes integrado ao arc.

az connectedk8s update [--auto-upgrade {false, true}]
                       [--azure-hybrid-benefit {False, NotApplicable, True}]
                       [--container-log-path]
                       [--custom-ca-cert]
                       [--disable-proxy]
                       [--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]
                       [--ids]
                       [--kube-config]
                       [--kube-context]
                       [--name]
                       [--proxy-http]
                       [--proxy-https]
                       [--proxy-skip-range]
                       [--resource-group]
                       [--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

Desativar a atualização automática de agentes

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

Parâmetros Opcionais

--auto-upgrade

Sinalizar para ativar/desativar a atualização automática de agentes de arco. Por padrão, a atualização automática de agentes está habilitada.

valores aceites: false, true
--azure-hybrid-benefit

Sinalizar para habilitar/desabilitar o recurso Benefício Híbrido do Azure.

valores aceites: False, NotApplicable, True
--container-log-path

Substitua o caminho de log de contêiner padrão para habilitar o log de bits fluentes.

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

Caminho para o arquivo de certificado para proxy ou Autoridade de Certificação personalizada.

--disable-proxy

Desabilita as configurações de proxy para agentes.

valor predefinido: False
--distribution

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

valores aceites: 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.

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--kube-config

Caminho para o arquivo de configuração kube.

--kube-context

Contexto Kubconfig da máquina atual.

--name -n

O nome do cluster conectado.

--proxy-http

URL do proxy http a ser usado.

--proxy-https

URL do proxy Https a ser usado.

--proxy-skip-range

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

--resource-group -g

o 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 predefinido: False
--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--tags

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

--yes -y

Não solicite confirmação.

valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az connectedk8s upgrade

Atualize atomicamente os 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

Atualize 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 atualizar os gráficos de leme.

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--kube-config

Caminho para o arquivo de configuração kube.

--kube-context

Contexto Kubconfig da máquina atual.

--name -n

O nome do cluster conectado.

--resource-group -g

o 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 predefinido: False
--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--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 em seu cluster exigirem mais tempo para atualizar os pods do arc-agent.

valor predefinido: 600
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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