az connectedk8s

참고

이 참조는 Azure CLI 대한 connectedk8s 확장의 일부이며 버전 2.16.0 이상에 필요합니다. 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 update

온보딩된 에이전트의 속성을 업데이트합니다.

az connectedk8s upgrade

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

az connectedk8s connect

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

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

예제

기본 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

필수 매개 변수

--name -n

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

--resource-group -g

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

선택적 매개 변수

--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
--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

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

--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
                       [--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>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--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 update

온보딩된 에이전트의 속성을 업데이트합니다.

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]

예제

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

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 목록입니다.

az connectedk8s upgrade

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

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

예제

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

az connectedk8s upgrade -g resourceGroupName -n connectedClusterName

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

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

필수 매개 변수

--name -n

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

--resource-group -g

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

선택적 매개 변수

--agent-version

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

--kube-config

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

--kube-context

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