라벨 만들기 및 관리

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

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

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

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

다음은 클러스터 라벨의 몇 가지 일반적인 사용 사례입니다.

  • 팀 또는 비용 센터 클러스터 라벨: 팀 또는 비용 센터를 기준으로 라벨을 추가하여 여러 팀(예: 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에서는 클러스터 수준에서 라벨을 적용합니다. 클러스터에 라벨을 지정할 때, 사용자가 선택한 라벨은 클러스터의 모든 개별 리소스(예: 노드 및 Persistent Disk)에 전파됩니다.

Google Cloud Platform 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

콘솔

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

  1. GCP 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

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

콘솔

GCP Console을 사용하여 라벨을 추가하거나 업데이트하려면 다음 단계를 수행하세요.

  1. GCP 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=dev

콘솔

GCP Console을 사용하여 라벨을 삭제하려면 다음 단계를 수행하세요.

  1. GCP 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