라벨 관리

이 페이지에서는 Filestore 인스턴스에 라벨을 사용하는 방법을 설명합니다. 인스턴스의 라벨을 추가, 업데이트, 삭제하는 방법도 설명합니다. 라벨을 사용하여 관련된 인스턴스를 그룹화하고 인스턴스에 대한 메타데이터를 저장할 수 있습니다.

라벨이란 무엇인가요?

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

라벨의 일반적인 사용 사례

모든 API 호출의 타임스탬프 또는 개별 값과 같은 고유 라벨을 대량으로 만드는 것은 권장하지 않습니다. 다음은 라벨의 몇 가지 일반적인 사용 사례입니다.

  • 팀 또는 비용 센터 라벨: 팀 또는 비용 센터를 기준으로 라벨을 추가하여 서로 다른 팀(예: team:researchteam:analytics)에서 소유하는 Filestore 인스턴스를 구분할 수 있습니다. 비용 계산이나 예산 책정에 이 유형의 라벨을 사용할 수 있습니다.

  • 구성요소 라벨: component:redis, component:frontend, component:ingest, component:dashboard를 예로 들 수 있습니다.

  • 환경 또는 단계 라벨: environment:productionenvironment:test를 예로 들 수 있습니다.

  • 상태 라벨: state:active, state:readytodelete, state:archive를 예시로 들 수 있습니다.

라벨 요구사항

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

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

인스턴스의 라벨 추가 또는 업데이트하기

Filestore 인스턴스를 만든 후에는 인스턴스에 라벨을 추가하고 기존 라벨을 업데이트 또는 삭제할 수 있습니다.

Console

  1. Cloud Console에서 Filestore 인스턴스 페이지로 이동합니다.

    Filestore 인스턴스 페이지로 이동

  2. 라벨을 수정할 각 인스턴스 옆에 있는 체크박스를 선택합니다.

  3. 오른쪽 상단의 정보 패널 표시를 클릭하여 엽니다.

  4. 필요에 따라 라벨을 추가하고 업데이트합니다.

    작업 안내
    라벨 추가 라벨 추가를 클릭하고 라벨의 키와 값을 입력합니다.
    라벨 업데이트 필드를 업데이트합니다. 기존 라벨의 는 업데이트할 수 없습니다.
    라벨 삭제 라벨 옆에 있는 항목 삭제 를 클릭합니다.
  5. 업데이트가 완료되면 저장을 클릭하여 변경사항을 저장합니다.

gcloud

instances update 명령어를 실행하여 Filestore 인스턴스의 라벨을 수정할 수 있습니다. 새 라벨을 추가하거나 기존 라벨의 값을 변경하려면 --update-labels 플래그를 사용합니다. 하나 이상의 라벨을 삭제하려면 --remove-labels 플래그를 사용합니다. --clear-labels 플래그는 인스턴스에서 모든 라벨을 삭제합니다.

gcloud filestore instances update instance-id \
    --project=project-id \
    --zone=zone \
    --update-labels key=value,[key=value,…] \
    --remove-labels key,[key,…] \
    --clear-labels

각 항목의 의미는 다음과 같습니다.

  • instance-id는 수정할 인스턴스의 인스턴스 ID입니다.
  • project-id는 Filestore 인스턴스가 포함된 Cloud 프로젝트의 프로젝트 ID입니다. Filestore 인스턴스가 gcloud 기본 프로젝트에 있는 경우 이 플래그를 생략할 수 있습니다. 다음을 실행하여 기본 프로젝트를 설정할 수 있습니다.

     gcloud config set project project-id
    
  • zone은 Filestore 인스턴스가 있는 영역입니다. gcloud filestore zones list 명령어를 실행하여 지원되는 영역 목록을 가져옵니다. Filestore 인스턴스가 gcloud 기본 영역에 있는 경우 이 플래그를 생략할 수 있습니다. 다음을 실행하여 기본 영역을 설정할 수 있습니다.

     gcloud config set filestore/zone zone
    
  • key는 새 라벨 또는 변경하거나 삭제하려는 기존 라벨입니다.

  • value는 라벨 값입니다.

예시

다음 예에서는 status 라벨을 추가하고 dept 라벨 값을 업데이트하고 admin 라벨을 제거하여 nfs-server 인스턴스를 업데이트합니다.

gcloud filestore instances update nfs-server \
    --project=myproject \
    --zone=us-central1-c \
    --update-labels status=active \
    --update-labels dept=accounting \
    --remove-labels admin

다음 단계

Filestore 인스턴스의 다른 속성 수정 방법 알아보기