az connectedk8s

  • Referens

Kommentar

Den här referensen är en del av connectedk8s-tillägget för Azure CLI (version 2.38.0 eller senare). Tillägget installeras automatiskt första gången du kör kommandot az connectedk8s . Läs mer om tillägg.

Kommandon för att hantera anslutna kubernetes-kluster.

Kommandon

Name Description Typ Status
az connectedk8s connect

Registrera ett anslutet kubernetes-kluster till Azure.

 Anknytning Allmän tillgänglighet
az connectedk8s delete

Ta bort ett anslutet kubernetes-kluster tillsammans med anslutna klusteragenter.

 Anknytning Allmän tillgänglighet
az connectedk8s disable-features

Inaktiverar selektiva funktioner i det anslutna klustret.

 Anknytning Förhandsversion
az connectedk8s enable-features

Aktiverar selektiva funktioner i det anslutna klustret.

 Anknytning Förhandsversion
az connectedk8s list

Lista anslutna kubernetes-kluster.

 Anknytning Allmän tillgänglighet
az connectedk8s proxy

Få åtkomst till ett anslutet kubernetes-kluster.

 Anknytning Allmän tillgänglighet
az connectedk8s show

Visa information om ett anslutet kubernetes-kluster.

 Anknytning Allmän tillgänglighet
az connectedk8s troubleshoot

Utför diagnostikkontroller på ett Arc-aktiverat Kubernetes-kluster.

 Anknytning Förhandsversion
az connectedk8s update

Uppdatera egenskaperna för det arc-registrerade kubernetes-klustret.

 Anknytning Allmän tillgänglighet
az connectedk8s upgrade

Atomiskt uppgradera registrerade agenter till den specifika versionen eller standardvärdet för den senaste versionen.

 Anknytning Allmän tillgänglighet

az connectedk8s connect

Registrera ett anslutet kubernetes-kluster till 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]

Exempel

Registrera ett anslutet kubernetes-kluster med kube-standardkontexten och kube-kontexten.

az connectedk8s connect -g resourceGroupName -n connectedClusterName

Registrera ett anslutet kubernetes-kluster med kube-standardkonfiguration och kube-kontext och inaktivera automatisk uppgradering av arc-agenter.

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

Registrera ett anslutet kubernetes-kluster genom att ange kubeconfig och kubecontext.

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

Registrera ett anslutet kubernetes-kluster genom att ange https-proxyn, http-proxyn, inga proxyinställningar.

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

Registrera ett anslutet kubernetes-kluster genom att ange https-proxyn, http-proxyn, ingen proxy med certifikatinställningar.

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

Registrera ett anslutet kubernetes-kluster med funktionen private link aktiverad genom att ange parametrar för privata länkar.

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

Registrera ett anslutet kubernetes-kluster med anpassad timeout för registrering.

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

Registrera ett anslutet kubernetes-kluster med oidc-utfärdaren och webhooken för arbetsbelastningsidentitet aktiverad.

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

Registrera ett anslutet kubernetes-kluster med oidc-utfärdaren aktiverad med hjälp av en egen värdbaserad utfärdar-URL för offentliga molnkluster.

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

Obligatoriska parametrar

--name -n

Namnet på det anslutna klustret.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Valfria parametrar

--azure-hybrid-benefit

Flagga för att aktivera/inaktivera Azure Hybrid-förmånsfunktionen.

Godkända värden: False, NotApplicable, True
--container-log-path

Åsidosätt standardsökvägen för containerloggen för att aktivera fluent-bit-loggning.

--correlation-id

Ett guid som används för att internt spåra källan till klusterregistrering. Ändra den inte om det inte rekommenderas.

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

Sökväg till certifikatfilen för proxy eller anpassad certifikatutfärdare.

--custom-locations-oid

OID för appen "anpassade platser".

--disable-auto-upgrade

Flagga för att inaktivera automatisk uppgradering av arc-agenter.

Standardvärde: False
--distribution

Kubernetes-distributionen som körs i det här anslutna klustret.

Godkända värden: 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
Standardvärde: generic
--distribution-version

Kubernetes-distributionsversionen av det anslutna klustret.

--enable-oidc-issuer
Förhandsgranskning

Aktivera skapande av url för OIDC-utfärdare som används för arbetsbelastningsidentitet.

Godkända värden: false, true
Standardvärde: False
--enable-private-link
Förhandsgranskning

Flagga för att aktivera/inaktivera stöd för privata länkar för en ansluten klusterresurs. Tillåtna värden: false, true.

Godkända värden: false, true
--enable-wi --enable-workload-identity
Förhandsgranskning

Aktivera webhook för arbetsbelastningsidentitet.

Godkända värden: false, true
Standardvärde: False
--infrastructure

Den infrastruktur som Kubernetes-klustret som representeras av det här anslutna klustret körs på.

Godkända värden: 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
Standardvärde: generic
--kube-config

Sökväg till kube-konfigurationsfilen.

--kube-context

Kubconfig-kontext från den aktuella datorn.

--location -l

Plats. Värden från: az account list-locations. Du kan konfigurera standardplatsen med hjälp av az configure --defaults location=<location>.

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

Standardvärde: False
--onboarding-timeout

Tid som krävs (i sekunder) för att arc-agent-poddar ska installeras i kubernetes-klustret. Åsidosätt det här värdet om maskinvaru-/nätverksbegränsningarna i klustret kräver mer tid för att installera arc-agent-poddarna.

Standardvärde: 1200
--pls-arm-id --private-link-scope-resource-id
Förhandsgranskning

ARM-resurs-ID för den privata länkomfångsresurs som det här anslutna klustret är associerat med.

--proxy-http

HTTP-proxy-URL som ska användas.

--proxy-https

Https-proxy-URL som ska användas.

--proxy-skip-range

Lista över URL:er/CIDR:er som proxyn inte ska användas för.

--self-hosted-issuer
Förhandsgranskning

Url för lokalt installerad utfärdare för offentliga molnkluster – AKS, GKE, EKS.

--skip-ssl-verification

Hoppa över SSL-verifiering för alla klusteranslutningar.

Standardvärde: False
--tags

Blankstegsavgränsade taggar: key[=value] [key[=value] ...]. Använd "" för att rensa befintliga taggar.

--yes -y

Fråga inte efter bekräftelse.

Standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az connectedk8s delete

Ta bort ett anslutet kubernetes-kluster tillsammans med anslutna klusteragenter.

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

Exempel

Ta bort ett anslutet kubernetes-kluster och anslutna klusteragenter med standard-kubeconfig och kubecontext.

az connectedk8s delete -g resourceGroupName -n connectedClusterName

Ta bort ett anslutet kubernetes-kluster genom att ange kubeconfig och kubecontext för borttagning av anslutna klusteragenter.

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

Valfria parametrar

--force

Framtvinga borttagning för att ta bort alla azure-arc-resurser från klustret.

Standardvärde: False
--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--kube-config

Sökväg till kube-konfigurationsfilen.

--kube-context

Kubconfig-kontext från den aktuella datorn.

--name -n

Namnet på det anslutna klustret.

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

Standardvärde: False
--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--skip-ssl-verification

Hoppa över SSL-verifiering för alla klusteranslutningar.

Standardvärde: False
--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--yes -y

Fråga inte efter bekräftelse.

Standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az connectedk8s disable-features

Förhandsgranskning

Det här kommandot är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Inaktiverar selektiva funktioner i det anslutna klustret.

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

Exempel

Inaktiverar funktionen azure-rbac.

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

Inaktivera flera funktioner.

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

Obligatoriska parametrar

--features

Blankstegsavgränsad lista över funktioner som du vill inaktivera.

Godkända värden: azure-rbac, cluster-connect, custom-locations

Valfria parametrar

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--kube-config

Sökväg till kube-konfigurationsfilen.

--kube-context

Kubconfig-kontext från den aktuella datorn.

--name -n

Namnet på det anslutna klustret.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--skip-ssl-verification

Hoppa över SSL-verifiering för alla klusteranslutningar.

Standardvärde: False
--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--yes -y

Fråga inte efter bekräftelse.

Standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az connectedk8s enable-features

Förhandsgranskning

Det här kommandot är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Aktiverar selektiva funktioner i det anslutna klustret.

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]

Exempel

Aktiverar funktionen Cluster-Connect.

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

Aktivera Azure RBAC-funktionen.

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

Aktivera flera funktioner.

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

Obligatoriska parametrar

--features

Utrymmesavgränsad lista över funktioner som du vill aktivera.

Godkända värden: azure-rbac, cluster-connect, custom-locations

Valfria parametrar

--custom-locations-oid

OID för appen "anpassade platser".

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--kube-config

Sökväg till kube-konfigurationsfilen.

--kube-context

Kubconfig-kontext från den aktuella datorn.

--name -n

Namnet på det anslutna klustret.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--skip-azure-rbac-list

Kommaavgränsad lista över namn på användarnamn/e-post/oid. Azure RBAC hoppas över för dessa användare. Ange när du aktiverar azure-rbac.

--skip-ssl-verification

Hoppa över SSL-verifiering för alla klusteranslutningar.

Standardvärde: False
--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az connectedk8s list

Lista anslutna kubernetes-kluster.

az connectedk8s list [--resource-group]

Exempel

Visa en lista över alla anslutna kubernetes-kluster i en resursgrupp.

az connectedk8s list -g resourceGroupName --subscription subscriptionName

Visa en lista över alla anslutna kubernetes-kluster i en prenumeration.

az connectedk8s list --subscription subscriptionName

Valfria parametrar

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az connectedk8s proxy

Få åtkomst till ett anslutet kubernetes-kluster.

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

Exempel

Få åtkomst till ett anslutet kubernetes-kluster.

az connectedk8s proxy -n clusterName -g resourceGroupName

Få åtkomst till ett anslutet kubernetes-kluster med anpassad port

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

Få åtkomst till ett anslutet kubernetes-kluster med tjänstkontotoken

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

Få åtkomst till ett anslutet kubernetes-kluster genom att ange en anpassad kubeconfig-plats

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

Få åtkomst till ett anslutet kubernetes-kluster genom att ange anpassad kontext

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

Valfria parametrar

--file -f

Kubernetes-konfigurationsfil som ska uppdateras. Om det inte anges uppdaterar du filen ~/.kube/config. Använd "-" för att skriva ut YAML till stdout i stället.

Standardvärde: ~\.kube\config
--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--kube-context

Om du anger det skriver du över standardkontextnamnet.

--name -n

Namnet på det anslutna klustret.

--port

Port som används för åtkomst till anslutna kluster.

Standardvärde: 47011
--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--token

Tjänstkontotoken som ska användas för att autentisera till kubernetes-klustret.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az connectedk8s show

Visa information om ett anslutet kubernetes-kluster.

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

Exempel

Visa information för ett anslutet kubernetes-kluster

az connectedk8s show -g resourceGroupName -n connectedClusterName

Valfria parametrar

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--name -n

Namnet på det anslutna klustret.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az connectedk8s troubleshoot

Förhandsgranskning

Det här kommandot är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Utför diagnostikkontroller på ett Arc-aktiverat Kubernetes-kluster.

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

Exempel

Utför diagnostikkontroller på ett Arc-aktiverat Kubernetes-kluster.

az connectedk8s troubleshoot -n clusterName -g resourceGroupName

Obligatoriska parametrar

--name -n

Namnet på det anslutna klustret.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Valfria parametrar

--kube-config

Sökväg till kube-konfigurationsfilen.

--kube-context

Kubeconfig-kontext från den aktuella datorn.

--skip-ssl-verification

Hoppa över SSL-verifiering för alla klusteranslutningar.

Standardvärde: False
--tags

Blankstegsavgränsade taggar: key[=value] [key[=value] ...]. Använd "" för att rensa befintliga taggar.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az connectedk8s update

Uppdatera egenskaperna för det arc-registrerade kubernetes-klustret.

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]

Exempel

Uppdatera proxyvärden för agenterna

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

Inaktivera proxyinställningar för agenter

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

Inaktivera automatisk uppgradering av agenter

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

Uppdatera ett anslutet kubernetes-kluster med oidc-utfärdaren och webhooken för arbetsbelastningsidentitet aktiverad.

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

Uppdatera ett anslutet kubernetes-kluster med oidc-utfärdaren aktiverad med hjälp av en url för utfärdare med egen värd för offentliga molnkluster.

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

Inaktivera webhooken för arbetsbelastningsidentitet i ett anslutet kubernetes-kluster.

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

Valfria parametrar

--auto-upgrade

Flagga för att aktivera/inaktivera automatisk uppgradering av arc-agenter. Som standard aktiveras automatisk uppgradering av agenter.

Godkända värden: false, true
--azure-hybrid-benefit

Flagga för att aktivera/inaktivera Azure Hybrid-förmånsfunktionen.

Godkända värden: False, NotApplicable, True
--container-log-path

Åsidosätt standardsökvägen för containerloggen för att aktivera fluent-bit-loggning.

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

Sökväg till certifikatfilen för proxy eller anpassad certifikatutfärdare.

--disable-proxy

Inaktiverar proxyinställningar för agenter.

Standardvärde: False
--disable-wi --disable-workload-identity
Förhandsgranskning

Inaktivera webhooken för arbetsbelastningsidentitet.

Godkända värden: false, true
--distribution

Kubernetes-distributionen som körs i det här anslutna klustret.

Godkända värden: 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

Kubernetes-distributionsversionen av det anslutna klustret.

--enable-oidc-issuer
Förhandsgranskning

Aktivera skapande av url för OIDC-utfärdare som används för arbetsbelastningsidentitet.

Godkända värden: false, true
--enable-wi --enable-workload-identity
Förhandsgranskning

Aktivera webhook för arbetsbelastningsidentitet.

Godkända värden: false, true
--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--kube-config

Sökväg till kube-konfigurationsfilen.

--kube-context

Kubconfig-kontext från den aktuella datorn.

--name -n

Namnet på det anslutna klustret.

--proxy-http

HTTP-proxy-URL som ska användas.

--proxy-https

Https-proxy-URL som ska användas.

--proxy-skip-range

Lista över URL:er/CIDR:er som proxyn inte ska användas för.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--self-hosted-issuer
Förhandsgranskning

Url för lokalt installerad utfärdare för offentliga molnkluster – AKS, GKE, EKS.

--skip-ssl-verification

Hoppa över SSL-verifiering för alla klusteranslutningar.

Standardvärde: False
--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--tags

Blankstegsavgränsade taggar: key[=value] [key[=value] ...]. Använd "" för att rensa befintliga taggar.

--yes -y

Fråga inte efter bekräftelse.

Standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az connectedk8s upgrade

Atomiskt uppgradera registrerade agenter till den specifika versionen eller standardvärdet för den senaste versionen.

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

Exempel

Uppgradera agenterna till den senaste versionen

az connectedk8s upgrade -g resourceGroupName -n connectedClusterName

Uppgradera agenterna till en viss version

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

Uppgradera agenterna med anpassad tidsgräns för uppgradering.

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

Valfria parametrar

--agent-version

Version av agenten som helm-diagrammen ska uppdateras till.

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--kube-config

Sökväg till kube-konfigurationsfilen.

--kube-context

Kubconfig-kontext från den aktuella datorn.

--name -n

Namnet på det anslutna klustret.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--skip-ssl-verification

Hoppa över SSL-verifiering för alla klusteranslutningar.

Standardvärde: False
--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--upgrade-timeout

Tid som krävs (i sekunder) för att arc-agent-poddarna ska uppgraderas i kubernetes-klustret. Åsidosätt det här värdet om maskinvaru-/nätverksbegränsningarna i klustret kräver mer tid för att uppgradera arc-agent-poddarna.

Standardvärde: 600
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.