다음을 통해 공유


Azure Arc에서 사용하도록 설정된 AKS에서 클러스터 레이블 사용

적용 대상: Azure Stack HCI, 버전 23H2

여러 노드 풀이 있는 경우 노드 풀을 만드는 동안 레이블을 추가할 수 있습니다. Kubernetes 레이블은 노드에 대한 예약 규칙을 처리합니다.

이 문서에서는 Arc에서 사용하도록 설정된 AKS의 Kubernetes 클러스터에서 레이블을 사용하는 방법을 설명합니다.

레이블을 사용하여 Kubernetes 클러스터 만들기

  1. 명령을 사용하여 레이블이 있는 Kubernetes 클러스터를 az aksarc create 만들고 매개 변수를 --node-labels 지정하여 레이블을 설정합니다. 레이블은 키/값 쌍이어야 하며 유효한 구문이 있어야 합니다.

    az aksarc create --resource-group myResourceGroup --name myAKSCluster --node-count 2 --nodepool-labels dept=IT
    
  2. 명령을 사용하여 레이블이 설정되었는지 확인합니다.kubectl get nodes --show-labels

    kubectl get nodes --show-labels | grep -e "dept=IT"
    

레이블이 있는 노드 풀 만들기

  1. 명령을 사용하여 레이블이 있는 노드 풀을 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"
        },
        ...
      },
     ...
    ]
    
  2. 명령을 사용하여 kubectl get nodes --show-labels 레이블이 설정되었는지 확인합니다.

    kubectl get nodes --show-labels | grep -e "dept=HR"
    

기존 노드 풀의 레이블 업데이트

  1. az aksarc nodepool update 명령을 사용하여 기존 노드 풀의 레이블을 업데이트합니다. 기존 노드 풀에서 레이블을 업데이트하면 이전 레이블을 새 레이블로 덮어씁니다. 레이블은 키/값 쌍이어야 하며 유효한 구문이 있어야 합니다.

    az aksarc nodepool update --resource-group myResourceGroup --cluster-name myAKSCluster --name labelnp --labels dept=ACCT costcenter=6000 --no-wait
    
  2. 명령을 사용하여 레이블이 설정되었는지 확인합니다 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 설명서를 참조하세요.