Udostępnij przez

az connectedk8s

Note

Ta dokumentacja jest częścią rozszerzenia connectedk8s dla interfejsu wiersza polecenia platformy Azure (wersja 2.70.0 lub nowsza). Rozszerzenie zostanie automatycznie zainstalowane przy pierwszym uruchomieniu polecenia az connectedk8s . Dowiedz się więcej o rozszerzeniach.

Polecenia do zarządzania połączonymi klastrami kubernetes.

Polecenia

Nazwa Opis Typ Stan
az connectedk8s connect

Dołączanie połączonego klastra Kubernetes do platformy Azure.

 Extension ogólna dostępność
az connectedk8s delete

Usuń połączony klaster kubernetes wraz z połączonymi agentami klastra.

 Extension ogólna dostępność
az connectedk8s disable-features

Wyłącza funkcje selektywne w połączonym klastrze.

 Extension Preview
az connectedk8s enable-features

Włącza funkcje selektywne w połączonym klastrze.

 Extension Preview
az connectedk8s list

Wyświetl listę połączonych klastrów kubernetes.

 Extension ogólna dostępność
az connectedk8s proxy

Uzyskaj dostęp do połączonego klastra kubernetes.

 Extension ogólna dostępność
az connectedk8s show

Pokaż szczegóły połączonego klastra kubernetes.

 Extension ogólna dostępność
az connectedk8s troubleshoot

Przeprowadź testy diagnostyczne w klastrze Kubernetes z obsługą usługi Arc.

 Extension Preview
az connectedk8s update

Aktualizowanie właściwości dołączonego klastra kubernetes z łukiem.

 Extension ogólna dostępność
az connectedk8s upgrade

Niepodzielne uaktualnianie dołączonych agentów do określonej wersji lub domyślnej dla najnowszej wersji.

 Extension ogólna dostępność

az connectedk8s connect

Dołączanie połączonego klastra Kubernetes do platformy Azure.

Klaster Kubernetes do dołączenia jako połączony klaster musi być domyślnym klastrem w narzędziu kubeconfig. Uruchom polecenie kubectl config get-contexts, aby potwierdzić nazwę kontekstu docelowego. Następnie ustaw domyślny kontekst na właściwy klaster, uruchamiając polecenie kubectl config use-context target-cluster-name.

az connectedk8s connect --name
                        --resource-group
                        [--azure-hybrid-benefit {False, NotApplicable, True}]
                        [--config --configuration-settings]
                        [--config-protected --config-protected-settings]
                        [--container-log-path]
                        [--correlation-id]
                        [--custom-ca-cert --proxy-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 --enable-workload-identity {false, true}]
                        [--gateway-resource-id]
                        [--infrastructure {LTSCWindows 10 Enterprise LTSC, Windows 10 Enterprise, Windows 10 Enterprise LTSC 2019, Windows 10 Enterprise LTSC 2021, Windows 10 Enterprise N, Windows 10 Enterprise N LTSC 2019, Windows 10 Enterprise N LTSC 2021, Windows 10 IoT Enterprise, Windows 10 IoT Enterprise LTSC 2019, Windows 10 IoT Enterprise LTSC 2021, Windows 10 Pro, Windows 11 Enterprise, Windows 11 Enterprise N, Windows 11 IoT Enterprise, Windows 11 Pro, Windows Server 2019, Windows Server 2019 Datacenter, Windows Server 2019 Standard, Windows Server 2022, Windows Server 2022 Datacenter, Windows Server 2022 Standard, aws, azure, azure_stack_edge, azure_stack_hci, azure_stack_hub, gcp, generic, vsphere, windows_server}]
                        [--kube-config]
                        [--kube-context]
                        [--location]
                        [--no-wait]
                        [--onboarding-timeout]
                        [--pls-arm-id --private-link-scope-resource-id]
                        [--proxy-http]
                        [--proxy-https]
                        [--proxy-skip-range]
                        [--self-hosted-issuer]
                        [--skip-ssl-verification]
                        [--tags]
                        [--yes]

Przykłady

Dołączanie połączonego klastra kubernetes z domyślnym kontekstem kube config i kube.

az connectedk8s connect -g resourceGroupName -n connectedClusterName

Dołączanie połączonego klastra kubernetes z domyślną konfiguracją kube i kontekstem kube oraz wyłączanie automatycznego uaktualniania agentów arc.

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

Dołączanie połączonego klastra kubernetes przez określenie polecenia kubeconfig i kubecontext.

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

Dołączanie połączonego klastra kubernetes przez określenie serwera proxy https, serwera proxy http, brak ustawień serwera 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

Dołączanie połączonego klastra kubernetes przez określenie serwera proxy https, serwera proxy http, bez serwera proxy z ustawieniami certyfikatu.

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

Dołączanie połączonego klastra Kubernetes z włączoną funkcją łącza prywatnego przez określenie parametrów łącza prywatnego.

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

Dołączanie połączonego klastra kubernetes z niestandardowym limitem czasu dołączania.

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

Dołączanie połączonego klastra Kubernetes z wystawcą oidc i włączonym elementem webhook tożsamości obciążenia.

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

Dołączanie połączonego klastra Kubernetes z włączonym wystawcą oidc przy użyciu adresu URL wystawcy hostowanego samodzielnie dla klastra chmury publicznej.

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

Dołączanie połączonego klastra Kubernetes z włączoną funkcją bramy platformy Azure.

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

Parametry wymagane

--name -n

Nazwa połączonego klastra.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--azure-hybrid-benefit

Flaga włączania/wyłączania funkcji korzyści użycia hybrydowego platformy Azure.

Właściwość Wartość
Dopuszczalne wartości: False, NotApplicable, True
--config --configuration-settings
Wersja zapoznawcza

Ustawienia konfiguracji jako para key=value. Powtórz parametr dla każdego ustawienia. Nie należy tego używać w przypadku wpisów tajnych, ponieważ ta wartość jest zwracana w odpowiedzi.

--config-protected --config-protected-settings
Wersja zapoznawcza

Konfiguracja ustawień chronionych jako para key=value. Powtórz parametr dla każdego ustawienia. Tylko klucz jest zwracany w odpowiedzi, wartość nie jest.

--container-log-path

Zastąpij domyślną ścieżkę dziennika kontenera, aby umożliwić płynne rejestrowanie bitowe.

--correlation-id

Identyfikator GUID używany do wewnętrznego śledzenia źródła dołączania klastra. Nie należy go modyfikować, chyba że jest to zalecane.

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

Ścieżka do pliku certyfikatu dla serwera proxy lub niestandardowego urzędu certyfikacji.

Właściwość Wartość
Grupa parametrów: Proxy Arguments
--custom-locations-oid

Identyfikator OID aplikacji "custom-locations".

--disable-auto-upgrade

Flaga wyłączania automatycznego uaktualniania agentów arc.

Właściwość Wartość
Domyślna wartość: False
--distribution

Dystrybucja Kubernetes, która będzie działać w tym połączonym klastrze.

Właściwość Wartość
Domyślna wartość: generic
Dopuszczalne wartości: 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

Wersja dystrybucji rozwiązania Kubernetes połączonego klastra.

--enable-oidc-issuer
Wersja zapoznawcza

Włącz tworzenie adresu URL wystawcy OIDC używanego na potrzeby federacji tożsamości obciążenia.

Właściwość Wartość
Grupa parametrów: Workload Identity Arguments
Domyślna wartość: False
Dopuszczalne wartości: false, true
--enable-private-link
Wersja zapoznawcza

Flaga włączania/wyłączania obsługi łącza prywatnego w połączonym zasobie klastra. Dozwolone wartości: false, true.

Właściwość Wartość
Grupa parametrów: PrivateLink Arguments
Dopuszczalne wartości: false, true
--enable-wi --enable-workload-identity
Wersja zapoznawcza

Włącz element webhook tożsamości obciążenia.

Właściwość Wartość
Grupa parametrów: Workload Identity Arguments
Domyślna wartość: False
Dopuszczalne wartości: false, true
--gateway-resource-id
Wersja zapoznawcza

ArmID zasobu bramy usługi Arc.

Właściwość Wartość
Grupa parametrów: Gateway Arguments
--infrastructure

Infrastruktura, w której będzie uruchomiony klaster Kubernetes reprezentowany przez ten połączony klaster.

Właściwość Wartość
Domyślna wartość: generic
Dopuszczalne wartości: 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

Ścieżka do pliku konfiguracji kube.

--kube-context

Kontekst kubconfig z bieżącej maszyny.

--location -l

Location. Wartości z: az account list-locations. Lokalizację domyślną można skonfigurować przy użyciu polecenia az configure --defaults location=<location>.

--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

Właściwość Wartość
Grupa parametrów: Timeout Arguments
Domyślna wartość: False
--onboarding-timeout

Czas wymagany (w sekundach) dla zasobników agenta arc do zainstalowania w klastrze kubernetes. Zastąpi tę wartość, jeśli ograniczenia sprzętu/sieci w klastrze wymagają więcej czasu na zainstalowanie zasobników arc-agent.

Właściwość Wartość
Grupa parametrów: Timeout Arguments
Domyślna wartość: 1200
--pls-arm-id --private-link-scope-resource-id
Wersja zapoznawcza

Identyfikator zasobu usługi ARM zasobu zakresu łącza prywatnego, z którym jest skojarzony ten połączony klaster.

Właściwość Wartość
Grupa parametrów: PrivateLink Arguments
--proxy-http

Adres URL serwera proxy http do użycia.

Właściwość Wartość
Grupa parametrów: Proxy Arguments
--proxy-https

Adres URL serwera proxy https do użycia.

Właściwość Wartość
Grupa parametrów: Proxy Arguments
--proxy-skip-range

Lista adresów URL/ciDR, dla których serwer proxy nie powinien być używany.

Właściwość Wartość
Grupa parametrów: Proxy Arguments
--self-hosted-issuer
Wersja zapoznawcza

Adres URL wystawcy własnego dla klastrów chmury publicznej — AKS, GKE, EKS.

Właściwość Wartość
Grupa parametrów: Workload Identity Arguments
--skip-ssl-verification

Pomiń weryfikację protokołu SSL dla dowolnego połączenia klastra.

Właściwość Wartość
Domyślna wartość: False
--tags

Tagi rozdzielone spacjami: klucz[=wartość] [key[=value] ...]. Użyj ciągu "", aby wyczyścić istniejące tagi.

--yes -y

Nie monituj o potwierdzenie.

Właściwość Wartość
Domyślna wartość: False
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az connectedk8s delete

Usuń połączony klaster kubernetes wraz z połączonymi agentami klastra.

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

Przykłady

Usuń połączony klaster Kubernetes i połączonych agentów klastra przy użyciu domyślnego polecenia kubeconfig i kubecontext.

az connectedk8s delete -g resourceGroupName -n connectedClusterName

Usuń połączony klaster kubernetes, określając klaster kubeconfig i kubecontext na potrzeby usuwania połączonych agentów klastra.

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

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--force

Wymuś usunięcie, aby usunąć wszystkie zasoby azure-arc z klastra.

Właściwość Wartość
Domyślna wartość: False
--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być kompletny identyfikator zasobu, zawierający wszystkie informacje dotyczące argumentów „Identyfikator zasobu”. Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--kube-config

Ścieżka do pliku konfiguracji kube.

--kube-context

Kontekst kubconfig z bieżącej maszyny.

--name -n

Nazwa połączonego klastra.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

Właściwość Wartość
Domyślna wartość: False
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--skip-ssl-verification

Pomiń weryfikację protokołu SSL dla dowolnego połączenia klastra.

Właściwość Wartość
Domyślna wartość: False
--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--yes -y

Nie monituj o potwierdzenie.

Właściwość Wartość
Domyślna wartość: False
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az connectedk8s disable-features

Wersja zapoznawcza

To polecenie jest w wersji zapoznawczej i jest opracowywane. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Wyłącza funkcje selektywne w połączonym klastrze.

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

Przykłady

Wyłącza funkcję azure-rbac.

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

Wyłącz wiele funkcji.

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

Parametry wymagane

--features

Rozdzielona spacjami lista funkcji, które chcesz wyłączyć.

Właściwość Wartość
Dopuszczalne wartości: azure-rbac, cluster-connect, custom-locations

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być kompletny identyfikator zasobu, zawierający wszystkie informacje dotyczące argumentów „Identyfikator zasobu”. Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--kube-config

Ścieżka do pliku konfiguracji kube.

--kube-context

Kontekst kubconfig z bieżącej maszyny.

--name -n

Nazwa połączonego klastra.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--skip-ssl-verification

Pomiń weryfikację protokołu SSL dla dowolnego połączenia klastra.

Właściwość Wartość
Domyślna wartość: False
--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--yes -y

Nie monituj o potwierdzenie.

Właściwość Wartość
Domyślna wartość: False
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az connectedk8s enable-features

Wersja zapoznawcza

To polecenie jest w wersji zapoznawczej i jest opracowywane. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Włącza funkcje selektywne w połączonym klastrze.

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]

Przykłady

Włącza funkcję Cluster-Connect.

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

Włącz funkcję RBAC platformy Azure.

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

Włącz wiele funkcji.

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

Parametry wymagane

--features

Rozdzielona spacjami lista funkcji, które chcesz włączyć.

Właściwość Wartość
Dopuszczalne wartości: azure-rbac, cluster-connect, custom-locations

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--custom-locations-oid

Identyfikator OID aplikacji "custom-locations".

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być kompletny identyfikator zasobu, zawierający wszystkie informacje dotyczące argumentów „Identyfikator zasobu”. Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--kube-config

Ścieżka do pliku konfiguracji kube.

--kube-context

Kontekst kubconfig z bieżącej maszyny.

--name -n

Nazwa połączonego klastra.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--skip-azure-rbac-list

Rozdzielona przecinkami lista nazw nazw użytkowników/adresu e-mail/identyfikatora. Kontrola dostępu oparta na rolach platformy Azure zostanie pominięta dla tych użytkowników. Określ podczas włączania polecenia azure-rbac.

Właściwość Wartość
Grupa parametrów: Azure RBAC Arguments
--skip-ssl-verification

Pomiń weryfikację protokołu SSL dla dowolnego połączenia klastra.

Właściwość Wartość
Domyślna wartość: False
--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az connectedk8s list

Wyświetl listę połączonych klastrów kubernetes.

az connectedk8s list [--resource-group]

Przykłady

Wyświetl listę wszystkich połączonych klastrów kubernetes w grupie zasobów.

az connectedk8s list -g resourceGroupName --subscription subscriptionName

Wyświetl listę wszystkich połączonych klastrów kubernetes w subskrypcji.

az connectedk8s list --subscription subscriptionName

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az connectedk8s proxy

Uzyskaj dostęp do połączonego klastra kubernetes.

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

Przykłady

Uzyskaj dostęp do połączonego klastra kubernetes.

az connectedk8s proxy -n clusterName -g resourceGroupName

Uzyskiwanie dostępu do połączonego klastra kubernetes przy użyciu portu niestandardowego

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

Uzyskiwanie dostępu do połączonego klastra Kubernetes przy użyciu tokenu konta usługi

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

Uzyskiwanie dostępu do połączonego klastra kubernetes przez określenie niestandardowej lokalizacji kubeconfig

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

Uzyskiwanie dostępu do połączonego klastra kubernetes przez określenie kontekstu niestandardowego

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

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--file -f

Plik konfiguracji platformy Kubernetes do aktualizacji. Jeśli nie zostanie podana, zaktualizuje plik "~/.kube/config". Zamiast tego użyj polecenia "-", aby wydrukować kod YAML w pliku stdout.

Właściwość Wartość
Domyślna wartość: ~\.kube\config
--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być kompletny identyfikator zasobu, zawierający wszystkie informacje dotyczące argumentów „Identyfikator zasobu”. Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--kube-context

Jeśli zostanie określona, zastąp domyślną nazwę kontekstu.

--name -n

Nazwa połączonego klastra.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--port

Port używany do uzyskiwania dostępu do połączonego klastra.

Właściwość Wartość
Domyślna wartość: 47011
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--token

Token konta usługi używany do uwierzytelniania w klastrze kubernetes.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az connectedk8s show

Pokaż szczegóły połączonego klastra kubernetes.

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

Przykłady

Pokaż szczegóły połączonego klastra kubernetes

az connectedk8s show -g resourceGroupName -n connectedClusterName

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być kompletny identyfikator zasobu, zawierający wszystkie informacje dotyczące argumentów „Identyfikator zasobu”. Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--name -n

Nazwa połączonego klastra.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az connectedk8s troubleshoot

Wersja zapoznawcza

To polecenie jest w wersji zapoznawczej i jest opracowywane. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Przeprowadź testy diagnostyczne w klastrze Kubernetes z obsługą usługi Arc.

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

Przykłady

Przeprowadź testy diagnostyczne w klastrze Kubernetes z obsługą usługi Arc.

az connectedk8s troubleshoot -n clusterName -g resourceGroupName

Parametry wymagane

--name -n

Nazwa połączonego klastra.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--kube-config

Ścieżka do pliku konfiguracji kube.

--kube-context

Kontekst kubeconfig z bieżącej maszyny.

--skip-ssl-verification

Pomiń weryfikację protokołu SSL dla dowolnego połączenia klastra.

Właściwość Wartość
Domyślna wartość: False
--tags

Tagi rozdzielone spacjami: klucz[=wartość] [key[=value] ...]. Użyj ciągu "", aby wyczyścić istniejące tagi.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az connectedk8s update

Aktualizowanie właściwości dołączonego klastra kubernetes z łukiem.

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

Przykłady

Aktualizowanie wartości serwera proxy dla agentów

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

Wyłączanie ustawień serwera proxy dla agentów

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

Wyłączanie automatycznego uaktualniania agentów

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

Zaktualizuj połączony klaster kubernetes za pomocą wystawcy oidc i włączonego elementu webhook tożsamości obciążenia.

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

Zaktualizuj połączony klaster kubernetes z włączonym wystawcą oidc przy użyciu adresu URL wystawcy hostowanego samodzielnie dla klastra chmury publicznej.

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

Wyłącz element webhook tożsamości obciążenia w połączonym klastrze kubernetes.

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

Zaktualizuj połączony klaster kubernetes z włączoną funkcją bramy platformy Azure.

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

Wyłącz funkcję bramy platformy Azure w połączonym klastrze kubernetes.

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

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--auto-upgrade

Flaga włączania/wyłączania automatycznego uaktualniania agentów arc. Domyślnie automatyczne uaktualnianie agentów jest włączone.

Właściwość Wartość
Dopuszczalne wartości: false, true
--azure-hybrid-benefit

Flaga włączania/wyłączania funkcji korzyści użycia hybrydowego platformy Azure.

Właściwość Wartość
Dopuszczalne wartości: False, NotApplicable, True
--config --configuration-settings
Wersja zapoznawcza

Ustawienia konfiguracji jako para key=value. Powtórz parametr dla każdego ustawienia. Nie należy tego używać w przypadku wpisów tajnych, ponieważ ta wartość jest zwracana w odpowiedzi.

--config-protected --config-protected-settings
Wersja zapoznawcza

Konfiguracja ustawień chronionych jako para key=value. Powtórz parametr dla każdego ustawienia. Tylko klucz jest zwracany w odpowiedzi, wartość nie jest.

--container-log-path

Zastąpij domyślną ścieżkę dziennika kontenera, aby umożliwić płynne rejestrowanie bitowe.

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

Ścieżka do pliku certyfikatu dla serwera proxy lub niestandardowego urzędu certyfikacji.

Właściwość Wartość
Grupa parametrów: Proxy Arguments
--disable-gateway
Wersja zapoznawcza

Flaga wyłączania bramy usługi Arc.

Właściwość Wartość
Grupa parametrów: Gateway Arguments
Domyślna wartość: False
Dopuszczalne wartości: false, true
--disable-proxy

Wyłącza ustawienia serwera proxy dla agentów.

Właściwość Wartość
Grupa parametrów: Proxy Arguments
Domyślna wartość: False
--disable-wi --disable-workload-identity
Wersja zapoznawcza

Wyłącz element webhook tożsamości obciążenia.

Właściwość Wartość
Grupa parametrów: Workload Identity Arguments
Dopuszczalne wartości: false, true
--distribution

Dystrybucja Kubernetes, która będzie działać w tym połączonym klastrze.

Właściwość Wartość
Dopuszczalne wartości: 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

Wersja dystrybucji rozwiązania Kubernetes połączonego klastra.

--enable-oidc-issuer
Wersja zapoznawcza

Włącz tworzenie adresu URL wystawcy OIDC używanego na potrzeby federacji tożsamości obciążenia.

Właściwość Wartość
Grupa parametrów: Workload Identity Arguments
Dopuszczalne wartości: false, true
--enable-wi --enable-workload-identity
Wersja zapoznawcza

Włącz element webhook tożsamości obciążenia.

Właściwość Wartość
Grupa parametrów: Workload Identity Arguments
Dopuszczalne wartości: false, true
--gateway-resource-id
Wersja zapoznawcza

ArmID zasobu bramy usługi Arc.

Właściwość Wartość
Grupa parametrów: Gateway Arguments
--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być kompletny identyfikator zasobu, zawierający wszystkie informacje dotyczące argumentów „Identyfikator zasobu”. Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--kube-config

Ścieżka do pliku konfiguracji kube.

--kube-context

Kontekst kubconfig z bieżącej maszyny.

--name -n

Nazwa połączonego klastra.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--proxy-http

Adres URL serwera proxy http do użycia.

Właściwość Wartość
Grupa parametrów: Proxy Arguments
--proxy-https

Adres URL serwera proxy https do użycia.

Właściwość Wartość
Grupa parametrów: Proxy Arguments
--proxy-skip-range

Lista adresów URL/ciDR, dla których serwer proxy nie powinien być używany.

Właściwość Wartość
Grupa parametrów: Proxy Arguments
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--self-hosted-issuer
Wersja zapoznawcza

Adres URL wystawcy własnego dla klastrów chmury publicznej — AKS, GKE, EKS.

Właściwość Wartość
Grupa parametrów: Workload Identity Arguments
--skip-ssl-verification

Pomiń weryfikację protokołu SSL dla dowolnego połączenia klastra.

Właściwość Wartość
Domyślna wartość: False
--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--tags

Tagi rozdzielone spacjami: klucz[=wartość] [key[=value] ...]. Użyj ciągu "", aby wyczyścić istniejące tagi.

--yes -y

Nie monituj o potwierdzenie.

Właściwość Wartość
Domyślna wartość: False
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az connectedk8s upgrade

Niepodzielne uaktualnianie dołączonych agentów do określonej wersji lub domyślnej dla najnowszej wersji.

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

Przykłady

Uaktualnianie agentów do najnowszej wersji

az connectedk8s upgrade -g resourceGroupName -n connectedClusterName

Uaktualnianie agentów do określonej wersji

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

Uaktualnij agentów przy użyciu limitu czasu uaktualniania niestandardowego.

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

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--agent-version

Wersja agenta w celu zaktualizowania wykresów helm do programu .

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być kompletny identyfikator zasobu, zawierający wszystkie informacje dotyczące argumentów „Identyfikator zasobu”. Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--kube-config

Ścieżka do pliku konfiguracji kube.

--kube-context

Kontekst kubconfig z bieżącej maszyny.

--name -n

Nazwa połączonego klastra.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--skip-ssl-verification

Pomiń weryfikację protokołu SSL dla dowolnego połączenia klastra.

Właściwość Wartość
Domyślna wartość: False
--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--upgrade-timeout

Czas wymagany (w sekundach) dla zasobników agenta arc do uaktualnienia w klastrze kubernetes. Zastąpi tę wartość, jeśli ograniczenia sprzętu/sieci w klastrze wymagają więcej czasu na uaktualnienie zasobników agenta arc.

Właściwość Wartość
Domyślna wartość: 600
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False