4.6. Google Cloud의 사용자 정의 레이블 및 태그 관리


Google Cloud는 특정 OpenShift Container Platform 클러스터에 대해 생성된 리소스를 식별하고 구성하는 데 도움이 되는 레이블과 태그를 제공하여 보다 쉽게 관리할 수 있습니다.

OpenShift Container Platform 클러스터 설치 중에만 각 Google Cloud 리소스에 대한 레이블 및 태그를 정의할 수 있습니다.

중요

OpenShift Container Platform 4.17으로 업그레이드된 OpenShift Container Platform 클러스터에서는 사용자 정의 레이블 및 태그가 지원되지 않습니다.

참고

이미 추가된 태그는 업데이트할 수 없습니다. 또한 구성된 태그 키 또는 태그 값이 삭제되면 새 태그 지원 리소스 생성이 실패합니다.

사용자 정의 라벨

사용자 정의 레이블 및 OpenShift Container Platform 특정 레이블은 OpenShift Container Platform 설치 프로그램에서 생성한 리소스 및 다음과 같은 핵심 구성 요소에만 적용됩니다.

  • Google Cloud Filestore CSI Driver Operator
  • Google Cloud PD CSI Driver Operator
  • 이미지 레지스트리 Operator
  • Google Cloud용 머신 API 공급자

사용자 정의 레이블은 다른 Operator 또는 Kubernetes in-tree 구성 요소에서 생성한 리소스에 연결되지 않습니다.

사용자 정의 레이블 및 OpenShift Container Platform 레이블은 다음 Google Cloud 리소스에서 사용할 수 있습니다.

  • 컴퓨팅 디스크
  • 컴퓨팅 전달 규칙
  • 컴퓨팅 이미지
  • 컴퓨팅 인스턴스
  • DNS 관리 영역
  • filestore 백업
  • 파일 저장소 인스턴스
  • 스토리지 버킷

사용자 정의 라벨 제한

  • ComputeAddress 의 라벨은 Google Cloud 베타 버전에서 지원됩니다. OpenShift Container Platform은 리소스에 라벨을 추가하지 않습니다.

사용자 정의 태그

사용자 정의 태그는 OpenShift Container Platform 설치 프로그램에서 생성한 리소스 및 핵심 구성 요소(예: 다음 리소스)에만 적용됩니다.

  • Google Cloud FileStore CSI Driver Operator
  • Google Cloud PD CSI Driver Operator
  • 이미지 레지스트리 Operator
  • Google Cloud용 머신 API 공급자

사용자 정의 태그는 다른 Operator 또는 Kubernetes in-tree 구성 요소에서 생성한 리소스에 연결되지 않습니다.

사용자 정의 태그는 다음 Google Cloud 리소스에서 사용할 수 있습니다.

  • 컴퓨팅 디스크
  • 컴퓨팅 인스턴스
  • filestore 백업
  • 파일 저장소 인스턴스
  • 스토리지 버킷

사용자 정의 태그에 대한 제한 사항

  • Operator는 최소한의 역할로 서비스 계정을 생성하고 사용하므로 태그는 특정 서비스 계정으로 제한해서는 안 됩니다.
  • OpenShift Container Platform은 태그의 키 및 값 리소스를 생성하지 않습니다.
  • OpenShift Container Platform 특정 태그는 리소스에 추가되지 않습니다.

4.6.1. 사용자 정의 라벨 및 태그에 대한 기준

Google Cloud에 대한 사용자 정의 레이블 및 태그를 구성하기 전에 적절한 리소스 거버넌스를 보장하기 위해 이러한 태그 및 라벨 요구 사항을 충족하는 것이 중요합니다.

다음 목록에서는 사용자 정의 라벨에 대한 요구 사항을 자세히 설명합니다.

  • 레이블 키와 값은 최소 1자 이상이어야 하며 최대 63자까지 사용할 수 있습니다.
  • 레이블 키와 값은 소문자, 숫자 문자, 밑줄(_) 및 대시(-)만 포함되어야 합니다.
  • 레이블 키는 소문자로 시작해야 합니다.
  • 리소스당 최대 32개의 라벨을 구성할 수 있습니다.

    • 각 리소스에는 최대 64개의 레이블이 있으며, 여기에서 OpenShift Container Platform은 내부 사용을 위해 32개의 라벨을 예약합니다.

다음 목록에서는 사용자 정의 태그의 요구 사항을 자세히 설명합니다.

  • 태그 키와 태그 값이 이미 있어야 합니다. OpenShift Container Platform은 키와 값을 생성하지 않습니다.
  • 태그 parentIDOrganizationID 또는 ProjectID 일 수 있습니다.

    • OrganizationID 는 앞에 0이 없는 10진수로 구성되어야 합니다.
    • projectID 는 소문자, 숫자, 하이픈만 포함하는 6~30자여야 합니다.
    • projectID 는 문자로 시작해야 하며 하이픈으로 끝낼 수 없습니다.
  • 태그 키에는 대문자 및 소문자 영숫자, 하이픈(-), 밑줄(_) 및 마침표(.)만 포함되어야 합니다.
  • 태그 값에는 대문자 및 소문자 영숫자 및 다음 문자만 포함되어야 합니다.

    • A colon (:)
    • 쉼표(,)
    • 중괄호({})
    • 하이픈(-)
    • 배열()
    • 백분율 기호(%)
    • 더하기 (+)
    • 파운드 기호($)
    • 한 공간.
    • 정사각 중괄호 ([])
    • 앰퍼샌드(&)
    • 별표 (*)
    • 서명 (@)
    • 등호(=)
    • 밑줄(_)
    • 기간 (.)
  • 태그 키와 값은 영숫자 문자로 시작하고 끝나야 합니다.
  • 태그 값은 키에 대해 사전 정의된 값 중 하나여야 합니다.
  • 최대 50개의 태그를 구성할 수 있습니다.
  • 상위 리소스에서 상속되는 기존 태그 키와 동일한 값으로 태그 키를 정의하지 마십시오.

4.6.2. Google Cloud에 대한 사용자 정의 레이블 및 태그 구성

Google Cloud에 대한 사용자 정의 레이블 및 태그를 구성하면 인프라의 구성, 관리 및 자동화를 위해 키-값 쌍을 클라우드 리소스에 적용할 수 있습니다.

사전 요구 사항

  • 설치 프로그램에서는 서비스 계정에 TagUser 역할이 필요하므로 프로그램이 조직 및 프로젝트 수준에서 정의된 태그로 OpenShift Container Platform 클러스터를 생성할 수 있습니다.

프로세스

  • install-config.yaml 파일을 업데이트하여 필수 레이블 및 태그 목록을 정의합니다.

    참고

    install-config.yaml 구성 파일을 생성하는 동안 레이블 및 태그를 설정하는 경우 클러스터를 생성한 후에는 새 레이블과 태그를 생성하거나 업데이트할 수 없습니다.

    샘플 install-config.yaml 파일

    apiVersion: v1
    credentialsMode: Passthrough 
    1
    
    platform:
     gcp:
       userLabels: 
    2
    
       - key: <label_key>
    3
    
         value: <label_value>
    4
    
       userTags: 
    5
    
       - parentID: <OrganizationID/ProjectID>
    6
    
         key: <tag_key_short_name>
         value: <tag_value_short_name>
    # ...

    1
    Passthrough 모드에서 CCO(Cloud Credential Operator)는 제공된 클라우드 인증 정보를 클라우드 인증 정보를 요청하는 구성 요소에 전달합니다.
    2
    Google Cloud에서 생성된 리소스에 키와 값을 레이블로 추가합니다.
    3
    레이블 이름을 정의합니다.
    4
    레이블 콘텐츠를 정의합니다.
    5
    Google Cloud에서 생성된 리소스에 키와 값을 태그로 추가합니다.
    6
    조직 또는 프로젝트 수준에서 태그를 정의한 계층 리소스의 ID입니다.

4.6.3. Google Cloud의 사용자 정의 레이블 및 태그 쿼리

OpenShift Container Platform 클러스터를 생성한 후 다음 샘플 infrastructure.yaml 파일에 표시된 대로 infrastructure .config.openshift.io/cluster 오브젝트에서 Google Cloud 리소스에 대해 정의된 라벨 및 태그 목록에 액세스할 수 있습니다.

infrastructure.yaml 파일 샘플

apiVersion: config.openshift.io/v1
kind: Infrastructure
metadata:
 name: cluster
spec:
 platformSpec:
   type: GCP
status:
 infrastructureName: <cluster_id>
1

 platform: GCP
 platformStatus:
   gcp:
     resourceLabels:
     - key: <label_key>
       value: <label_value>
     resourceTags:
     - key: <tag_key_short_name>
       parentID: <OrganizationID/ProjectID>
       value: <tag_value_short_name>
   type: GCP

1
클러스터 설치 중에 생성된 클러스터 ID입니다.

사용자 정의 레이블과 함께 리소스에는 OpenShift Container Platform에서 정의한 레이블이 있습니다. OpenShift Container Platform 라벨 형식은 kubernetes-io-cluster-<cluster_id>:owned 입니다.

Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2026 Red Hat
맨 위로 이동