az aksarc
참고 항목
이 참조는 Azure CLI(버전 2.32.0 이상)에 대한 aksarc 확장의 일부입니다. az aksarc 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장 프로그램에 대해 자세히 알아보세요.
프로비전된 클러스터를 관리합니다.
명령
Name | Description | 형식 | 상태 |
---|---|---|---|
az aksarc create |
프로비전된 클러스터를 만듭니다. |
내선 번호 | GA |
az aksarc delete |
프로비전된 클러스터를 삭제합니다. |
내선 번호 | GA |
az aksarc get-credentials |
프로비전된 클러스터의 로컬 kubeconfig를 가져옵니다. |
내선 번호 | GA |
az aksarc get-upgrades |
프로비전된 클러스터에 사용할 수 있는 업그레이드 버전을 가져옵니다. |
내선 번호 | GA |
az aksarc get-versions |
지정된 사용자 지정 위치에 지원되는 Kubernetes 버전을 나열합니다. |
내선 번호 | GA |
az aksarc list |
리소스 그룹 또는 구독에서 프로비전된 클러스터를 나열합니다. |
내선 번호 | GA |
az aksarc logs |
프로비전된 클러스터에서 로그를 수집합니다. |
내선 번호 | GA |
az aksarc logs hci |
HCI 환경에서 프로비전된 클러스터에서 로그를 수집합니다. |
내선 번호 | GA |
az aksarc nodepool |
프로비전된 클러스터에서 nodepool을 관리합니다. |
내선 번호 | GA |
az aksarc nodepool add |
프로비전된 클러스터에 nodepool을 추가합니다. |
내선 번호 | GA |
az aksarc nodepool delete |
프로비전된 클러스터에서 nodepool을 삭제합니다. |
내선 번호 | GA |
az aksarc nodepool list |
프로비전된 클러스터의 모든 노드 풀을 나열합니다. |
내선 번호 | GA |
az aksarc nodepool scale |
프로비전된 클러스터에서 nodepool의 크기를 조정합니다. |
내선 번호 | GA |
az aksarc nodepool show |
프로비전된 클러스터의 nodepool을 가져옵니다. |
내선 번호 | GA |
az aksarc nodepool update |
프로비전된 클러스터에서 nodepool을 업데이트합니다. |
내선 번호 | GA |
az aksarc notice |
사용자가 지정한 파일 경로에 알림 파일을 출력합니다. |
내선 번호 | GA |
az aksarc release |
프로비전된 클러스터에 대한 VHD 이미지를 관리합니다. |
내선 번호 | 프리뷰 |
az aksarc release download |
릴리스에서 VHD 이미지를 다운로드합니다. |
내선 번호 | 프리뷰 |
az aksarc release save |
다운로드한 VHD 이미지를 아크 리소스 브리지에 프로비전합니다. |
내선 번호 | 프리뷰 |
az aksarc show |
프로비전된 클러스터를 가져옵니다. |
내선 번호 | GA |
az aksarc update |
프로비전된 클러스터를 업데이트합니다. |
내선 번호 | GA |
az aksarc upgrade |
프로비전된 클러스터를 업그레이드합니다. |
내선 번호 | GA |
az aksarc vmsize |
프로비전된 클러스터에 대한 가상 머신 SKU를 관리합니다. |
내선 번호 | GA |
az aksarc vmsize list |
지정된 사용자 지정 위치에 지원되는 가상 머신 크기를 나열합니다. |
내선 번호 | GA |
az aksarc vnet |
프로비전된 클러스터에 대한 가상 네트워크를 관리합니다. |
내선 번호 | GA |
az aksarc vnet create |
가상 네트워크를 만듭니다. |
내선 번호 | GA |
az aksarc vnet delete |
가상 네트워크를 삭제합니다. |
내선 번호 | GA |
az aksarc vnet list |
리소스 그룹 또는 구독별로 가상 네트워크를 나열합니다. |
내선 번호 | GA |
az aksarc vnet show |
가상 네트워크를 가져옵니다. |
내선 번호 | GA |
az aksarc create
프로비전된 클러스터를 만듭니다.
az aksarc create --custom-location
--name
--resource-group
--vnet-id
[--aad-admin-group-object-ids]
[--ca-profile]
[--control-plane-count]
[--control-plane-ip]
[--control-plane-vm-size]
[--disable-nfs-driver]
[--disable-smb-driver]
[--enable-ahub]
[--enable-azure-rbac]
[--enable-cluster-autoscaler]
[--enable-oidc-issuer]
[--enable-wi]
[--gateway-id]
[--generate-ssh-keys]
[--kubernetes-version]
[--load-balancer-count]
[--location]
[--max-count]
[--max-pods]
[--min-count]
[--no-wait]
[--node-count]
[--node-vm-size]
[--nodepool-labels]
[--nodepool-taints]
[--pod-cidr]
[--ssh-auth-ips]
[--ssh-key-value]
[--tags]
예제
PutProvisionedCluster
az aksarc create --resource-group sample-rg --custom-location sample-cl --name sample-aksarccluster --vnet-ids "vnet-arm-id"
필수 매개 변수
프로비전된 클러스터에 사용할 사용자 지정 위치의 이름 또는 ID입니다.
프로비전된 클러스터의 이름입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>
을 사용하여 기본 그룹을 구성할 수 있습니다.
aksarc 가상 네트워크 또는 Azure Stack HCI 논리 네트워크의 ARM 리소스 ID입니다.
선택적 매개 변수
프로비전된 클러스터에서 클러스터 관리자로 설정될 aad 그룹 개체 ID의 쉼표로 구분된 목록입니다.
클러스터 자동 크기 조정기를 구성하기 위한 키=값 쌍의 공백으로 구분된 목록입니다. 빈 문자열을 전달하여 프로필을 지웁다.
컨트롤 플레인 노드 수입니다.
Kubernetes APIServer IPAddress. IPAddress는 Azure Resource Bridge 어플라이언스에서 라우팅할 수 있어야 VM.It 참조되는 네트워크 서브넷의 일부여야 합니다. 라우팅할 수 없는 IPAddress가 전달되면 클러스터 만들기가 실패하거나 시간 제한이 발생할 수 있습니다.
제어 평면의 VM 크기입니다.
프로비전된 클러스터에 대해 NFS 드라이버를 사용하지 않도록 설정합니다.
프로비전된 클러스터에 대해 SMB 드라이버를 사용하지 않도록 설정합니다.
프로비전된 클러스터에 대해 AHUB(Azure 하이브리드 사용자 혜택)를 사용하도록 설정합니다.
Azure RBAC를 사용하여 클러스터에서 권한 부여 검사를 제어합니다.
프로비전된 클러스터에 대해 클러스터 자동 크기 조정기를 사용하도록 설정합니다.
OIDC 발급자를 사용하도록 설정합니다.
워크로드 ID 추가 기능을 사용하도록 설정합니다.
프로비전된 클러스터의 게이트웨이 Arm ID입니다.
ssh 키 쌍이 없으면 생성합니다.
프로비전된 클러스터의 kubernetes 버전입니다.
부하 분산 장치 노드 수입니다.
위치. 값 출처: az account list-locations
. az configure --defaults location=<location>
을 사용하여 기본 위치를 구성할 수 있습니다.
자동 크기 조정을 위한 최대 노드 수입니다.
노드에서 실행할 수 있는 최대 Pod 수입니다.
자동 크기 조정을 위한 최소 노드 수입니다.
장기 실행 작업이 완료되기를 기다리지 마세요.
nodepool에서 만들 노드 수입니다.
nodepool에 있는 노드의 VM 크기입니다.
공백으로 구분된 레이블: key[=value] [key[=value] ...].
nodepool taint의 쉼표로 구분된 목록입니다.
CIDR 표기법 IP 범위는 Pod IP를 할당할 범위입니다.
클러스터 vm에 ssh할 수 있는 IP 주소 또는 CIDR의 쉼표로 구분된 목록입니다.
제어 평면에 삽입할 ssh 공개 키의 경로입니다.
공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID
를 사용하여 기본 위치를 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az aksarc delete
프로비전된 클러스터를 삭제합니다.
az aksarc delete --name
--resource-group
[--no-wait]
[--yes]
예제
DeleteProvisionedCluster
az aksarc delete --name "sample-aksarccluster" --resource-group "sample-rg"
필수 매개 변수
프로비전된 클러스터의 이름입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>
을 사용하여 기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
장기 실행 작업이 완료되기를 기다리지 마세요.
확인을 묻는 메시지를 표시하지 마세요.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID
를 사용하여 기본 위치를 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az aksarc get-credentials
프로비전된 클러스터의 로컬 kubeconfig를 가져옵니다.
az aksarc get-credentials --name
--resource-group
[--admin]
[--context]
[--file]
[--overwrite-existing]
예제
GetAdminCredential
az aksarc get-credentials --name "sample-aksarccluster" --resource-group "sample-rg" --admin
GetAADUserCredential
az aksarc get-credentials --name "sample-aksarccluster" --resource-group "sample-rg"
필수 매개 변수
프로비전된 클러스터의 이름입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>
을 사용하여 기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
클러스터 관리자 자격 증명을 가져옵니다.
지정한 경우 기본 컨텍스트 이름을 덮어씁 수 있습니다.
업데이트할 Kubernetes 구성 파일입니다. 제공되지 않으면 '~/.kube/config' 파일을 업데이트합니다.
동일한 이름으로 기존 클러스터 항목을 덮어씁 수 있습니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID
를 사용하여 기본 위치를 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az aksarc get-upgrades
프로비전된 클러스터에 사용할 수 있는 업그레이드 버전을 가져옵니다.
az aksarc get-upgrades --name
--resource-group
예제
하이브리드 AKS 프로비저닝된 클러스터에 사용할 수 있는 업그레이드 버전 가져오기
az aksarc get-upgrades --name "samplecluster" --resource-group "sample-rg"
필수 매개 변수
프로비전된 클러스터의 이름입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>
을 사용하여 기본 그룹을 구성할 수 있습니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID
를 사용하여 기본 위치를 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az aksarc get-versions
지정된 사용자 지정 위치에 지원되는 Kubernetes 버전을 나열합니다.
az aksarc get-versions --custom-location
[--resource-group]
예제
VMListSkus
az aksarc get-versions -g sample-rg --custom-location sample-cl
필수 매개 변수
지원되는 k8s 버전을 표시하는 데 사용할 사용자 지정 위치의 이름입니다.
선택적 매개 변수
리소스 그룹의 이름입니다. az configure --defaults group=<name>
을 사용하여 기본 그룹을 구성할 수 있습니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID
를 사용하여 기본 위치를 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az aksarc list
리소스 그룹 또는 구독에서 프로비전된 클러스터를 나열합니다.
az aksarc list [--resource-group]
예제
ListProvisionedClusterByResourceGroup
az aksarc list --resource-group "sample-rg"
ListProvisionedClusterBySubscription
az aksarc list
선택적 매개 변수
리소스 그룹의 이름입니다. az configure --defaults group=<name>
을 사용하여 기본 그룹을 구성할 수 있습니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID
를 사용하여 기본 위치를 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az aksarc notice
사용자가 지정한 파일 경로에 알림 파일을 출력합니다.
az aksarc notice --output-filepath
예제
GetNoticeFile
az aksarc notice --output-filepath "./Notice"
필수 매개 변수
NOTICE 파일에 대한 출력 파일 경로입니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID
를 사용하여 기본 위치를 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az aksarc show
프로비전된 클러스터를 가져옵니다.
az aksarc show --name
--resource-group
예제
GetProvisionedCluster
az aksarc show --name "sample-aksarccluster" --resource-group "sample-rg"
필수 매개 변수
프로비전된 클러스터의 이름입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>
을 사용하여 기본 그룹을 구성할 수 있습니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID
를 사용하여 기본 위치를 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az aksarc update
프로비전된 클러스터를 업데이트합니다.
az aksarc update --name
--resource-group
[--aad-admin-group-object-ids]
[--ca-profile]
[--control-plane-count]
[--disable-ahub]
[--disable-cluster-autoscaler]
[--disable-gateway]
[--disable-nfs-driver]
[--disable-smb-driver]
[--enable-ahub]
[--enable-cluster-autoscaler]
[--enable-nfs-driver]
[--enable-smb-driver]
[--gateway-id]
[--max-count]
[--min-count]
[--tags]
[--update-cluster-autoscaler]
예제
UpdateProvisionedCluster
az aksarc update --tags additionalProperties="sample" --name "sample-aksarccluster" --resource-group "sample-rg"
프로비전된 클러스터에 대해 Azure 하이브리드 사용자 혜택 기능을 사용하도록 설정합니다.
az aksarc update --name "sample-aksarccluster" --resource-group "sample-rg" --enable-ahub
프로비전된 클러스터에 대한 Azure 하이브리드 사용자 혜택 기능을 사용하지 않도록 설정합니다.
az aksarc update --name "sample-aksarccluster" --resource-group "sample-rg"--disable-ahub
컨트롤 플레인 노드를 강화합니다.
az aksarc update --name "sample-aksarccluster" --resource-group "sample-rg" --control-plane-node-count 5
필수 매개 변수
프로비전된 클러스터의 이름입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>
을 사용하여 기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
프로비전된 클러스터에서 클러스터 관리자로 설정될 aad 그룹 개체 ID의 쉼표로 구분된 목록입니다.
클러스터 자동 크기 조정기를 구성하기 위한 키=값 쌍의 공백으로 구분된 목록입니다. 빈 문자열을 전달하여 프로필을 지웁다.
컨트롤 플레인의 크기를 조정할 노드 수입니다.
프로비전된 클러스터에 대해 AHUB(Azure 하이브리드 사용자 혜택)를 사용하지 않도록 설정합니다.
프로비전된 클러스터에 대해 클러스터 자동 크기 조정기를 사용하지 않도록 설정합니다.
프로비전된 클러스터에 대한 게이트웨이를 사용하지 않도록 설정합니다.
프로비전된 클러스터에 대해 NFS 드라이버를 사용하지 않도록 설정합니다.
프로비전된 클러스터에 대해 SMB 드라이버를 사용하지 않도록 설정합니다.
프로비전된 클러스터에 대해 AHUB(Azure 하이브리드 사용자 혜택)를 사용하도록 설정합니다.
프로비전된 클러스터에 대해 클러스터 자동 크기 조정기를 사용하도록 설정합니다.
프로비전된 클러스터에 대해 NFS 드라이버를 사용하도록 설정합니다.
프로비전된 클러스터에 대해 SMB 드라이버를 사용하도록 설정합니다.
프로비전된 클러스터의 게이트웨이 Arm ID입니다.
자동 크기 조정을 위한 최대 노드 수입니다.
자동 크기 조정을 위한 최소 노드 수입니다.
공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.
프로비전된 클러스터에 대한 클러스터 자동 크기 조정기를 업데이트합니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID
를 사용하여 기본 위치를 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az aksarc upgrade
프로비전된 클러스터를 업그레이드합니다.
az aksarc upgrade --name
--resource-group
[--kubernetes-version]
[--no-wait]
[--yes]
예제
UpgradeProvisionedCluster
az aksarc upgrade --name "sample-aksarccluster" --resource-group "sample-rg" --kubernetes-version "1.22.2"
필수 매개 변수
프로비전된 클러스터의 이름입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>
을 사용하여 기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
프로비전된 클러스터의 kubernetes 버전입니다.
장기 실행 작업이 완료되기를 기다리지 마세요.
확인 프롬프트를 사용하지 않도록 설정하는 플래그입니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID
를 사용하여 기본 위치를 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
Azure CLI