저장소 라벨 지정

라벨을 사용하여 관련 저장소를 식별하고 그룹화합니다. 저장소에 여러 라벨을 지정할 수 있습니다.

Google Cloud 조직에서 보고, 감사, 액세스 제어를 위해 Google Cloud에서 저장소 및 기타 리소스를 그룹화하려면 태그를 사용합니다. 태그와 라벨은 서로 독립적으로 작동하며 동일한 저장소에 모두 적용할 수 있습니다.

라벨이란 무엇인가요?

라벨은 Google Cloud 저장소에 할당할 수 있는 키-값 쌍입니다. 이러한 리소스를 구성하고 필요한 세부사항으로 규모에 맞게 비용을 관리하는 데 도움이 됩니다. 각 리소스에 라벨을 연결한 후 이 라벨을 기준으로 리소스를 필터링할 수 있습니다. 라벨에 대한 정보는 청구 요금을 라벨별로 분류할 수 있는 결제 시스템으로 전달됩니다. 기본 제공되는 결제 보고서를 통해 리소스 라벨별로 비용을 필터링하고 그룹화할 수 있습니다. 라벨을 사용하여 결제 데이터 내보내기를 쿼리할 수도 있습니다.

라벨 요구사항

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

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

이러한 한도는 각 라벨의 키와 값 및 라벨이 있는 개별 Google Cloud 리소스에 적용됩니다. 한 프로젝트의 모든 리소스에 적용할 수 있는 라벨 수에는 제한이 없습니다.

라벨의 일반적인 사용 사례

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

팀 또는 비용 센터 라벨: 팀 또는 비용 센터를 기준으로 라벨을 추가하여 여러 팀(예: team:research 및 team:analytics)에서 소유한 저장소를 구별할 수 있습니다. 원가 계산이나 예산 책정 시 이 유형의 라벨을 사용할 수 있습니다.
구성요소 라벨: component:redis, component:frontend, component:ingest, component:dashboard를 예로 들 수 있습니다.
환경 또는 단계 라벨: environment:production과 environment:test를 예로 들 수 있습니다.
상태 라벨: state:active , state:readytodelete, state:archive를 예로 들 수 있습니다.
소유권 라벨: 작업을 담당하는 팀을 식별하는 데 사용됩니다(예: team:shopping-cart).

모든 API 호출의 타임스탬프 또는 개별 값과 같은 다수의 고유 라벨을 만들지 않는 것이 좋습니다. 이 접근 방식의 문제는 값이 자주 변경되거나 카탈로그를 복잡하게 하는 키로 인해 리소스를 효과적으로 필터링하고 보고하기 어렵다는 것입니다.

라벨 및 태그

라벨은 리소스에 대해 쿼리 가능한 주석으로 사용될 수 있지만 정책에 조건을 설정하는 데는 사용할 수 없습니다. 태그를 사용하면 정책을 세밀하게 제어하여 리소스에 특정 태그가 있는지 여부에 따라 정책을 조건부로 허용하거나 거부할 수 있습니다. 자세한 내용은 태그 개요를 참조하세요.

라벨 추가 및 업데이트

하나 이상의 라벨을 저장소에 추가할 수 있습니다. 기존 라벨의 값을 수정할 수도 있습니다.

저장소에 라벨을 지정하려면 다음 안내를 따르세요.

콘솔

Google Cloud 콘솔에서 저장소 페이지를 엽니다.

저장소 페이지 열기
저장소를 선택합니다.
저장소 목록 옆의 정보 패널이 열리지 않으면 정보 패널 표시를 클릭합니다.
정보 패널에서 라벨 탭을 클릭합니다.
라벨 추가 또는 수정:
1. 라벨을 추가하려면 라벨 추가를 클릭합니다. 라벨에 대해 키와 값 쌍을 지정한 후 저장을 클릭합니다.
2. 기존 라벨을 수정하려면 라벨의 값을 변경한 후 저장을 클릭합니다.

gcloud

하나 이상의 라벨을 추가 또는 수정하도록 지정할 수 있습니다.

라벨이 있으면 해당 값이 업데이트됩니다.
라벨이 없으면 라벨이 생성됩니다.
명령어에 --clear-labels 플래그가 포함되었으면 새 라벨을 추가하기 전 모든 기존 라벨이 삭제됩니다.

다음 명령어를 실행합니다.

gcloud artifacts repositories update REPOSITORY [--project=PROJECT] \
[--location=LOCATION] --update-labels="KEY=VALUE,..."

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

REPOSITORY는 저장소 이름입니다. 기본 저장소를 구성한 경우 이 플래그를 생략하여 기본값을 사용할 수 있습니다.
PROJECT는 Google Cloud 프로젝트 ID입니다. 이 플래그를 생략하면 현재 프로젝트 또는 기본 프로젝트가 사용됩니다.
LOCATION은 리전 또는 멀티 리전 위치입니다. 특정 위치의 저장소를 보려면 이 플래그를 사용합니다. 기본 위치를 구성한 경우 이 플래그를 생략하여 기본값을 사용할 수 있습니다.
KEY=VALUE,...는 키-값 쌍으로 지정된, 쉼표로 구분된 라벨 목록입니다. 예를 들면 team=team-1,product=example_product,stage=development입니다.

명령어에 대한 자세한 내용을 보려면 다음 명령어를 실행하세요.

gcloud artifacts repositories update --help

라벨별 저장소 필터링

Google Cloud 콘솔에서 또는 Google Cloud CLI를 사용하여 라벨에 따라 저장소 목록을 필터링할 수 있습니다.

콘솔

Google Cloud 콘솔에서 저장소 페이지를 엽니다.

저장소 페이지 열기
필터 필드에서 라벨을 필터 기준으로 선택한 후 키, 값 또는 키-값 쌍을 입력합니다.

예를 들어 env:dev 라벨이 있는 저장소만 표시하려면 다음 중 하나를 입력하면 됩니다.
- env 키를 입력합니다.
- dev 값을 입력합니다.
- env:dev 키-값 쌍을 입력합니다.

gcloud

라벨을 기준으로 필터링하려면 gcloud artifacts repositories list 명령어에 --filter 플래그를 사용합니다.

--filter 플래그의 값은 labels.KEY=VALUE 형식이어야 합니다. 예를 들어 env 키 및 dev 값으로 라벨로 활성 프로젝트의 저장소를 필터링하려면 다음 명령어를 실행하면 됩니다.

gcloud artifacts repositories list --filter labels.env=dev

gcloud CLI의 필터 구문에 대한 상세 설명은 gcloud topic filters 문서를 참조하세요.

라벨 삭제

라벨을 삭제하려면 다음 안내를 따르세요.

콘솔

Google Cloud 콘솔에서 저장소 페이지를 엽니다.

저장소 페이지 열기
저장소 선택을 클릭합니다.
저장소 목록 옆의 정보 패널이 열리지 않으면 정보 패널 표시를 클릭합니다.
정보 패널에서 라벨 탭을 클릭합니다.
삭제할 라벨 옆의 항목 삭제를 클릭합니다.

gcloud

특정 라벨을 삭제하거나 저장소에 대해 모든 라벨을 삭제할 수 있습니다.

특정 라벨을 삭제하려면 다음 명령어를 실행합니다.

gcloud artifacts repositories update REPOSITORY [--project=PROJECT] \
[--location=LOCATION] --remove-labels="LABEL,..."

모든 라벨을 삭제하려면 다음 명령어를 실행합니다.

gcloud artifacts repositories update REPOSITORY \
[--project=PROJECT] [--location=LOCATION] --clear-labels

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

REPOSITORY는 저장소 이름입니다. 기본 저장소를 구성한 경우 이 플래그를 생략하여 기본값을 사용할 수 있습니다.
PROJECT는 Google Cloud 프로젝트 ID입니다. 이 플래그를 생략하면 현재 프로젝트 또는 기본 프로젝트가 사용됩니다.
LOCATION은 리전 또는 멀티 리전 위치입니다. 특정 위치의 저장소를 보려면 이 플래그를 사용합니다. 기본 위치를 구성한 경우 이 플래그를 생략하여 기본값을 사용할 수 있습니다.
LABEL,...은 각 KEY=VALUE 쌍의 키인 쉼표로 구분된 라벨 목록 입니다. 예를 들면 team,product입니다.

명령어에 대한 자세한 내용을 보려면 다음 명령어를 실행하세요.

   gcloud artifacts repositories update --help