Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

관리 경계 개요

이 문서에서는 Resource Manager의 관리 경계 및 기능 구성을 소개합니다. 관리 경계는 여러 Google Cloud 프로젝트에서 동적인 태그 기반 관리 경계를 설정하여 지정된 관리 프로젝트에서 중앙 집중식 거버넌스와 검색을 허용합니다.

관리 경계 및 허브 앤 스포크 모델

Resource Manager는 정적 폴더 계층 구조 포함 외에도 동적 태그 파티션 허브 앤 스포크 관리 모델을 지원합니다.

관리 프로젝트 (허브): CapabilityConfig에서 사용 설정된 서비스의 컨트롤 플레인, Management API, 메타데이터, 교차 프로젝트 뷰를 호스팅하는 중앙 집중식 Google Cloud 프로젝트입니다.
구성원 프로젝트 (스포크): 워크로드, 서비스, 리소스가 포함된 폴더 또는 조직 전반의 Google Cloud 프로젝트입니다. 일치하는 리소스 태그를 연결하면 프로젝트가 경계에 동적으로 조인됩니다.

이 모델은 관리 범위를 물리적 폴더 계층 구조에서 분리하여 분산된 팀과 다중 프로젝트 아키텍처에 대한 교차 폴더 거버넌스를 지원합니다.

핵심 리소스

태그 기반 관리 경계는 세 가지 Resource Manager 리소스를 사용하여 조직 또는 폴더 수준에서 정의할 수 있습니다.

경계 구성 (BoundaryConfig): 조직 또는 폴더 수준에서 정의됩니다. 구성원 프로젝트를 분류하는 데 사용되는 파티셔닝 태그 키 (예: 123456789012/env)를 설정합니다. 태그 키가 구성되지 않은 경우 해당 상위 요소 아래의 경계에는 모든 하위 프로젝트가 포함됩니다.
경계 (Boundary): 조직 또는 폴더 내의 논리적 파티션입니다. 일치하는 유효 태그 값 (예: env=prod)이 있는 프로젝트 또는 상위 BoundaryConfig에 태그 키가 구성되지 않은 경우 모든 하위 프로젝트가 경계에 동적으로 포함됩니다.
기능 구성 (CapabilityConfig): 조직, 폴더 또는 프로젝트 수준에서 정의됩니다. 조직 또는 폴더 수준에서 하나 이상의 경계를 지정된 관리 프로젝트와 연결하고 경계 전반에 사용 설정된 관리 기능을 지정합니다. 프로젝트 수준에서는 경계가 없는 단일 독립형 프로젝트에 대한 관리 기능을 사용 설정합니다.

지원되는 기능

기능 구성은 다음과 같은 관리 환경을 지원합니다.

AGENT_MANAGEMENT (gcloud CLI: agent-management): Agent Registry에서 중앙 집중식 검색, ID 레지스트리, 교차 프로젝트 에이전트 거버넌스를 사용 설정합니다.

동적 멤버십 및 태그 상속

경계의 프로젝트 멤버십은 태그 및 리소스 계층 구조 변경에 따라 동적으로 업데이트됩니다.

태그 바인딩: 일치하는 태그 값을 프로젝트에 바인딩하면 프로젝트가 즉시 경계에 조인됩니다. 경계가 CapabilityConfig와 연결된 경우 해당 CapabilityConfig에서 사용 설정된 서비스는 CapabilityConfig의 관리 프로젝트를 통해 프로젝트의 리소스를 검색하고 관리합니다.
태그 상속: 상위 폴더 또는 조직에 연결된 태그는 하위 프로젝트에 상속됩니다. 하위 프로젝트는 다른 태그 값으로 명시적으로 재정의되지 않는 한 경계 멤버십을 상속합니다.
태그 삭제 또는 업데이트: 프로젝트의 태그를 바인딩 해제하거나 변경하면 기본 인프라를 삭제하지 않고 경계에서 프로젝트가 삭제됩니다.
프로젝트 및 폴더 수명 주기 변경사항: 프로젝트가 생성, 삭제 취소되거나 폴더 또는 조직으로 이동되고 (직접 또는 폴더 이동의 일부로) 경계 기준 (일치하는 태그 필터 또는 상위 BoundaryConfig에 구성된 태그 키 없음)과 일치하면 경계에 자동으로 포함됩니다. 프로젝트가 삭제되거나 이동되면 경계에서 자동으로 삭제됩니다.

단일 상위 폴더 또는 조직 내에서 경계는 상호 배타적입니다. 상위 노드의 BoundaryConfig는 단일 태그 키를 사용하고 프로젝트는 태그 키당 하나의 유효 태그 값만 가질 수 있으므로 프로젝트는 상위 노드당 최대 하나의 경계에 속할 수 있습니다. 리소스 계층 구조의 여러 상위 노드 (예: 조직 및 하위 폴더)에 경계를 구성하는 경우 하위 프로젝트는 각 상위 수준에서 최대 하나의 경계에 속할 수 있습니다.