az connectedk8s

참고

이 참조는 Azure CLI(버전 2.30.0 이상)에 대한 connectedk8s 확장의 일부입니다. az connectedk8s 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장에 대해 자세히 알아보세요.

연결된 kubernetes 클러스터를 관리하는 명령입니다.

명령

az connectedk8s connect

연결된 kubernetes 클러스터를 Azure에 온보딩합니다.

az connectedk8s delete

연결된 클러스터 에이전트와 함께 연결된 kubernetes 클러스터를 삭제합니다.

az connectedk8s disable-features

연결된 클러스터에서 선택적 기능을 사용하지 않도록 설정합니다.

az connectedk8s enable-features

연결된 클러스터에서 선택적 기능을 사용하도록 설정합니다.

az connectedk8s list

연결된 kubernetes 클러스터를 나열합니다.

az connectedk8s proxy

연결된 kubernetes 클러스터에 액세스합니다.

az connectedk8s show

연결된 kubernetes 클러스터의 세부 정보를 표시합니다.

az connectedk8s troubleshoot

Arc 지원 Kubernetes 클러스터에서 진단 검사를 수행합니다.

az connectedk8s update

호 온보딩된 kubernetes 클러스터의 속성을 업데이트합니다.

az connectedk8s upgrade

온보딩된 에이전트를 특정 버전으로 원자성으로 업그레이드하거나 기본값을 최신 버전으로 업그레이드합니다.

az connectedk8s connect

연결된 kubernetes 클러스터를 Azure에 온보딩합니다.

az connectedk8s connect --name
                        --resource-group
                        [--correlation-id]
                        [--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}]
                        [--enable-private-link {false, true}]
                        [--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]
                        [--onboarding-timeout]
                        [--pls-arm-id]
                        [--proxy-cert]
                        [--proxy-http]
                        [--proxy-https]
                        [--proxy-skip-range]
                        [--tags]

예제

기본 kube 구성 및 kube 컨텍스트를 사용하여 연결된 kubernetes 클러스터를 온보딩합니다.

az connectedk8s connect -g resourceGroupName -n connectedClusterName

기본 kube 구성 및 kube 컨텍스트를 사용하여 연결된 kubernetes 클러스터를 온보딩하고 arc 에이전트의 자동 업그레이드를 사용하지 않도록 설정합니다.

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

kubeconfig 및 kubecontext를 지정하여 연결된 kubernetes 클러스터를 온보딩합니다.

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

https 프록시, http 프록시, 프록시 설정 없음을 지정하여 연결된 kubernetes 클러스터를 온보딩합니다.

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

https 프록시, http 프록시, 인증서 설정이 있는 프록시를 지정하여 연결된 kubernetes 클러스터를 온보딩합니다.

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

프라이빗 링크 매개 변수를 지정하여 프라이빗 링크 기능을 사용하도록 설정된 연결된 kubernetes 클러스터를 온보딩합니다.

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

사용자 지정 온보딩 시간 제한을 사용하여 연결된 kubernetes 클러스터를 온보딩합니다.

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

필수 매개 변수

--name -n

연결된 클러스터의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--correlation-id

클러스터 온보딩의 원본을 내부적으로 추적하는 데 사용되는 GUID입니다. 권장되지 않는 한 수정하지 마십시오.

--custom-locations-oid

'custom-locations' 앱의 OID입니다.

--disable-auto-upgrade

Arc 에이전트의 자동 업그레이드를 사용하지 않도록 설정하는 플래그입니다.

--distribution

이 연결된 클러스터에서 실행될 Kubernetes 배포입니다.

허용되는 값: aks, aks_engine, aks_management, aks_workload, auto, capz, eks, generic, gke, k3s, kind, minikube, openshift, rancher_rke, tkg
기본값: auto
--enable-private-link

연결된 클러스터 리소스에서 프라이빗 링크 지원을 사용하거나 사용하지 않도록 설정하는 플래그입니다. 허용되는 값: true, false

허용되는 값: false, true
--infrastructure

이 연결된 클러스터가 나타내는 Kubernetes 클러스터가 실행될 인프라입니다.

허용되는 값: auto, aws, azure, azure_stack_edge, azure_stack_hci, azure_stack_hub, gcp, generic, vsphere, windows_server
기본값: auto
--kube-config

kube 구성 파일의 경로입니다.

--kube-context

현재 컴퓨터의 Kubconfig 컨텍스트입니다.

--location -l

위치입니다. 값 출처: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.

--no-wait

장기 실행 작업이 완료될 때까지 기다리지 마세요.

--onboarding-timeout

arc-agent Pod를 kubernetes 클러스터에 설치하는 데 필요한 시간(초)입니다. 클러스터의 하드웨어/네트워크 제약 조건에 따라 arc-agent Pod를 설치하는 데 더 많은 시간이 필요한 경우 이 값을 재정의합니다.

기본값: 600
--pls-arm-id --private-link-scope-resource-id

이 연결된 클러스터가 연결된 프라이빗 링크 범위 리소스의 ARM 리소스 ID입니다.

--proxy-cert

프록시에 대한 인증서 파일의 경로입니다.

--proxy-http

사용할 Http 프록시 URL입니다.

--proxy-https

사용할 Https 프록시 URL입니다.

--proxy-skip-range

프록시를 사용하지 않아야 하는 URL/CIDR 목록입니다.

--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

az connectedk8s delete

연결된 클러스터 에이전트와 함께 연결된 kubernetes 클러스터를 삭제합니다.

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

예제

기본 kubeconfig 및 kubecontext를 사용하여 연결된 kubernetes 클러스터 및 연결된 클러스터 에이전트를 삭제합니다.

az connectedk8s delete -g resourceGroupName -n connectedClusterName

연결된 클러스터 에이전트 삭제에 대한 kubeconfig 및 kubecontext를 지정하여 연결된 kubernetes 클러스터를 삭제합니다.

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

필수 매개 변수

--name -n

연결된 클러스터의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--force

클러스터에서 모든 azure-arc 리소스를 제거하려면 강제로 삭제합니다.

--kube-config

kube 구성 파일의 경로입니다.

--kube-context

현재 컴퓨터의 Kubconfig 컨텍스트입니다.

--no-wait

장기 실행 작업이 완료될 때까지 기다리지 마세요.

--yes -y

확인을 묻는 메시지를 표시하지 마세요.

az connectedk8s disable-features

연결된 클러스터에서 선택적 기능을 사용하지 않도록 설정합니다.

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

예제

azure-rbac 기능을 사용하지 않도록 설정합니다.

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

여러 기능을 사용하지 않도록 설정합니다.

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

필수 매개 변수

--features

사용하지 않도록 설정할 기능의 공백으로 구분된 목록입니다.

허용되는 값: azure-rbac, cluster-connect, custom-locations
--name -n

연결된 클러스터의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--kube-config

kube 구성 파일의 경로입니다.

--kube-context

현재 컴퓨터의 Kubconfig 컨텍스트입니다.

--yes -y

확인을 묻는 메시지를 표시하지 마세요.

az connectedk8s enable-features

연결된 클러스터에서 선택적 기능을 사용하도록 설정합니다.

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]

예제

Cluster-Connect 기능을 사용하도록 설정합니다.

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

Azure RBAC 기능을 사용하도록 설정합니다.

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"

여러 기능을 사용하도록 설정합니다.

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

필수 매개 변수

--features

사용하려는 기능의 공백으로 구분된 목록입니다.

허용되는 값: azure-rbac, cluster-connect, custom-locations
--name -n

연결된 클러스터의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--app-id

Azure RBAC를 사용하도록 설정하기 위한 애플리케이션 ID입니다. azure-rbac를 사용하도록 설정할 때 지정합니다.

--app-secret

Azure RBAC를 사용하도록 설정하기 위한 애플리케이션 비밀입니다. azure-rbac를 사용하도록 설정할 때 지정합니다.

--custom-locations-oid

'custom-locations' 앱의 OID입니다.

--kube-config

kube 구성 파일의 경로입니다.

--kube-context

현재 컴퓨터의 Kubconfig 컨텍스트입니다.

--skip-azure-rbac-list

쉼표로 구분된 usernames/email/oid 이름 목록입니다. 이러한 사용자에 대해 Azure RBAC를 건너뜁습니다. azure-rbac를 사용하도록 설정할 때 지정합니다.

az connectedk8s list

연결된 kubernetes 클러스터를 나열합니다.

az connectedk8s list [--resource-group]

예제

리소스 그룹의 연결된 모든 kubernetes 클러스터를 나열합니다.

az connectedk8s list -g resourceGroupName --subscription subscriptionName

구독에 연결된 모든 kubernetes 클러스터를 나열합니다.

az connectedk8s list --subscription subscriptionName

선택적 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

az connectedk8s proxy

연결된 kubernetes 클러스터에 액세스합니다.

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

예제

연결된 kubernetes 클러스터에 액세스합니다.

az connectedk8s proxy -n clusterName -g resourceGroupName

사용자 지정 포트를 사용하여 연결된 kubernetes 클러스터에 대한 액세스 권한 가져오기

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

서비스 계정 토큰을 사용하여 연결된 kubernetes 클러스터에 대한 액세스 권한 가져오기

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

사용자 지정 kubeconfig 위치를 지정하여 연결된 kubernetes 클러스터에 대한 액세스 권한 가져오기

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

사용자 지정 컨텍스트를 지정하여 연결된 kubernetes 클러스터에 대한 액세스 권한 가져오기

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

필수 매개 변수

--name -n

연결된 클러스터의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--file -f

업데이트할 Kubernetes 구성 파일입니다. 제공되지 않으면 '~/.kube/config' 파일을 업데이트합니다. 대신 '-'를 사용하여 YAML을 인쇄하여 stdout합니다.

기본값: ~/.kube/config
--kube-context

지정한 경우 기본 컨텍스트 이름을 덮어씁 수 있습니다.

--port

연결된 클러스터에 액세스하는 데 사용되는 포트입니다.

기본값: 47011
--token

kubernetes 클러스터에 인증하는 데 사용할 서비스 계정 토큰입니다.

az connectedk8s show

연결된 kubernetes 클러스터의 세부 정보를 표시합니다.

az connectedk8s show --name
                     --resource-group

예제

연결된 kubernetes 클러스터에 대한 세부 정보 표시

az connectedk8s show -g resourceGroupName -n connectedClusterName

필수 매개 변수

--name -n

연결된 클러스터의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

az connectedk8s troubleshoot

Arc 지원 Kubernetes 클러스터에서 진단 검사를 수행합니다.

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

예제

Arc 지원 Kubernetes 클러스터에서 진단 검사를 수행합니다.

az connectedk8s troubleshoot -n clusterName -g resourceGroupName

필수 매개 변수

--name -n

연결된 클러스터의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--kube-config

kube 구성 파일의 경로입니다.

--kube-context

현재 컴퓨터의 Kubconfig 컨텍스트입니다.

--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

az connectedk8s update

호 온보딩된 kubernetes 클러스터의 속성을 업데이트합니다.

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]
                       [--tags]

예제

에이전트에 대한 프록시 값 업데이트

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

에이전트에 대한 프록시 설정 사용 안 함

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

에이전트 자동 업그레이드 사용 안 함

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

필수 매개 변수

--name -n

연결된 클러스터의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--auto-upgrade

Arc 에이전트의 자동 업그레이드를 사용하거나 사용하지 않도록 설정하는 플래그입니다. 기본적으로 에이전트의 자동 업그레이드가 사용됩니다.

허용되는 값: false, true
--disable-proxy

에이전트에 대한 프록시 설정을 사용하지 않도록 설정합니다.

--kube-config

kube 구성 파일의 경로입니다.

--kube-context

현재 컴퓨터의 Kubconfig 컨텍스트입니다.

--proxy-cert

추가 인증서 파일의 경로입니다(프록시의 경우).

--proxy-http

사용할 Http 프록시 URL입니다.

--proxy-https

사용할 Https 프록시 URL입니다.

--proxy-skip-range

프록시를 사용하지 않아야 하는 URL/CIDR 목록입니다.

--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

az connectedk8s upgrade

온보딩된 에이전트를 특정 버전으로 원자성으로 업그레이드하거나 기본값을 최신 버전으로 업그레이드합니다.

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

예제

에이전트를 최신 버전으로 업그레이드

az connectedk8s upgrade -g resourceGroupName -n connectedClusterName

에이전트를 특정 버전으로 업그레이드

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

사용자 지정 업그레이드 시간 제한을 사용하여 에이전트를 업그레이드합니다.

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

필수 매개 변수

--name -n

연결된 클러스터의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--agent-version

Helm 차트를 업데이트할 에이전트의 버전입니다.

--kube-config

kube 구성 파일의 경로입니다.

--kube-context

현재 컴퓨터의 Kubconfig 컨텍스트입니다.

--upgrade-timeout

arc-agent Pod를 kubernetes 클러스터에서 업그레이드하는 데 필요한 시간(초)입니다. 클러스터의 하드웨어/네트워크 제약 조건에 따라 arc-agent Pod를 업그레이드하는 데 더 많은 시간이 필요한 경우 이 값을 재정의합니다.

기본값: 600