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
필수 매개 변수
연결된 클러스터의 이름입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
'custom-locations' 앱의 OID입니다.
arc 에이전트의 자동 업그레이드를 사용하지 않도록 설정하는 플래그입니다.
이 연결된 클러스터에서 실행될 Kubernetes 배포입니다.
이 연결된 클러스터가 나타내는 Kubernetes 클러스터가 실행될 인프라입니다.
kube 구성 파일의 경로입니다.
현재 컴퓨터의 Kubconfig 컨텍스트입니다.
위치입니다. 값 출처: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.
장기 실행 작업이 완료될 때까지 기다리지 마세요.
프록시에 대한 인증서 파일의 경로입니다.
사용할 Http 프록시 URL입니다.
사용할 Https 프록시 URL입니다.
프록시를 사용하지 않아야 하는 URL/CIDR 목록입니다.
공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
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
필수 매개 변수
연결된 클러스터의 이름입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
kube 구성 파일의 경로입니다.
현재 컴퓨터의 Kubconfig 컨텍스트입니다.
장기 실행 작업이 완료될 때까지 기다리지 마세요.
확인을 묻는 메시지를 표시하지 마세요.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
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
필수 매개 변수
사용하지 않도록 설정할 기능의 공백으로 구분된 목록입니다.
연결된 클러스터의 이름입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
kube 구성 파일의 경로입니다.
현재 컴퓨터의 Kubconfig 컨텍스트입니다.
확인을 묻는 메시지를 표시하지 마세요.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
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
필수 매개 변수
사용하려는 기능의 공백으로 구분된 목록입니다.
연결된 클러스터의 이름입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
Azure RBAC를 사용하도록 설정하기 위한 애플리케이션 ID입니다. azure-rbac를 사용하도록 설정할 때 지정합니다.
Azure RBAC를 사용하도록 설정하기 위한 애플리케이션 암호입니다. azure-rbac를 사용하도록 설정할 때 지정합니다.
'custom-locations' 앱의 OID입니다.
kube 구성 파일의 경로입니다.
현재 컴퓨터의 Kubconfig 컨텍스트입니다.
쉼표로 구분된 usernames/email/oid 이름 목록입니다. 이러한 사용자에 대해 Azure RBAC를 건너뛰게 됩니다. azure-rbac를 사용하도록 설정할 때 지정합니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az connectedk8s list
연결된 kubernetes 클러스터를 나열합니다.
az connectedk8s list [--resource-group]
예제
리소스 그룹의 연결된 모든 kubernetes 클러스터를 나열합니다.
az connectedk8s list -g resourceGroupName --subscription subscriptionName
구독에 연결된 모든 kubernetes 클러스터를 나열합니다.
az connectedk8s list --subscription subscriptionName
선택적 매개 변수
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
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
필수 매개 변수
연결된 클러스터의 이름입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
업데이트할 Kubernetes 구성 파일입니다. 제공되지 않으면 '~/.kube/config' 파일을 업데이트합니다. 대신 '-'를 사용하여 YAML을 stdout에 인쇄합니다.
지정한 경우 기본 컨텍스트 이름을 덮어쓰는 것입니다.
연결된 클러스터에 액세스하는 데 사용되는 포트입니다.
kubernetes 클러스터에 인증하는 데 사용할 서비스 계정 토큰입니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az connectedk8s show
연결된 kubernetes 클러스터의 세부 정보를 표시합니다.
az connectedk8s show --name
--resource-group
예제
연결된 kubernetes 클러스터에 대한 세부 정보 표시
az connectedk8s show -g resourceGroupName -n connectedClusterName
필수 매개 변수
연결된 클러스터의 이름입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
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
필수 매개 변수
연결된 클러스터의 이름입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
arc 에이전트의 자동 업그레이드를 사용하거나 사용하지 않도록 설정하는 플래그입니다. 기본적으로 에이전트의 자동 업그레이드가 사용됩니다.
에이전트에 대한 프록시 설정을 사용하지 않도록 설정합니다.
kube 구성 파일의 경로입니다.
현재 컴퓨터의 Kubconfig 컨텍스트입니다.
프록시에 대한 인증서 파일의 경로입니다.
사용할 Http 프록시 URL입니다.
사용할 Https 프록시 URL입니다.
프록시를 사용하지 않아야 하는 URL/CIDR 목록입니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
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
필수 매개 변수
연결된 클러스터의 이름입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
Helm 차트를 업데이트할 에이전트의 버전입니다.
kube 구성 파일의 경로입니다.
현재 컴퓨터의 Kubconfig 컨텍스트입니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.