이 페이지에서는 Filestore 인스턴스에서 라벨을 사용하는 방법을 보여줍니다. 인스턴스의 라벨을 추가, 업데이트, 삭제하는 방법도 설명합니다. 라벨은 관련 인스턴스를 그룹화하고 인스턴스에 대한 메타데이터를 저장할 수 있게 해줍니다.
라벨이란 무엇인가요?
라벨은 Google Cloud Filestore 인스턴스에 할당할 수 있는 키-값 쌍입니다. 이러한 리소스를 구성하고 필요한 세부사항으로 규모에 맞게 비용을 관리하는 데 도움이 됩니다. 각 리소스에 라벨을 연결한 후 이 라벨을 기준으로 리소스를 필터링할 수 있습니다. 라벨에 대한 정보는 청구 요금을 라벨별로 분류할 수 있는 결제 시스템으로 전달됩니다. 기본 제공되는 결제 보고서를 통해 리소스 라벨별로 비용을 필터링하고 그룹화할 수 있습니다. 라벨을 사용하여 결제 데이터 내보내기를 쿼리할 수도 있습니다.
라벨 요구사항
리소스에 적용된 라벨은 다음 요구사항을 충족해야 합니다.
- 각 리소스에 라벨을 최대 64개까지 사용할 수 있습니다.
- 각 라벨은 키-값 쌍이어야 합니다.
- 키는 비워 둘 수 없으며 최소 길이는 1자(영문 기준)이고 최대 길이는 63자(영문 기준)입니다. 값은 비워 둘 수 있으며 최대 길이는 63자(영문 기준)입니다.
- 키와 값에는 소문자, 숫자, 밑줄, 대시만 사용할 수 있습니다. 모든 문자는 UTF-8 인코딩을 사용해야 하며 국제 문자가 허용됩니다. 키는 소문자나 국제 문자로 시작해야 합니다.
- 라벨의 키 부분은 단일 리소스에서 고유해야 합니다. 그러나 여러 리소스에 같은 키를 사용할 수 있습니다.
이러한 한도는 각 라벨의 키와 값 및 라벨이 있는 개별 Google Cloud 리소스에 적용됩니다. 한 프로젝트의 모든 리소스에 적용할 수 있는 라벨 수에는 제한이 없습니다.
라벨의 일반적인 사용 사례
다음은 라벨의 몇 가지 일반적인 사용 사례입니다.
팀 또는 비용 센터 라벨: 팀 또는 비용 센터를 기준으로 라벨을 추가하여 서로 다른 팀(예:
team:research
및team:analytics
)에서 소유하는 Filestore 인스턴스를 구분할 수 있습니다. 비용 계산이나 예산 책정에 이 유형의 라벨을 사용할 수 있습니다.구성요소 라벨:
component:redis
,component:frontend
,component:ingest
,component:dashboard
를 예로 들 수 있습니다.환경 또는 단계 라벨:
environment:production
과environment:test
를 예로 들 수 있습니다.상태 라벨:
state:active
,state:readytodelete
,state:archive
를 예로 들 수 있습니다.소유권 라벨: 작업을 담당하는 팀을 식별하는 데 사용됩니다(예:
team:shopping-cart
).
모든 API 호출의 타임스탬프 또는 개별 값과 같은 대량의 고유 라벨은 만들지 않는 것이 좋습니다. 이 접근 방식의 문제는 값이 자주 변경되거나 카탈로그를 복잡하게 하는 키로 인해 리소스를 효과적으로 필터링하고 보고하기 어렵다는 것입니다.
라벨 및 태그
라벨은 리소스에 대해 쿼리 가능한 주석으로 사용될 수 있지만 정책에 조건을 설정하는 데는 사용할 수 없습니다. 태그를 사용하면 정책을 세밀하게 제어하여 리소스에 특정 태그가 있는지 여부에 따라 정책을 조건부로 허용하거나 거부할 수 있습니다. 자세한 내용은 태그 개요를 참조하세요.
인스턴스의 라벨 추가 또는 업데이트하기
인스턴스를 만들 때 Filestore 인스턴스에 라벨을 추가할 수 있습니다. 인스턴스를 만든 후에는 인스턴스에 라벨을 더 추가하거나 기존 라벨을 업데이트하거나 삭제할 수 있습니다.
Console
Google Cloud 콘솔에서 Filestore 인스턴스 페이지로 이동합니다.
라벨을 수정할 각 인스턴스 옆에 있는 체크박스를 선택합니다.
정보 패널 표시를 클릭합니다.
필요에 따라 라벨을 추가하고 업데이트합니다.
작업 안내 라벨 추가 라벨 추가를 클릭하고 라벨의 키와 값을 입력합니다. 라벨 업데이트 값 필드를 업데이트합니다. 기존 라벨의 Key는 업데이트할 수 없습니다. 라벨 삭제 라벨 옆에 있는 항목 삭제 delete를 클릭합니다. 업데이트가 완료되면 저장을 클릭하여 변경사항을 저장합니다.
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 인스턴스가 포함된 Google 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
현재 라벨을 지원하는 서비스
현재 Google Cloud 서비스는 다음과 같은 라벨을 지원합니다.
- AI Platform
- App Engine(가변형 환경 및 표준 환경)
- Artifact Registry
- BigQuery
- Certificate Authority Service
- Cloud Composer
- Cloud Bigtable
- Cloud Deployment Manager
- Cloud Functions
- Cloud Healthcare API
- Cloud Key Management Service
- Cloud Run
- Cloud Spanner
- Cloud SQL
- Cloud Storage
- Compute Engine
- Dataflow
- Dataproc
- Filestore
- Google Kubernetes Engine
- 네트워킹
- Pub/Sub
- Resource Manager(프로젝트 전용)
다음 단계
Filestore 인스턴스의 다른 속성 수정 방법 알아보기