Azure Arc에서 사용하도록 설정된 AKS에서 클러스터 레이블 사용
적용 대상: Azure Stack HCI, 버전 23H2
여러 노드 풀이 있는 경우 노드 풀을 만드는 동안 레이블을 추가할 수 있습니다. Kubernetes 레이블은 노드에 대한 예약 규칙을 처리합니다.
이 문서에서는 Arc에서 사용하도록 설정된 AKS의 Kubernetes 클러스터에서 레이블을 사용하는 방법을 설명합니다.
레이블을 사용하여 Kubernetes 클러스터 만들기
명령을 사용하여 레이블이 있는 Kubernetes 클러스터를
az aksarc create
만들고 매개 변수를--node-labels
지정하여 레이블을 설정합니다. 레이블은 키/값 쌍이어야 하며 유효한 구문이 있어야 합니다.az aksarc create --resource-group myResourceGroup --name myAKSCluster --node-count 2 --nodepool-labels dept=IT
명령을 사용하여 레이블이 설정되었는지 확인합니다.
kubectl get nodes --show-labels
kubectl get nodes --show-labels | grep -e "dept=IT"
레이블이 있는 노드 풀 만들기
명령을 사용하여 레이블이 있는 노드 풀을
az aksarc nodepool add
만들고 매개 변수의--name
이름과 매개 변수의 레이블을--labels
지정합니다. 레이블은 키/값 쌍이어야 하며 유효한 구문이 있어야 합니다.다음 예제에서는 레이블
dept=HR
이 인 라는labelnp
노드 풀을 만듭니다.az aksarc nodepool add –resource-group myResourceGroup –cluster-name myAKSCluster –name labelnp –node-count 1 –labels dept=HR –no-wait
명령의
az aksarc nodepool list
다음 예제 출력은 노드 풀이labelnp
지정된nodeLabels
를 사용하여 노드를 만드는 것을 보여 줍니다.[ { ... "count": 1, ... "name": "labelnp", "orchestratorVersion": "1.15.7", ... "provisioningState": "Creating", ... "nodeLabels": { "costcenter": "5000", "dept": "HR" }, ... }, ... ]
명령을 사용하여
kubectl get nodes --show-labels
레이블이 설정되었는지 확인합니다.kubectl get nodes --show-labels | grep -e "dept=HR"
기존 노드 풀의 레이블 업데이트
az aksarc nodepool update 명령을 사용하여 기존 노드 풀의 레이블을 업데이트합니다. 기존 노드 풀에서 레이블을 업데이트하면 이전 레이블을 새 레이블로 덮어씁니다. 레이블은 키/값 쌍이어야 하며 유효한 구문이 있어야 합니다.
az aksarc nodepool update --resource-group myResourceGroup --cluster-name myAKSCluster --name labelnp --labels dept=ACCT costcenter=6000 --no-wait
명령을 사용하여 레이블이 설정되었는지 확인합니다
kubectl get nodes --show-labels
.kubectl get nodes --show-labels | grep -e "costcenter=6000" -e "dept=ACCT"
사용할 수 없는 레이블
Azure Arc에서 사용하도록 설정된 AKS는 AKS와 동일한 규칙을 따릅니다.
- 예약된 시스템 레이블은 변경할 수 없습니다. 이렇게 하려는 경우 오류가 반환됩니다.
- Kubernetes 및 AKS 예약된 접두사는 노드에 사용할 수 없습니다.
자세한 내용은 AKS 설명서에서 사용할 수 없는 레이블 을 참조하세요.
다음 단계
Kubernetes 레이블에 대한 자세한 내용은 Kubernetes 설명서를 참조하세요.