라벨 만들기 및 관리

이 페이지에서는 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 인코딩을 사용해야 하며 국제 문자가 허용됩니다.
  • 클러스터 라벨의 키 부분은 고유해야 합니다. 그러나 여러 리소스에 동일한 키를 사용할 수 있습니다.
  • 키는 소문자나 국제 문자로 시작해야 합니다.

시작하기 전에

이 작업을 준비하려면 다음 단계를 완료하세요.

  • Google Kubernetes Engine API가 사용 설정되었는지 확인합니다.
  • Google Kubernetes Engine API 사용 설정
  • Cloud SDK가 설치되었는지 확인합니다.
  • 기본 프로젝트 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에서는 클러스터 수준에서 라벨을 적용합니다. 클러스터에 라벨을 지정하면 사용자가 선택한 라벨은 클러스터의 모든 개별 리소스(예: 노드 및 영구 디스크)에 전파됩니다.

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

gcloud 도구로 클러스터를 만들 때 라벨을 추가하려면 다음 명령어를 실행하세요.

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

예:

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

Console

Cloud Console로 클러스터를 만들 때 라벨을 추가하려면 다음 단계를 수행하세요.

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

    Google Kubernetes Engine 메뉴로 이동

  2. 클러스터 만들기를 클릭합니다.

  3. 원하는 대로 클러스터를 구성합니다. 그런 다음 고급 옵션을 클릭합니다.

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

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

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

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

Cloud 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

Cloud 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 개요 읽어보기

이 페이지가 도움이 되었나요? 평가를 부탁드립니다.

다음에 대한 의견 보내기...

Kubernetes Engine 문서