az connectedk8s

Notitie

Deze referentie maakt deel uit van de connectedk8s-extensie voor Azure CLI en vereist versie 2.16.0 of hoger. De extensie wordt automatisch geïnstalleerd wanneer u de eerste keer een opdracht az connectedk8s hebt uitgevoerd. Meer informatie over extensies.

Opdrachten voor het beheren van verbonden Kubernetes-clusters.

Opdracht

az connectedk8s connect

Onboard een verbonden Kubernetes-cluster naar Azure.

az connectedk8s delete

Verwijder een verbonden Kubernetes-cluster samen met verbonden clusteragents.

az connectedk8s disable-features

Hiermee schakelt u de selectieve functies op het verbonden cluster uit.

az connectedk8s enable-features

Hiermee schakelt u de selectieve functies op het verbonden cluster in.

az connectedk8s list

Lijst met verbonden Kubernetes-clusters.

az connectedk8s proxy

Toegang krijgen tot een verbonden Kubernetes-cluster.

az connectedk8s show

Details van een verbonden Kubernetes-cluster tonen.

az connectedk8s update

Werk de eigenschappen van de onboardingagents bij.

az connectedk8s upgrade

Werk onboardingagents atomisch bij naar de specifieke versie of standaard naar de nieuwste versie.

az connectedk8s connect

Onboard een verbonden Kubernetes-cluster naar Azure.

az connectedk8s connect --name
                        --resource-group
                        [--custom-locations-oid]
                        [--disable-auto-upgrade]
                        [--distribution {aks, aks_engine, aks_management, aks_workload, auto, capz, eks, generic, gke, k3s, kind, minikube, openshift, rancher_rke, tkg}]
                        [--infrastructure {auto, aws, azure, azure_stack_edge, azure_stack_hci, azure_stack_hub, gcp, generic, vsphere, windows_server}]
                        [--kube-config]
                        [--kube-context]
                        [--location]
                        [--no-wait]
                        [--proxy-cert]
                        [--proxy-http]
                        [--proxy-https]
                        [--proxy-skip-range]
                        [--tags]

Voorbeelden

Onboard een verbonden kubernetes-cluster met standaard kube config- en kube-context.

az connectedk8s connect -g resourceGroupName -n connectedClusterName

Onboard een verbonden kubernetes-cluster met standaard kube config- en kube-context en het uitschakelen van automatische upgrade van Arc-agents.

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

Onboard een verbonden kubernetes-cluster door de kubeconfig en kubecontext op te geven.

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

Onboard een verbonden Kubernetes-cluster door de https-proxy, HTTP-proxy, geen proxyinstellingen op te geven.

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

Onboard een verbonden Kubernetes-cluster door de https-proxy, http-proxy, geen proxy met certificaatinstellingen op te geven.

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

Vereiste parameters

--name -n

De naam van het verbonden cluster.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

Optionele parameters

--custom-locations-oid

OID van de app 'aangepaste locaties'.

--disable-auto-upgrade

Vlag om automatische upgrade van Arc-agents uit te schakelen.

--distribution

De Kubernetes-distributie die wordt uitgevoerd op dit verbonden cluster.

geaccepteerde waarden: aks, aks_engine, aks_management, aks_workload, auto, capz, eks, generic, gke, k3s, kind, minikube, openshift, rancher_rke, tkg
standaardwaarde: auto
--infrastructure

De infrastructuur waarop het Kubernetes-cluster wordt vertegenwoordigd door dit verbonden cluster, wordt uitgevoerd.

geaccepteerde waarden: auto, aws, azure, azure_stack_edge, azure_stack_hci, azure_stack_hub, gcp, generic, vsphere, windows_server
standaardwaarde: auto
--kube-config

Pad naar het kube-configuratiebestand.

--kube-context

Kubconfig-context van de huidige machine.

--location -l

Locatie. Waarden van: az account list-locations . U kunt de standaardlocatie configureren met az configure --defaults location=<location> behulp van .

--no-wait

Wacht niet tot de langlopende bewerking is uitgevoerd.

--proxy-cert

Pad naar het certificaatbestand voor proxy.

--proxy-http

Te gebruiken HTTP-proxy-URL.

--proxy-https

Te gebruiken HTTPS-proxy-URL.

--proxy-skip-range

Lijst met URL's/CIDR's waarvoor de proxy niet moet worden gebruikt.

--tags

Door spatie gescheiden tags: sleutel[=waarde] [sleutel[=waarde] ...]. Gebruik '' om bestaande tags te verwijderen.

az connectedk8s delete

Verwijder een verbonden Kubernetes-cluster samen met verbonden clusteragents.

az connectedk8s delete --name
                       --resource-group
                       [--kube-config]
                       [--kube-context]
                       [--no-wait]
                       [--yes]

Voorbeelden

Verwijder een verbonden kubernetes-cluster en verbonden clusteragents met standaard kubeconfig en kubecontext.

az connectedk8s delete -g resourceGroupName -n connectedClusterName

Verwijder een verbonden kubernetes-cluster door kubeconfig en kubecontext op te geven voor het verwijderen van verbonden clusteragents.

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

Vereiste parameters

--name -n

De naam van het verbonden cluster.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

Optionele parameters

--kube-config

Pad naar het kube-configuratiebestand.

--kube-context

Kubconfig-context van de huidige machine.

--no-wait

Wacht niet tot de langlopende bewerking is uitgevoerd.

--yes -y

Niet vragen om bevestiging.

az connectedk8s disable-features

Hiermee schakelt u de selectieve functies op het verbonden cluster uit.

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

Voorbeelden

Hiermee schakelt u de functie azure-rbac uit.

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

Schakel meerdere functies uit.

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

Vereiste parameters

--features

Door spaties gescheiden lijst met functies die u wilt uitschakelen.

geaccepteerde waarden: azure-rbac, cluster-connect, custom-locations
--name -n

De naam van het verbonden cluster.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

Optionele parameters

--kube-config

Pad naar het kube-configuratiebestand.

--kube-context

Kubconfig-context van de huidige machine.

--yes -y

Niet vragen om bevestiging.

az connectedk8s enable-features

Hiermee schakelt u de selectieve functies op het verbonden cluster in.

az connectedk8s enable-features --features {azure-rbac, cluster-connect, custom-locations}
                                --name
                                --resource-group
                                [--app-id]
                                [--app-secret]
                                [--custom-locations-oid]
                                [--kube-config]
                                [--kube-context]
                                [--skip-azure-rbac-list]

Voorbeelden

Hiermee schakelt u Cluster-Connect functie in.

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

Azure RBAC-functie inschakelen.

az connectedk8s enable-features -n clusterName -g resourceGroupName --features azure-rbac --app-id appID --app-secret="appSecret" --skip-azure-rbac-list "user1@domain.com,spn_oid"

Schakel meerdere functies in.

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

Vereiste parameters

--features

Door spaties gescheiden lijst met functies die u wilt inschakelen.

geaccepteerde waarden: azure-rbac, cluster-connect, custom-locations
--name -n

De naam van het verbonden cluster.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

Optionele parameters

--app-id

Toepassings-id voor het inschakelen van Azure RBAC. Geef op bij het inschakelen van azure-rbac.

--app-secret

Toepassingsgeheim voor het inschakelen van Azure RBAC. Geef op bij het inschakelen van azure-rbac.

--custom-locations-oid

OID van de app 'aangepaste locaties'.

--kube-config

Pad naar het kube-configuratiebestand.

--kube-context

Kubconfig-context van de huidige machine.

--skip-azure-rbac-list

Door komma's gescheiden lijst met namen van gebruikersnamen/e-mail/oid. Azure RBAC wordt overgeslagen voor deze gebruikers. Geef op bij het inschakelen van azure-rbac.

az connectedk8s list

Lijst met verbonden Kubernetes-clusters.

az connectedk8s list [--resource-group]

Voorbeelden

Vermeld alle verbonden Kubernetes-clusters in een resourcegroep.

az connectedk8s list -g resourceGroupName --subscription subscriptionName

Vermeld alle verbonden Kubernetes-clusters in een abonnement.

az connectedk8s list --subscription subscriptionName

Optionele parameters

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

az connectedk8s proxy

Toegang krijgen tot een verbonden Kubernetes-cluster.

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

Voorbeelden

Toegang krijgen tot een verbonden Kubernetes-cluster.

az connectedk8s proxy -n clusterName -g resourceGroupName

Toegang krijgen tot een verbonden Kubernetes-cluster met aangepaste poort

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

Toegang krijgen tot een verbonden Kubernetes-cluster met serviceaccounttoken

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

Toegang krijgen tot een verbonden Kubernetes-cluster door een aangepaste kubeconfig-locatie op te geven

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

Toegang krijgen tot een verbonden Kubernetes-cluster door aangepaste context op te geven

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

Vereiste parameters

--name -n

De naam van het verbonden cluster.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

Optionele parameters

--file -f

Kubernetes-configuratiebestand dat moet worden bijgewerkt. Als dit niet wordt opgegeven, wordt het bestand '~/.kube/config' bijgewerkt. Gebruik in plaats daarvan '-' om YAML naar stdout af te drukken.

standaardwaarde: ~/.kube/config
--kube-context

Als dit is opgegeven, overschrijft u de standaardcontextnaam.

--port

Poort die wordt gebruikt voor toegang tot het verbonden cluster.

standaardwaarde: 47011
--token

Serviceaccounttoken dat moet worden gebruikt voor verificatie bij het kubernetes-cluster.

az connectedk8s show

Details van een verbonden Kubernetes-cluster tonen.

az connectedk8s show --name
                     --resource-group

Voorbeelden

De details voor een verbonden Kubernetes-cluster tonen

az connectedk8s show -g resourceGroupName -n connectedClusterName

Vereiste parameters

--name -n

De naam van het verbonden cluster.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

az connectedk8s update

Werk de eigenschappen van de onboardingagents bij.

az connectedk8s update --name
                       --resource-group
                       [--auto-upgrade {false, true}]
                       [--disable-proxy]
                       [--kube-config]
                       [--kube-context]
                       [--proxy-cert]
                       [--proxy-http]
                       [--proxy-https]
                       [--proxy-skip-range]

Voorbeelden

Proxywaarden voor de agents bijwerken

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

Proxy-instellingen voor agents uitschakelen

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

Automatische upgrade van agents uitschakelen

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

Vereiste parameters

--name -n

De naam van het verbonden cluster.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

Optionele parameters

--auto-upgrade

Vlag voor het in-/uitschakelen van automatische upgrade van Arc-agents. Automatische upgrade van agents is standaard ingeschakeld.

geaccepteerde waarden: false, true
--disable-proxy

Hiermee schakelt u proxy-instellingen voor agents uit.

--kube-config

Pad naar het kube-configuratiebestand.

--kube-context

Kubconfig-context van de huidige machine.

--proxy-cert

Pad naar het certificaatbestand voor proxy.

--proxy-http

Te gebruiken HTTP-proxy-URL.

--proxy-https

Te gebruiken HTTPS-proxy-URL.

--proxy-skip-range

Lijst met URL's/CIDR's waarvoor de proxy niet moet worden gebruikt.

az connectedk8s upgrade

Werk onboardingagents atomisch bij naar de specifieke versie of standaard naar de nieuwste versie.

az connectedk8s upgrade --name
                        --resource-group
                        [--agent-version]
                        [--kube-config]
                        [--kube-context]

Voorbeelden

De agents upgraden naar de nieuwste versie

az connectedk8s upgrade -g resourceGroupName -n connectedClusterName

De agents upgraden naar een specifieke versie

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

Vereiste parameters

--name -n

De naam van het verbonden cluster.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

Optionele parameters

--agent-version

Versie van de agent om de Helm-grafieken naar bij te werken.

--kube-config

Pad naar het kube-configuratiebestand.

--kube-context

Kubconfig-context van de huidige machine.