Sdílet prostřednictvím

az connectedk8s

Note

Tento odkaz je součástí rozšíření Connectedk8s pro Azure CLI (verze 2.70.0 nebo vyšší). Rozšíření se automaticky nainstaluje při prvním spuštění příkazu az connectedk8s . Přečtěte si další informace o rozšířeních.

Příkazy pro správu připojených clusterů Kubernetes

Příkazy

Name Description Typ Stav
az connectedk8s connect

Připojení připojeného clusteru Kubernetes k Azure

 Extension GA
az connectedk8s delete

Odstraňte připojený cluster Kubernetes spolu s připojenými agenty clusteru.

 Extension GA
az connectedk8s disable-features

Zakáže selektivní funkce v připojeném clusteru.

 Extension Preview
az connectedk8s enable-features

Povolí selektivní funkce v připojeném clusteru.

 Extension Preview
az connectedk8s list

Výpis připojených clusterů Kubernetes

 Extension GA
az connectedk8s proxy

Získejte přístup k připojenému clusteru Kubernetes.

 Extension GA
az connectedk8s show

Zobrazení podrobností o připojeném clusteru Kubernetes

 Extension GA
az connectedk8s troubleshoot

Proveďte diagnostické kontroly v clusteru Kubernetes s podporou Arc.

 Extension Preview
az connectedk8s update

Aktualizujte vlastnosti onboardovaného clusteru Kubernetes s obloukem.

 Extension GA
az connectedk8s upgrade

Agenti, kteří jsou nasazeni atomicky, upgradujte na konkrétní verzi nebo na nejnovější verzi.

 Extension GA

az connectedk8s connect

Připojení připojeného clusteru Kubernetes k Azure

Cluster Kubernetes, který se má připojit jako připojený cluster, musí být výchozím clusterem v kubeconfigu. Spuštěním příkazu kubectl config get-contexts potvrďte název cílového kontextu. Potom nastavte výchozí kontext na správný cluster spuštěním příkazu 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]

Příklady

Připojení připojeného clusteru Kubernetes s výchozí konfigurací kube a kontextem kube

az connectedk8s connect -g resourceGroupName -n connectedClusterName

Připojení připojeného clusteru Kubernetes s výchozí konfigurací kube a kontextem kube a zakázáním automatického upgradu agentů Arc

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

Připojení připojeného clusteru Kubernetes zadáním kubeconfig a kubecontextu

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

Připojení připojeného clusteru Kubernetes zadáním proxy serveru https, proxy serveru HTTP bez nastavení proxy serveru.

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

Připojení připojeného clusteru Kubernetes zadáním proxy serveru https, proxy serveru HTTP, bez proxy serveru s nastavením certifikátu

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

Připojení připojeného clusteru Kubernetes s povolenou funkcí privátního propojení zadáním parametrů privátního propojení

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

Onboarding připojeného clusteru Kubernetes s vlastním vypršením časového limitu onboardingu

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

Připojení připojeného clusteru Kubernetes s vystavitelem oidc a povoleným webhookem identity úloh

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

Připojení připojeného clusteru Kubernetes s povoleným vystavitelem oidc pomocí adresy URL vystavitele v místním prostředí pro cluster veřejného cloudu

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

Připojení připojeného clusteru Kubernetes s povolenou funkcí služby Azure Gateway

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

Povinné parametry

--name -n

Název připojeného clusteru.

--resource-group -g

Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--azure-hybrid-benefit

Příznak pro povolení nebo zakázání funkce Zvýhodněné hybridní využití Azure

Vlastnost Hodnota
Přípustné hodnoty: False, NotApplicable, True
--config --configuration-settings
Preview

Nastavení konfigurace jako pár klíč=hodnota Opakujte parametr pro každé nastavení. Nepoužívejte tuto hodnotu pro tajné kódy, protože tato hodnota je vrácena v odpovědi.

--config-protected --config-protected-settings
Preview

Configuration Protected Settings as key=value pair. Opakujte parametr pro každé nastavení. V odpovědi se vrátí pouze klíč, hodnota není.

--container-log-path

Přepište výchozí cestu protokolu kontejneru, aby se povolilo protokolování fluent-bit.

--correlation-id

Identifikátor GUID, který se používá k internímu sledování zdroje onboardingu clusteru. Neupravujte ho prosím, pokud to nedoporučujeme.

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

Cesta k souboru certifikátu pro proxy server nebo vlastní certifikační autoritu

Vlastnost Hodnota
Skupina parametrů: Proxy Arguments
--custom-locations-oid

Identifikátor objektu "custom-locations" aplikace.

--disable-auto-upgrade

Příznak pro zakázání automatického upgradu agentů arc

Vlastnost Hodnota
Default value: False
--distribution

Distribuce Kubernetes, která bude spuštěná v tomto připojeném clusteru.

Vlastnost Hodnota
Default value: generic
Přípustné hodnoty: 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

Verze distribuce Kubernetes připojeného clusteru.

--enable-oidc-issuer
Preview

Povolte vytvoření adresy URL vystavitele OIDC používané pro federaci identit úloh.

Vlastnost Hodnota
Skupina parametrů: Workload Identity Arguments
Default value: False
Přípustné hodnoty: false, true
--enable-private-link
Preview

Příznak pro povolení nebo zakázání podpory privátního propojení u připojeného prostředku clusteru Povolené hodnoty: false, true.

Vlastnost Hodnota
Skupina parametrů: PrivateLink Arguments
Přípustné hodnoty: false, true
--enable-wi --enable-workload-identity
Preview

Povolte webhook identity úloh.

Vlastnost Hodnota
Skupina parametrů: Workload Identity Arguments
Default value: False
Přípustné hodnoty: false, true
--gateway-resource-id
Preview

ARMID prostředku služby Arc Gateway.

Vlastnost Hodnota
Skupina parametrů: Gateway Arguments
--infrastructure

Infrastruktura, ve které bude cluster Kubernetes reprezentovaný tímto připojeným clusterem spuštěný.

Vlastnost Hodnota
Default value: generic
Přípustné hodnoty: 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

Cesta ke konfiguračnímu souboru kube.

--kube-context

Kontext Kubconfig z aktuálního počítače

--location -l

Location. Hodnoty z: az account list-locations. Výchozí umístění můžete nakonfigurovat pomocí .az configure --defaults location=<location>

--no-wait

Nečekejte na dokončení dlouhotrvající operace.

Vlastnost Hodnota
Skupina parametrů: Timeout Arguments
Default value: False
--onboarding-timeout

Doba potřebná (v sekundách) pro instalaci podů agenta arc do clusteru Kubernetes. Tuto hodnotu přepište, pokud omezení hardwaru nebo sítě v clusteru vyžadují více času pro instalaci podů arc-agent.

Vlastnost Hodnota
Skupina parametrů: Timeout Arguments
Default value: 1200
--pls-arm-id --private-link-scope-resource-id
Preview

ID prostředku ARM prostředku oboru privátního propojení, ke kterému je přidružený tento připojený cluster.

Vlastnost Hodnota
Skupina parametrů: PrivateLink Arguments
--proxy-http

Adresu URL proxy serveru HTTP, která se má použít.

Vlastnost Hodnota
Skupina parametrů: Proxy Arguments
--proxy-https

Adresa URL proxy serveru https, která se má použít.

Vlastnost Hodnota
Skupina parametrů: Proxy Arguments
--proxy-skip-range

Seznam adres URL/identifikátorů CIDR, pro které se má proxy server použít.

Vlastnost Hodnota
Skupina parametrů: Proxy Arguments
--self-hosted-issuer
Preview

Adresa URL vystavitele v místním prostředí pro clustery veřejného cloudu – AKS, GKE, EKS.

Vlastnost Hodnota
Skupina parametrů: Workload Identity Arguments
--skip-ssl-verification

Přeskočte ověření SSL pro jakékoli připojení ke clusteru.

Vlastnost Hodnota
Default value: False
--tags

Značky oddělené mezerami: klíč[=hodnota] [klíč[=hodnota] ...]. K vymazání existujících značek použijte "".

--yes -y

Nevyzývejte k potvrzení.

Vlastnost Hodnota
Default value: False
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False

az connectedk8s delete

Odstraňte připojený cluster Kubernetes spolu s připojenými agenty clusteru.

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

Příklady

Odstraňte připojený cluster Kubernetes a připojené agenty clusteru s výchozími příkazy kubeconfig a kubecontext.

az connectedk8s delete -g resourceGroupName -n connectedClusterName

Odstraněním připojeného clusteru Kubernetes zadejte kubeconfig a kubecontext pro odstranění připojených agentů clusteru.

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

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--force

Vynuťte odstranění, abyste z clusteru odebrali všechny prostředky azure-arc.

Vlastnost Hodnota
Default value: False
--ids

Jedno nebo více ID prostředků (oddělené mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat buď argumenty --ids, nebo jiné argumenty 'ID prostředku'.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--kube-config

Cesta ke konfiguračnímu souboru kube.

--kube-context

Kontext Kubconfig z aktuálního počítače

--name -n

Název připojeného clusteru.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--no-wait

Nečekejte na dokončení dlouhotrvající operace.

Vlastnost Hodnota
Default value: False
--resource-group -g

Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--skip-ssl-verification

Přeskočte ověření SSL pro jakékoli připojení ke clusteru.

Vlastnost Hodnota
Default value: False
--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--yes -y

Nevyzývejte k potvrzení.

Vlastnost Hodnota
Default value: False
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False

az connectedk8s disable-features

Preview

Tento příkaz je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Zakáže selektivní funkce v připojeném clusteru.

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

Příklady

Zakáže funkci azure-rbac.

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

Zakažte více funkcí.

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

Povinné parametry

--features

Seznam funkcí oddělených mezerami, které chcete zakázat.

Vlastnost Hodnota
Přípustné hodnoty: azure-rbac, cluster-connect, custom-locations

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--ids

Jedno nebo více ID prostředků (oddělené mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat buď argumenty --ids, nebo jiné argumenty 'ID prostředku'.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--kube-config

Cesta ke konfiguračnímu souboru kube.

--kube-context

Kontext Kubconfig z aktuálního počítače

--name -n

Název připojeného clusteru.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--resource-group -g

Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--skip-ssl-verification

Přeskočte ověření SSL pro jakékoli připojení ke clusteru.

Vlastnost Hodnota
Default value: False
--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--yes -y

Nevyzývejte k potvrzení.

Vlastnost Hodnota
Default value: False
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False

az connectedk8s enable-features

Preview

Tento příkaz je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Povolí selektivní funkce v připojeném clusteru.

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]

Příklady

Povolí funkci Cluster-Connect.

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

Povolení funkce Azure RBAC

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

Povolte více funkcí.

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

Povinné parametry

--features

Seznam funkcí oddělených mezerami, které chcete povolit.

Vlastnost Hodnota
Přípustné hodnoty: azure-rbac, cluster-connect, custom-locations

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--custom-locations-oid

Identifikátor objektu "custom-locations" aplikace.

--ids

Jedno nebo více ID prostředků (oddělené mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat buď argumenty --ids, nebo jiné argumenty 'ID prostředku'.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--kube-config

Cesta ke konfiguračnímu souboru kube.

--kube-context

Kontext Kubconfig z aktuálního počítače

--name -n

Název připojeného clusteru.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--resource-group -g

Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--skip-azure-rbac-list

Čárkami oddělený seznam jmen uživatelských jmen/ e-mailů/identifikátorů. Azure RBAC se těmto uživatelům přeskočí. Zadejte při povolování azure-rbac.

Vlastnost Hodnota
Skupina parametrů: Azure RBAC Arguments
--skip-ssl-verification

Přeskočte ověření SSL pro jakékoli připojení ke clusteru.

Vlastnost Hodnota
Default value: False
--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False

az connectedk8s list

Výpis připojených clusterů Kubernetes

az connectedk8s list [--resource-group]

Příklady

Zobrazí seznam všech připojených clusterů Kubernetes ve skupině prostředků.

az connectedk8s list -g resourceGroupName --subscription subscriptionName

Zobrazí seznam všech připojených clusterů Kubernetes v předplatném.

az connectedk8s list --subscription subscriptionName

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--resource-group -g

Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False

az connectedk8s proxy

Získejte přístup k připojenému clusteru Kubernetes.

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

Příklady

Získejte přístup k připojenému clusteru Kubernetes.

az connectedk8s proxy -n clusterName -g resourceGroupName

Získání přístupu k připojenému clusteru Kubernetes pomocí vlastního portu

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

Získání přístupu k připojenému clusteru Kubernetes pomocí tokenu účtu služby

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

Získání přístupu k připojenému clusteru Kubernetes zadáním vlastního umístění kubeconfig

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

Získání přístupu k připojenému clusteru Kubernetes zadáním vlastního kontextu

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

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--file -f

Konfigurační soubor Kubernetes, který se má aktualizovat. Pokud není k dispozici, aktualizuje soubor ~/.kube/config. Místo toho použijte "-" k tisku YAML do stdoutu.

Vlastnost Hodnota
Default value: ~\.kube\config
--ids

Jedno nebo více ID prostředků (oddělené mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat buď argumenty --ids, nebo jiné argumenty 'ID prostředku'.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--kube-context

Pokud je zadáno, přepište výchozí název kontextu.

--name -n

Název připojeného clusteru.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--port

Port používaný pro přístup k připojenému clusteru

Vlastnost Hodnota
Default value: 47011
--resource-group -g

Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--token

Token účtu služby, který se použije k ověření v clusteru Kubernetes.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False

az connectedk8s show

Zobrazení podrobností o připojeném clusteru Kubernetes

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

Příklady

Zobrazení podrobností o připojeném clusteru Kubernetes

az connectedk8s show -g resourceGroupName -n connectedClusterName

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--ids

Jedno nebo více ID prostředků (oddělené mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat buď argumenty --ids, nebo jiné argumenty 'ID prostředku'.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--name -n

Název připojeného clusteru.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--resource-group -g

Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False

az connectedk8s troubleshoot

Preview

Tento příkaz je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Proveďte diagnostické kontroly v clusteru Kubernetes s podporou Arc.

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

Příklady

Proveďte diagnostické kontroly v clusteru Kubernetes s podporou Arc.

az connectedk8s troubleshoot -n clusterName -g resourceGroupName

Povinné parametry

--name -n

Název připojeného clusteru.

--resource-group -g

Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--kube-config

Cesta ke konfiguračnímu souboru kube.

--kube-context

Kontext Kubeconfig z aktuálního počítače

--skip-ssl-verification

Přeskočte ověření SSL pro jakékoli připojení ke clusteru.

Vlastnost Hodnota
Default value: False
--tags

Značky oddělené mezerami: klíč[=hodnota] [klíč[=hodnota] ...]. K vymazání existujících značek použijte "".

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False

az connectedk8s update

Aktualizujte vlastnosti onboardovaného clusteru Kubernetes s obloukem.

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]

Příklady

Aktualizace hodnot proxy serveru pro agenty

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

Zakázání nastavení proxy serveru pro agenty

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

Zakázání automatického upgradu agentů

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

Aktualizujte připojený cluster Kubernetes s povoleným vystavitelem oidc a webhookem identity úloh.

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

Aktualizujte připojený cluster Kubernetes s povoleným vystavitelem oidc pomocí adresy URL vystavitele v místním prostředí pro cluster veřejného cloudu.

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

Zakažte webhook identity úloh v připojeném clusteru Kubernetes.

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

Aktualizace připojeného clusteru Kubernetes s povolenou funkcí služby Azure Gateway

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

Zakažte funkci služby Azure Gateway v připojeném clusteru Kubernetes.

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

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--auto-upgrade

Příznak pro povolení nebo zakázání automatického upgradu agentů arc Ve výchozím nastavení je povolený automatický upgrade agentů.

Vlastnost Hodnota
Přípustné hodnoty: false, true
--azure-hybrid-benefit

Příznak pro povolení nebo zakázání funkce Zvýhodněné hybridní využití Azure

Vlastnost Hodnota
Přípustné hodnoty: False, NotApplicable, True
--config --configuration-settings
Preview

Nastavení konfigurace jako pár klíč=hodnota Opakujte parametr pro každé nastavení. Nepoužívejte tuto hodnotu pro tajné kódy, protože tato hodnota je vrácena v odpovědi.

--config-protected --config-protected-settings
Preview

Configuration Protected Settings as key=value pair. Opakujte parametr pro každé nastavení. V odpovědi se vrátí pouze klíč, hodnota není.

--container-log-path

Přepište výchozí cestu protokolu kontejneru, aby se povolilo protokolování fluent-bit.

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

Cesta k souboru certifikátu pro proxy server nebo vlastní certifikační autoritu

Vlastnost Hodnota
Skupina parametrů: Proxy Arguments
--disable-gateway
Preview

Označení příznakem pro zakázání brány Arc

Vlastnost Hodnota
Skupina parametrů: Gateway Arguments
Default value: False
Přípustné hodnoty: false, true
--disable-proxy

Zakáže nastavení proxy serveru pro agenty.

Vlastnost Hodnota
Skupina parametrů: Proxy Arguments
Default value: False
--disable-wi --disable-workload-identity
Preview

Zakažte webhook identity úloh.

Vlastnost Hodnota
Skupina parametrů: Workload Identity Arguments
Přípustné hodnoty: false, true
--distribution

Distribuce Kubernetes, která bude spuštěná v tomto připojeném clusteru.

Vlastnost Hodnota
Přípustné hodnoty: 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

Verze distribuce Kubernetes připojeného clusteru.

--enable-oidc-issuer
Preview

Povolte vytvoření adresy URL vystavitele OIDC používané pro federaci identit úloh.

Vlastnost Hodnota
Skupina parametrů: Workload Identity Arguments
Přípustné hodnoty: false, true
--enable-wi --enable-workload-identity
Preview

Povolte webhook identity úloh.

Vlastnost Hodnota
Skupina parametrů: Workload Identity Arguments
Přípustné hodnoty: false, true
--gateway-resource-id
Preview

ARMID prostředku služby Arc Gateway.

Vlastnost Hodnota
Skupina parametrů: Gateway Arguments
--ids

Jedno nebo více ID prostředků (oddělené mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat buď argumenty --ids, nebo jiné argumenty 'ID prostředku'.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--kube-config

Cesta ke konfiguračnímu souboru kube.

--kube-context

Kontext Kubconfig z aktuálního počítače

--name -n

Název připojeného clusteru.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--proxy-http

Adresu URL proxy serveru HTTP, která se má použít.

Vlastnost Hodnota
Skupina parametrů: Proxy Arguments
--proxy-https

Adresa URL proxy serveru https, která se má použít.

Vlastnost Hodnota
Skupina parametrů: Proxy Arguments
--proxy-skip-range

Seznam adres URL/identifikátorů CIDR, pro které se má proxy server použít.

Vlastnost Hodnota
Skupina parametrů: Proxy Arguments
--resource-group -g

Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--self-hosted-issuer
Preview

Adresa URL vystavitele v místním prostředí pro clustery veřejného cloudu – AKS, GKE, EKS.

Vlastnost Hodnota
Skupina parametrů: Workload Identity Arguments
--skip-ssl-verification

Přeskočte ověření SSL pro jakékoli připojení ke clusteru.

Vlastnost Hodnota
Default value: False
--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--tags

Značky oddělené mezerami: klíč[=hodnota] [klíč[=hodnota] ...]. K vymazání existujících značek použijte "".

--yes -y

Nevyzývejte k potvrzení.

Vlastnost Hodnota
Default value: False
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False

az connectedk8s upgrade

Agenti, kteří jsou nasazeni atomicky, upgradujte na konkrétní verzi nebo na nejnovější verzi.

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

Příklady

Upgrade agentů na nejnovější verzi

az connectedk8s upgrade -g resourceGroupName -n connectedClusterName

Upgrade agentů na konkrétní verzi

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

Upgradujte agenty s časovým limitem vlastního upgradu.

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

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--agent-version

Verze agenta pro aktualizaci chartů Helm na.

--ids

Jedno nebo více ID prostředků (oddělené mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat buď argumenty --ids, nebo jiné argumenty 'ID prostředku'.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--kube-config

Cesta ke konfiguračnímu souboru kube.

--kube-context

Kontext Kubconfig z aktuálního počítače

--name -n

Název připojeného clusteru.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--resource-group -g

Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--skip-ssl-verification

Přeskočte ověření SSL pro jakékoli připojení ke clusteru.

Vlastnost Hodnota
Default value: False
--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--upgrade-timeout

Doba potřebná (v sekundách), než se pody agenta arc upgradují v clusteru Kubernetes. Tuto hodnotu přepište, pokud omezení hardwaru nebo sítě v clusteru vyžadují více času pro upgrade podů agenta arc.

Vlastnost Hodnota
Default value: 600
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False