클러스터 라벨 만들기 및 관리

이 페이지에서는 GKE의 클러스터 라벨 개요를 제공합니다.

클러스터 라벨이란 무엇인가요?

클러스터 라벨은 Google Cloud 클러스터를 구성하는 데 유용한 키-값 쌍입니다. 각 리소스에 라벨을 연결한 후 이 라벨을 기준으로 리소스를 필터링할 수 있습니다. 라벨에 대한 정보는 결제 시스템으로 전달되므로 라벨을 기준으로 청구 상세 내역을 확인할 수 있습니다.

클러스터 라벨의 일반적인 사용 사례

모든 API 호출의 타임스탬프 또는 개별 값과 같은 대량의 고유 라벨은 만들지 않는 것이 좋습니다. 다음은 클러스터 라벨의 일반적인 사용 사례 중 일부입니다.

  • 팀 또는 비용 센터 클러스터 라벨: 팀 또는 비용 센터 기준의 라벨을 추가하여 team:researchteam:analytics와 같은 여러 팀에서 소유한 클러스터를 구별할 수 있습니다. 비용 계산이나 예산 책정에 이 유형의 라벨을 사용할 수 있습니다.

  • 구성요소 클러스터 라벨: 예를 들어 component:redis, component:frontend, component:ingest, component:dashboard입니다.

  • 환경 또는 단계 클러스터 라벨: 예를 들어 environment:productionenvironment:test입니다.

  • 상태 클러스터 라벨: 예를 들어 state:active, state:readytodelete, state:archive입니다.

클러스터 라벨 요구사항

리소스에 적용된 클러스터 라벨은 다음 요구사항을 충족해야 합니다.

  • 각 리소스는 여러 개의 클러스터 라벨(최대 64개)을 가질 수 있습니다.
  • 각 클러스터 라벨은 키-값 쌍이어야 합니다.
  • 키는 비워 둘 수 없으며 최소 길이는 1자이고 최대 길이는 63자입니다. 값은 비워 둘 수 있으며 최대 길이는 63자(영문 기준)입니다.
  • 키와 값에는 소문자, 숫자, 밑줄, 대시만 사용할 수 있습니다. 모든 문자는 UTF-8 인코딩을 사용해야 하며 국제 문자가 허용됩니다.
  • 클러스터 라벨의 키 부분은 고유해야 합니다. 그러나 여러 리소스에 동일한 키를 사용할 수 있습니다.
  • 키는 소문자나 국제 문자로 시작해야 합니다.

시작하기 전에

시작하기 전에 다음 태스크를 수행했는지 확인합니다.

다음 방법 중 하나를 사용하여 기본 gcloud 설정을 진행합니다.

  • gcloud init를 사용하여 기본값 설정 과정을 진행합니다.
  • gcloud config를 사용하여 프로젝트 ID, 영역, 리전을 개별적으로 설정합니다.

gcloud init 사용

One of [--zone, --region] must be supplied: Please specify location 오류가 표시되면 이 섹션을 완료합니다.

  1. gcloud init를 실행하고 다음 안내를 따르세요.

    gcloud init

    원격 서버에서 SSH를 사용하는 경우 --console-only 플래그를 사용하여 다음 명령어로 브라우저를 실행하지 못하게 할 수 있습니다.

    gcloud init --console-only
  2. 안내를 따라 gcloud에서 Google Cloud 계정을 사용하도록 승인합니다.
  3. 새 구성을 만들거나 기존 구성을 선택합니다.
  4. Google Cloud 프로젝트를 선택합니다.
  5. 기본 Compute Engine 영역을 선택합니다.

gcloud config 사용

  • 기본 프로젝트 ID를 설정합니다.
    gcloud config set project project-id
  • 영역 클러스터를 사용하는 경우 기본 컴퓨팅 영역을 설정합니다.
    gcloud config set compute/zone compute-zone
  • 리전 클러스터를 사용하는 경우 기본 컴퓨팅 리전을 설정합니다.
    gcloud config set compute/region compute-region
  • gcloud를 최신 버전으로 업데이트합니다.
    gcloud components update

라벨 자동 적용

클러스터가 만들어지면 GKE가 자동으로 클러스터 리소스에 라벨을 여러 개 적용합니다. 예를 들어 GKE는 Compute Engine 인스턴스, 영구 디스크, 가속기(TPU)에 라벨을 적용합니다. 자동으로 적용되는 라벨에는 특별한 goog-gke- 프리픽스가 있습니다.

다음 goog-gke- 라벨은 GKE 리소스에 자동으로 적용됩니다. Compute Engine 수준 또는 GKE 클러스터 수준에서 예약된 goog-gke- 라벨에 대해 수정한 사항은 자동으로 조정됩니다. 따라서 예약된 라벨을 수정하거나 삭제하지 않는 것이 좋습니다.

라벨 적용된 리소스
goog-gke-node GKE 노드
goog-gke-volume GKE 노드에 연결된 영구 디스크
goog-gke-tpu GKE의 Cloud TPU

클러스터 라벨 지정 정보

GKE에서는 클러스터 수준에서 라벨을 적용합니다. 클러스터에 라벨을 지정하면 사용자가 선택한 라벨은 클러스터의 모든 개별 리소스(예: 노드 및 영구 디스크)에 전파됩니다.

Google Cloud Console, gcloud 명령줄 도구 또는 GKE API를 사용하여 클러스터 라벨을 추가, 업데이트, 삭제할 수 있습니다.

API 요청의 라벨 디지털 지문 가져오기

GKE API를 사용하여 클러스터 라벨을 업데이트하거나 추가할 때는 다른 요청과 충돌하지 않도록 요청과 함께 최신 클러스터 라벨 디지털 지문을 제공해야 합니다.

최신 클러스터 라벨 디지털 지문을 가져오려면 적합한 클러스터에 대해 GET 요청을 실행합니다. 예를 들면 다음과 같습니다.

GET https://container.googleapis.com/v1/projects/myproject/zones/us-central1-f/clusters/example-cluster

응답에서 labelFingerprint 속성을 찾습니다.

200 OK

{

 "name": "mycluster",
 "description": "test-cluster",
 "initialNodeCount": 3,
 ...
 "resourceLabels": {
    "env": "test",
    ...
  },
  "labelFingerprint": "p1ty_9HoBk0="
}

라벨이 있는 클러스터 만들기

gcloud 도구, Google Cloud Console 또는 GKE API를 사용하여 라벨이 있는 클러스터를 만들 수 있습니다.

gcloud

다음 명령어를 실행합니다.

gcloud container clusters create [CLUSTER_NAME] --labels [KEY]=[VALUE]

예를 들면 다음과 같습니다.

gcloud container clusters create example-cluster --labels env=dev

Console

클러스터를 만들 때 라벨을 추가하려면 다음 안내를 따르세요.

  1. Cloud Console에서 Google Kubernetes Engine 메뉴로 이동합니다.

    Google Kubernetes Engine 메뉴로 이동

  2. 클러스터 만들기 버튼을 클릭합니다.

  3. 원하는 대로 클러스터를 구성합니다.

  4. 탐색창의 클러스터에서 메타데이터를 클릭합니다.

  5. 라벨 추가를 클릭합니다.

  6. 원하는 대로 라벨을 추가합니다.

  7. 만들기를 클릭합니다.

API

클러스터를 만들 때 라벨을 포함하려면 projects.zones.clusters.create에 제공하는 cluster 객체 내에서 resourceLabels 객체를 지정합니다.

기존 클러스터의 라벨 추가 또는 업데이트

gcloud

gcloud 도구를 사용하여 라벨을 업데이트하려면 다음 명령어를 실행하세요.

gcloud container clusters update [CLUSTER_NAME] --update-labels [KEY]=[VALUE]

예를 들면 다음과 같습니다.

gcloud container clusters update example-cluster --update-labels env=dev,release=stable

라벨을 업데이트하면 기존 라벨을 덮어씁니다. 클러스터에 보존하려는 기존 라벨이 있으면 추가하려는 새 라벨과 함께 기존 라벨을 포함해야 합니다.

Console

라벨을 추가하거나 업데이트하려면 다음 안내를 따르세요.

  1. Cloud Console에서 Google Kubernetes Engine 메뉴로 이동합니다.

    Google Kubernetes Engine 메뉴로 이동

  2. 단일 클러스터에 라벨을 추가하려면 연필 모양의 해당 수정 버튼을 클릭합니다.

    1. 라벨 추가를 클릭하고 하나 이상의 라벨을 추가합니다.
    2. 저장을 클릭합니다.
  3. 여러 클러스터에 라벨을 한 번에 추가하려면 다음을 수행합니다.

    1. 라벨을 지정하려는 클러스터의 체크박스를 선택합니다.
    2. 아직 표시되지 않았으면 정보 패널 표시를 클릭하여 라벨 열을 확장합니다.
    3. 원하는 대로 라벨을 업데이트하거나 새 라벨을 추가합니다.
    4. 저장을 클릭합니다.

API

라벨을 업데이트하려면 최신 디지털 지문과 적용할 라벨의 전체 목록을 사용하여 클러스터의 resourceLabels 메서드에 대해 POST 요청을 실행합니다.

메타데이터 및 태그와 마찬가지로 클러스터에 보존하려는 기존 라벨이 있으면 추가하려는 새 라벨과 함께 요청에 이러한 라벨을 포함해야 합니다.

예를 들어 다음 스니펫은 resourceLabels 메서드에 대해 요청을 실행합니다.

POST https://container.googleapis.com/v1/projects/myproject/zones/us-central1-f/clusters/example-cluster/resourceLabels

{
 "resourceLabels": {
  "env": "test",
  "an-existing-tag": ""
 },
 "labelFingerprint": "42WmSpB8rSM="
}

클러스터 라벨 삭제

gcloud

gcloud 명령줄 도구를 사용하여 --remove-labels 플래그와 함께 update 명령어를 실행합니다. 삭제할 라벨 키 집합을 제공합니다. 예를 들면 다음과 같습니다.

gcloud container clusters update example-cluster --remove-labels env

Console

라벨을 삭제하려면 다음 안내를 따르세요.

  1. Cloud Console에서 Google Kubernetes Engine 메뉴로 이동합니다.

    Google Kubernetes Engine 메뉴로 이동

  2. 단일 클러스터에서 라벨을 삭제하려면 연필 모양의 해당 수정 버튼을 클릭합니다.

    1. 삭제할 라벨 옆에 있는 X를 클릭합니다.
    2. 저장을 클릭합니다.
  3. 여러 클러스터에서 라벨을 한 번에 삭제하려면 다음을 수행하세요.

    1. 라벨을 삭제하려는 클러스터 옆의 체크박스를 선택합니다.
    2. 아직 표시되지 않았으면 정보 패널 표시를 클릭하여 라벨 열을 확장합니다.
    3. 삭제할 라벨 옆에 있는 X를 클릭합니다.
    4. 저장을 클릭합니다.

API

API에서 적절한 클러스터의 resourceLabels 메서드에 대해 POST 요청을 실행합니다. 최신 labelsFingerprint 및 비어 있는 라벨 목록을 제공하여 모든 라벨을 삭제하거나 유지하려는 라벨 목록을 제공합니다(삭제하려는 라벨은 생략). 예를 들면 다음과 같습니다.

Request

POST https://container.googleapis.com/v1/projects/myproject/zones/us-central1-f/clusters/example-cluster/resourceLabels

{
 "resourceLabels": { },
 "labelFingerprint": "42WmSpB8rSM="
}

다음 단계

GKE 개요 읽어보기