이 페이지는 Cloud Translation API를 통해 번역되었습니다.

라벨 워크플로

라벨은 관련 워크플로를 식별하고 그룹화하며 워크플로에 관한 메타데이터를 저장하는 데 사용할 수 있는 키-값 쌍입니다. 워크플로에 여러 라벨을 지정할 수 있습니다.

이 페이지에서는 워크플로에서 라벨을 사용하는 방법을 설명합니다. 워크플로의 라벨을 추가, 업데이트, 삭제하는 방법도 설명합니다.

조직에서 보고, 감사, 액세스 제어를 위해 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 호출의 타임스탬프 또는 개별 값과 같은 다수의 고유 라벨을 만들지 않는 것이 좋습니다. 이 접근 방식의 문제는 값이 자주 변경되거나 카탈로그를 복잡하게 하는 키로 인해 리소스를 효과적으로 필터링하고 보고하기 어렵다는 것입니다.

라벨 및 태그

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

라벨 추가 또는 업데이트

워크플로를 만들 때 워크플로에 하나 이상의 라벨을 추가할 수 있습니다. 워크플로를 업데이트할 때 라벨을 추가하거나 수정할 수도 있습니다.

기존 라벨을 업데이트하거나 새 라벨을 추가할 경우 새 라벨이 적용될 때까지 최대 10분까지 걸릴 수 있습니다.

라벨별 워크플로 필터링

라벨을 기준으로 필터링하여 특정 워크플로를 검색하고 나열할 수 있습니다.

콘솔

Google Cloud 콘솔에서 Workflows 페이지로 이동합니다.

Workflows로 이동
필터 필드에서 라벨을 필터 기준으로 선택하고 값 목록에서 키-값 쌍을 선택합니다.

gcloud

--filter 플래그를 gcloud workflows list 명령어와 함께 사용합니다.

gcloud workflows list \
    --filter labels.KEY=VALUE

KEY 및 VALUE를 라벨 키-값 쌍으로 바꿉니다.

Google Cloud CLI의 필터 구문에 대한 자세한 내용은 gcloud topic filters를 참고하세요.

워크플로 라벨은 워크플로 실행에 의해 상속됩니다. 실행 라벨을 보려면 workflows.executions.list 메서드를 사용하여 워크플로 실행을 나열 및 필터링하세요.

라벨 삭제

Google Cloud 콘솔을 사용하여 특정 라벨을 삭제하거나 gcloud CLI를 사용하여 워크플로에서 모든 라벨을 삭제할 수 있습니다.

콘솔

Google Cloud 콘솔에서 Workflows 페이지로 이동합니다.

Workflows로 이동
업데이트할 워크플로의 이름을 클릭합니다.

워크플로 세부정보 페이지가 표시됩니다.
수정을 클릭합니다.

워크플로 수정 페이지가 표시됩니다.
삭제하려는 라벨 옆에 있는 항목 삭제를 클릭합니다.
다음을 클릭합니다.
워크플로를 재배포하려면 배포를 클릭합니다.

gcloud

빈 값과 gcloud workflows deploy 명령어를 사용하여 --labels 플래그를 사용합니다.

gcloud workflows deploy WORKFLOW_NAME \
    --labels="" \
    --source=YAML_OR_JSON_SOURCE_FILE

다음을 바꿉니다.

WORKFLOW_NAME: 워크플로의 이름입니다.
YAML_OR_JSON_SOURCE_FILE: YAML 또는 JSON 형식의 워크플로 소스 파일입니다. 예를 들면 myFirstWorkflow.yaml입니다.