이 페이지에서는 Resource Manager API 및 Google Cloud Platform 콘솔을 사용하여 라벨을 만들고 관리하는 방법에 대해 설명합니다.
라벨이란 무엇인가요?
라벨은 Google Cloud Platform 인스턴스를 체계화하는 데 도움이 되는 키-값 쌍입니다. 각 리소스에 라벨을 연결한 다음 해당 라벨을 기준으로 리소스를 필터링할 수 있습니다. 라벨에 대한 정보는 결제 시스템으로 전달되므로 라벨을 기준으로 청구 상세 내역을 확인할 수 있습니다.
라벨의 일반적인 사용 사례
다음은 라벨의 몇 가지 일반적인 사용 사례입니다.
팀 또는 비용 센터 라벨: 팀 또는 비용 센터 기준의 라벨을 추가하여 여러 팀에서 소유한 인스턴스를 구별할 수 있습니다(예:
team:research및team:analytics). 원가 계산이나 예산 책정에 이 유형의 라벨을 사용할 수 있습니다.구성요소 라벨:
component:redis,component:frontend,component:ingest,component:dashboard를 예로 들 수 있습니다.환경 또는 단계 라벨:
environment:production,environment:test를 예로 들 수 있습니다.상태 라벨:
state:active,state:readytodelete,state:archive를 예로 들 수 있습니다.
- 가상 머신 라벨: 가상 머신에 라벨을 연결할 수 있습니다. 이전에 정의한 가상 머신 태그는 값이 없는 라벨로 나타납니다.
라벨 요구사항
리소스에 적용된 라벨은 다음 요구 사항을 충족해야 합니다.
- 각 리소스는 여러 개의 라벨(최대 64개)을 가질 수 있습니다.
- 각 라벨은 키-값 쌍이어야 합니다.
- 키는 비워 둘 수 없으며 최소 길이는 1자이고 최대 길이는 63자입니다. 값은 비워 둘 수 있으며 최대 길이는 63자입니다.
- 키와 값에는 소문자, 숫자, 밑줄, 대시만 사용할 수 있습니다. 모든 문자는 UTF-8 인코딩을 사용해야 하며 국제 문자가 허용됩니다.
- 라벨의 키 부분은 고유해야 합니다. 그러나 여러 리소스에 동일한 키를 사용할 수 있습니다.
- 키는 소문자나 국제 문자로 시작해야 합니다.
특정 보고 서비스 및 프로젝트의 경우 1시간 동안 유지되는 고유한 키-값 쌍 조합의 수는 1,000개입니다. 예를 들어 Compute Engine 서비스는 가상 머신(VM) 인스턴스에 대한 측정항목을 보고합니다. 각기 고유한 라벨을 갖는 2,000개의 VM이 포함된 프로젝트를 배포하는 경우 서비스 보고서 측정항목은 1시간 동안 존재하는 처음 1,000개 라벨에 대해서만 유지됩니다.
Resource Manager API를 사용하여 라벨 만들기 및 관리
라벨을 사용하여 새 프로젝트를 만들려면 프로젝트를 만들 때 label 필드를 설정합니다.
REST
요청:
POST https://cloudresourcemanager.googleapis.com/v1beta1/projects
{
"labels": {
"color": "red"
},
"name": "myproject",
"projectId": "our-project-123"
}
응답:
{
"projectNumber": "333197460082",
"projectId": "our-project-123",
"lifecycleState": "ACTIVE",
"name": "myproject",
"labels": {
"color": "red"
},
"createTime": "2016-01-12T22:18:28.633Z",
}
Python
...
project = crm.projects().create(
body={
'project_id': flags.projectId,
'name': 'myproject',
labels.color: "red"
}).execute()
...
기존 프로젝트에 라벨을 추가하는 방법은 다음과 같습니다.
프로젝트 라벨을 업데이트하는 방법은 프로젝트 업데이트를 참조하세요.
라벨을 사용하여 프로젝트를 필터링하는 방법은 프로젝트 나열을 참조하세요.
GCP 콘솔을 사용하여 라벨 만들기 및 관리
단일 프로젝트에 라벨을 추가하는 방법은 다음과 같습니다.
- GCP 콘솔에서 라벨 페이지를 엽니다.
라벨 페이지 열기 - 프로젝트 선택 드롭다운에서 프로젝트를 선택합니다.
- 새 라벨 항목을 추가하려면 + 라벨 추가를 클릭하고 추가할 각 라벨의 라벨 키와 값을 입력합니다.
- 라벨 추가를 완료했으면 저장을 클릭합니다.
동시에 둘 이상의 프로젝트에 대해 라벨을 추가하는 방법은 다음과 같습니다.
- GCP 콘솔에서 리소스 관리 페이지로 이동합니다.
리소스 관리 페이지 열기 - 리소스 관리 페이지에서 라벨을 추가할 조직 및 프로젝트를 선택합니다.
- 오른쪽 패널의 라벨 탭에서 + 라벨 추가를 클릭하고 추가할 각 라벨의 라벨 키와 값을 입력합니다.
- 라벨 추가를 완료했으면 저장을 클릭합니다.
라벨을 추가한 후에 프로젝트 목록 위의 필터 상자에 라벨 키 또는 값을 입력하여 프로젝트를 필터링할 수 있습니다. 필터 상자에서는 결과를 미리 볼 수 있도록 키와 값을 제안합니다.
현재 라벨을 지원하는 서비스
현재 라벨을 지원하는 GCP 서비스는 다음과 같습니다.
- BigQuery
- Cloud Bigtable
- Cloud Dataflow
- Cloud Dataproc
- Cloud Deployment Manager
- Cloud Functions
- Cloud Key Management Service
- Cloud Pub/Sub
- Cloud Spanner
- Cloud SQL
- Cloud Storage
- Compute Engine
- Google Kubernetes Engine
- 네트워킹
- Resource Manager
