az connectedk8s

Riferimento

Nota

Questo riferimento fa parte dell'estensione connectedk8s per l'interfaccia della riga di comando di Azure (versione 2.38.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az connectedk8s . Altre informazioni sulle estensioni.

Comandi per gestire i cluster kubernetes connessi.

Comandi

Nome	Descrizione	Tipo	Status
az connectedk8s connect	Eseguire l'onboarding di un cluster Kubernetes connesso in Azure.	Estensione	Disponibilità generale
az connectedk8s delete	Eliminare un cluster kubernetes connesso insieme agli agenti del cluster connessi.	Estensione	Disponibilità generale
az connectedk8s disable-features	Disabilita le funzionalità selettive nel cluster connesso.	Estensione	Anteprima
az connectedk8s enable-features	Abilita le funzionalità selettive nel cluster connesso.	Estensione	Anteprima
az connectedk8s list	Elencare i cluster kubernetes connessi.	Estensione	Disponibilità generale
az connectedk8s proxy	Ottenere l'accesso a un cluster kubernetes connesso.	Estensione	Disponibilità generale
az connectedk8s show	Visualizzare i dettagli di un cluster kubernetes connesso.	Estensione	Disponibilità generale
az connectedk8s troubleshoot	Eseguire controlli di diagnostica in un cluster Kubernetes abilitato per Arc.	Estensione	Anteprima
az connectedk8s update	Aggiornare le proprietà del cluster kubernetes con onboarding arc.	Estensione	Disponibilità generale
az connectedk8s upgrade	Aggiornare in modo atomico gli agenti di cui è stato eseguito l'onboarding alla versione specifica o all'impostazione predefinita alla versione più recente.	Estensione	Disponibilità generale

az connectedk8s connect

Eseguire l'onboarding di un cluster Kubernetes connesso in 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-oidc-issuer {false, true}]
                        [--enable-private-link {false, true}]
                        [--enable-wi {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]
                        [--self-hosted-issuer]
                        [--skip-ssl-verification]
                        [--tags]
                        [--yes]

Esempio

Eseguire l'onboarding di un cluster kubernetes connesso con la configurazione kube predefinita e il contesto kube.

az connectedk8s connect -g resourceGroupName -n connectedClusterName

Eseguire l'onboarding di un cluster kubernetes connesso con la configurazione kube predefinita e il contesto kube e disabilitare l'aggiornamento automatico degli agenti arc.

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

Eseguire l'onboarding di un cluster kubernetes connesso specificando kubeconfig e kubecontext.

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

Eseguire l'onboarding di un cluster kubernetes connesso specificando il proxy https, il proxy HTTP e nessuna impostazione 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

Eseguire l'onboarding di un cluster kubernetes connesso specificando il proxy https, il proxy HTTP e nessun proxy con le impostazioni del certificato.

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

Eseguire l'onboarding di un cluster kubernetes connesso con funzionalità di collegamento privato abilitata specificando parametri di collegamento privato.

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

Eseguire l'onboarding di un cluster Kubernetes connesso con timeout di onboarding personalizzato.

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

Eseguire l'onboarding di un cluster kubernetes connesso con l'autorità emittente oidc e il webhook di identità del carico di lavoro abilitato.

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

Eseguire l'onboarding di un cluster kubernetes connesso con l'autorità emittente oidc abilitata usando un URL dell'autorità di certificazione self-hosted per il cluster cloud pubblico.

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

Parametri necessari

--name -n

Nome del cluster connesso.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

--azure-hybrid-benefit

Flag per abilitare/disabilitare la funzionalità di Vantaggio Azure Hybrid.

Valori accettati: False, NotApplicable, True

--container-log-path

Eseguire l'override del percorso predefinito del log del contenitore per abilitare la registrazione fluent-bit.

--correlation-id

GUID usato per tenere traccia internamente dell'origine dell'onboarding del cluster. Non modificarlo a meno che non sia consigliato.

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

Percorso del file di certificato per il proxy o l'autorità di certificazione personalizzata.

--custom-locations-oid

OID dell'app "custom-locations".

--disable-auto-upgrade

Flag per disabilitare l'aggiornamento automatico degli agenti arc.

Valore predefinito: False

--distribution

Distribuzione di Kubernetes che verrà eseguita in questo cluster connesso.

Valori accettati: 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

Valore predefinito: generic

--distribution-version

Versione di distribuzione kubernetes del cluster connesso.

--enable-oidc-issuer

Anteprima

Abilitare la creazione dell'URL dell'autorità emittente OIDC usata per l'identità del carico di lavoro.

Valori accettati: false, true

Valore predefinito: False

--enable-private-link

Anteprima

Flag per abilitare/disabilitare il supporto dei collegamenti privati in una risorsa cluster connessa. Valori consentiti: false, true.

Valori accettati: false, true

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

Anteprima

Abilitare il webhook di identità del carico di lavoro.

Valori accettati: false, true

Valore predefinito: False

--infrastructure

Infrastruttura in cui verrà eseguito il cluster Kubernetes rappresentato da questo cluster connesso.

Valori accettati: 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

Valore predefinito: generic

--kube-config

Percorso del file di configurazione kube.

--kube-context

Contesto Kubconfig dal computer corrente.

--location -l

Posizione. Usare i valori ottenuti con az account list-locations. È possibile configurare la posizione predefinito con az configure --defaults location=<location>.

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valore predefinito: False

--onboarding-timeout

Tempo necessario (in secondi) per installare i pod arc-agent nel cluster kubernetes. Eseguire l'override di questo valore se i vincoli hardware/di rete nel cluster richiedono più tempo per l'installazione dei pod arc-agent.

Valore predefinito: 1200

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

Anteprima

ID risorsa ARM della risorsa dell'ambito del collegamento privato a cui è associato questo cluster connesso.

--proxy-http

URL proxy HTTP da usare.

--proxy-https

URL proxy HTTPS da usare.

--proxy-skip-range

Elenco di URL/CIDR per i quali non deve essere usato il proxy.

--self-hosted-issuer

Anteprima

URL dell'autorità di certificazione self-hosted per cluster cloud pubblici: servizio Azure Kubernetes, GKE, EKS.

--skip-ssl-verification

Ignorare la verifica SSL per qualsiasi connessione cluster.

Valore predefinito: False

--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

--yes -y

Indica che non è richiesta la conferma.

Valore predefinito: False

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

Valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az connectedk8s delete

Eliminare un cluster kubernetes connesso insieme agli agenti del cluster connessi.

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

Esempio

Eliminare un cluster kubernetes connesso e gli agenti del cluster connessi con kubeconfig e kubecontext predefiniti.

az connectedk8s delete -g resourceGroupName -n connectedClusterName

Eliminare un cluster kubernetes connesso specificando kubeconfig e kubecontext per l'eliminazione degli agenti del cluster connessi.

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

Parametri facoltativi

--force

Forzare l'eliminazione per rimuovere tutte le risorse azure-arc dal cluster.

Valore predefinito: False

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti 'ID risorsa'. È necessario specificare --ids o altri argomenti 'ID risorsa'.

--kube-config

Percorso del file di configurazione kube.

--kube-context

Contesto Kubconfig dal computer corrente.

--name -n

Nome del cluster connesso.

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valore predefinito: False

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--skip-ssl-verification

Ignorare la verifica SSL per qualsiasi connessione cluster.

Valore predefinito: False

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--yes -y

Indica che non è richiesta la conferma.

Valore predefinito: False

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

Valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az connectedk8s disable-features

Anteprima

Questo comando è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Disabilita le funzionalità selettive nel cluster connesso.

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

Esempio

Disabilita la funzionalità azure-rbac.

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

Disabilitare più funzionalità.

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

Parametri necessari

--features

Elenco di funzionalità separate da spazi che si desidera disabilitare.

Valori accettati: azure-rbac, cluster-connect, custom-locations

Parametri facoltativi

--ids

--kube-config

Percorso del file di configurazione kube.

--kube-context

Contesto Kubconfig dal computer corrente.

--name -n

Nome del cluster connesso.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--skip-ssl-verification

Ignorare la verifica SSL per qualsiasi connessione cluster.

Valore predefinito: False

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--yes -y

Indica che non è richiesta la conferma.

Valore predefinito: False

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

Valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az connectedk8s enable-features

Anteprima

Questo comando è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Abilita le funzionalità selettive nel cluster connesso.

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]

Esempio

Abilita la funzionalità Cluster-Connect.

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

Abilitare la funzionalità Controllo degli accessi in base al ruolo di Azure.

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

Abilitare più funzionalità.

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

Parametri necessari

--features

Elenco delimitato da spazi delle funzionalità che si desidera abilitare.

Valori accettati: azure-rbac, cluster-connect, custom-locations

Parametri facoltativi

--custom-locations-oid

OID dell'app "custom-locations".

--ids

--kube-config

Percorso del file di configurazione kube.

--kube-context

Contesto Kubconfig dal computer corrente.

--name -n

Nome del cluster connesso.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--skip-azure-rbac-list

Elenco delimitato da virgole di nomi di nomi di nomi utente/posta elettronica/oid. Il controllo degli accessi in base al ruolo di Azure verrà ignorato per questi utenti. Specificare quando si abilita azure-rbac.

--skip-ssl-verification

Ignorare la verifica SSL per qualsiasi connessione cluster.

Valore predefinito: False

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

Valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az connectedk8s list

Elencare i cluster kubernetes connessi.

az connectedk8s list [--resource-group]

Esempio

Elencare tutti i cluster kubernetes connessi in un gruppo di risorse.

az connectedk8s list -g resourceGroupName --subscription subscriptionName

Elencare tutti i cluster kubernetes connessi in una sottoscrizione.

az connectedk8s list --subscription subscriptionName

Parametri facoltativi

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

Valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az connectedk8s proxy

Ottenere l'accesso a un cluster kubernetes connesso.

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

Esempio

Ottenere l'accesso a un cluster kubernetes connesso.

az connectedk8s proxy -n clusterName -g resourceGroupName

Ottenere l'accesso a un cluster kubernetes connesso con la porta personalizzata

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

Ottenere l'accesso a un cluster kubernetes connesso con il token dell'account del servizio

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

Ottenere l'accesso a un cluster kubernetes connesso specificando la posizione kubeconfig personalizzata

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

Ottenere l'accesso a un cluster kubernetes connesso specificando il contesto personalizzato

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

Parametri facoltativi

--file -f

File di configurazione di Kubernetes da aggiornare. Se non specificato, aggiorna il file '~/.kube/config'. Usare invece '-' per stampare YAML in stdout.

Valore predefinito: ~\.kube\config

--ids

--kube-context

Se specificato, sovrascrivere il nome di contesto predefinito.

--name -n

Nome del cluster connesso.

--port

Porta usata per l'accesso al cluster connesso.

Valore predefinito: 47011

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--token

Token dell'account del servizio da usare per eseguire l'autenticazione nel cluster kubernetes.

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

Valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az connectedk8s show

Visualizzare i dettagli di un cluster kubernetes connesso.

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

Esempio

Visualizzare i dettagli per un cluster kubernetes connesso

az connectedk8s show -g resourceGroupName -n connectedClusterName

Parametri facoltativi

--ids

--name -n

Nome del cluster connesso.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

Valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az connectedk8s troubleshoot

Anteprima

Questo comando è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Eseguire controlli di diagnostica in un cluster Kubernetes abilitato per Arc.

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

Esempio

Eseguire controlli di diagnostica in un cluster Kubernetes abilitato per Arc.

az connectedk8s troubleshoot -n clusterName -g resourceGroupName

Parametri necessari

--name -n

Nome del cluster connesso.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

--kube-config

Percorso del file di configurazione kube.

--kube-context

Contesto Kubeconfig dal computer corrente.

--skip-ssl-verification

Ignorare la verifica SSL per qualsiasi connessione cluster.

Valore predefinito: False

--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

Valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az connectedk8s update

Aggiornare le proprietà del cluster kubernetes con onboarding arc.

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

Esempio

Aggiornare i valori proxy per gli agenti

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

Disabilitare le impostazioni proxy per gli agenti

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

Disabilitare l'aggiornamento automatico degli agenti

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

Aggiornare un cluster kubernetes connesso con l'autorità emittente oidc e il webhook di identità del carico di lavoro abilitato.

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

Aggiornare un cluster kubernetes connesso con l'autorità di certificazione oidc abilitata usando un URL dell'autorità di certificazione self-hosted per il cluster cloud pubblico.

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

Disabilitare il webhook di identità del carico di lavoro in un cluster kubernetes connesso.

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

Parametri facoltativi

--auto-upgrade

Flag per abilitare/disabilitare l'aggiornamento automatico degli agenti arc. Per impostazione predefinita, l'aggiornamento automatico degli agenti è abilitato.

Valori accettati: false, true

--azure-hybrid-benefit

Flag per abilitare/disabilitare la funzionalità di Vantaggio Azure Hybrid.

Valori accettati: False, NotApplicable, True

--container-log-path

Eseguire l'override del percorso predefinito del log del contenitore per abilitare la registrazione fluent-bit.

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

Percorso del file di certificato per il proxy o l'autorità di certificazione personalizzata.

--disable-proxy

Disabilita le impostazioni proxy per gli agenti.

Valore predefinito: False

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

Anteprima

Disabilitare il webhook identità del carico di lavoro.

Valori accettati: false, true

--distribution

Distribuzione di Kubernetes che verrà eseguita in questo cluster connesso.

Valori accettati: 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

Versione di distribuzione kubernetes del cluster connesso.

--enable-oidc-issuer

Anteprima

Abilitare la creazione dell'URL dell'autorità emittente OIDC usata per l'identità del carico di lavoro.

Valori accettati: false, true

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

Anteprima

Abilitare il webhook di identità del carico di lavoro.

Valori accettati: false, true

--ids

--kube-config

Percorso del file di configurazione kube.

--kube-context

Contesto Kubconfig dal computer corrente.

--name -n

Nome del cluster connesso.

--proxy-http

URL proxy HTTP da usare.

--proxy-https

URL proxy HTTPS da usare.

--proxy-skip-range

Elenco di URL/CIDR per i quali non deve essere usato il proxy.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--self-hosted-issuer

Anteprima

URL dell'autorità di certificazione self-hosted per cluster cloud pubblici: servizio Azure Kubernetes, GKE, EKS.

--skip-ssl-verification

Ignorare la verifica SSL per qualsiasi connessione cluster.

Valore predefinito: False

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

--yes -y

Indica che non è richiesta la conferma.

Valore predefinito: False

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

Valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az connectedk8s upgrade

Aggiornare in modo atomico gli agenti di cui è stato eseguito l'onboarding alla versione specifica o all'impostazione predefinita alla versione più recente.

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

Esempio

Aggiornare gli agenti alla versione più recente

az connectedk8s upgrade -g resourceGroupName -n connectedClusterName

Aggiornare gli agenti a una versione specifica

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

Aggiornare gli agenti con timeout di aggiornamento personalizzato.

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

Parametri facoltativi

--agent-version

Versione dell'agente in cui aggiornare i grafici Helm.

--ids

--kube-config

Percorso del file di configurazione kube.

--kube-context

Contesto Kubconfig dal computer corrente.

--name -n

Nome del cluster connesso.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--skip-ssl-verification

Ignorare la verifica SSL per qualsiasi connessione cluster.

Valore predefinito: False

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--upgrade-timeout

Tempo necessario (in secondi) per l'aggiornamento dei pod arc-agent nel cluster kubernetes. Eseguire l'override di questo valore se i vincoli hardware/di rete nel cluster richiedono più tempo per l'aggiornamento dei pod arc-agent.

Valore predefinito: 600

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

Valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Condividi tramite

az connectedk8s

Comandi

az connectedk8s connect

Esempio

Parametri necessari

Parametri facoltativi

az connectedk8s delete

Esempio

Parametri facoltativi

az connectedk8s disable-features

Esempio

Parametri necessari

Parametri facoltativi

az connectedk8s enable-features

Esempio

Parametri necessari

Parametri facoltativi

az connectedk8s list

Esempio

Parametri facoltativi

az connectedk8s proxy

Esempio

Parametri facoltativi

az connectedk8s show

Esempio

Parametri facoltativi

az connectedk8s troubleshoot

Esempio

Parametri necessari

Parametri facoltativi

az connectedk8s update

Esempio

Parametri facoltativi

az connectedk8s upgrade

Esempio

Parametri facoltativi

Risorse aggiuntive