리소스 설정 개요

리소스 설정을 사용하여 Google Cloud 프로젝트, 폴더, 조직의 설정을 중앙에서 구성할 수 있습니다. 이러한 설정은 리소스 계층 구조의 하위 요소에서 상속됩니다. Google에서 각 설정을 만들고 관리합니다.

리소스 설정

리소스 설정은 구성할 수 있는 Google Cloud 리소스나 서비스의 측정기준을 나타냅니다. 예를 들어 Cloud Storage 버킷 생성 위치 설정에 따라 새 버킷 리소스가 생성되는 기본 위치가 결정될 수 있습니다.

각 리소스 설정에는 다음과 같은 주요 속성이 있습니다.

  • 이름: 설정의 값을 구성할 때 사용되는 설정의 전역적으로 고유한 식별자입니다.

  • 메타데이터: 리소스 설정에 대한 Google 관리 정보입니다. 리소스 설정의 메타데이터에는 다음과 같은 필드가 포함됩니다.

    • 데이터 유형: 이 설정에 구성할 수 있는 값 유형입니다. 가능한 데이터 유형에는 부울, 문자열, 문자열 집합, 열거형이 포함되어 있습니다.

    • 기본값: 조직 내에 다른 값이 설정되지 않은 경우 Google에서 관리하는 설정의 기본값입니다.

    • 읽기 전용: Google에서 이 설정을 읽기 전용으로 설정했는지 여부를 나타내는 플래그입니다. 리소스 설정이 읽기 전용인 경우에는 이 설정 값을 수정할 수 없습니다. 설정은 마이그레이션 및 지원 중단에만 읽기 전용으로 설정됩니다. 이 플래그를 변경하기 전에 Google에서 경고를 제공합니다.

  • 로컬 값: 리소스와 연결된 설정의 특정 값입니다.

  • 유효 값: 리소스 계층 구조에서 상속된 리소스 설정을 평가한 후의 설정 값입니다.

특정 조직, 폴더 또는 프로젝트에서 사용할 수 있는 설정 목록을 보려면 리소스 설정 뷰어 또는 리소스 설정 관리자 Identity and Access Management 역할이 필요합니다. 이러한 역할에 대한 자세한 내용은 필수 권한을 참조하세요.

리소스 설정 가용성은 리소스 설정의 출시 상태에 따라 조직마다 다를 수 있습니다.

리소스 설정 예시

다음은 리소스 설정이 표시되는 방식의 예시입니다.

# Setting
{
  "name": "net-preferredDnsServers",
  "metadata": {
    "displayName": "Preferred DNS Servers",
    "description": "The DNS servers to be used by VMs associated with this resource.",
    "read_only": false,
    "data_type" : "STRING_SET",
    "default_value" : {
      "string_set_value" : {
        "values" : [ "8.8.8.8" ],
      }
    }
  }
}

이름 지정

리소스 설정에는 전역적으로 고유한 settings/SETTING_ID 형식의 닉네임이 사용됩니다. 예를 들어 가상 머신의 초기 시작 이미지를 제어하는 리소스 설정의 닉네임은 settings/compute-vmStartupImage일 수 있습니다.

설정의 상대 리소스 이름은 설정 닉네임에 숫자 리소스 ID를 추가합니다. 예를 들어 organizations/12345678901에 대한 위 settings/compute-vmStartupImage 설정의 상대 리소스 이름은 organizations/12345678901/settings/compute-vmStartupImage입니다.

닉네임이 동일한 설정은 상대적 리소스 이름이 서로 다르더라도 Google Cloud에서 동일한 것으로 간주됩니다. 상대적 리소스 이름에 포함된 리소스는 이름이 지정된 리소스에 대한 해당 설정의 가용성만 나타냅니다.

로컬 설정 값

특정 리소스 설정에 직접 적용되는 설정 값을 로컬 설정 값이라고 합니다. Resource Settings API를 사용하여 리소스 설정의 로컬 값을 직접 수정할 수 있습니다.

다음은 로컬 설정 값이 포함된 리소스 설정 예시입니다.

# Setting
{
  "name" : "folders/123/settings/net-preferredDnsServers"
  "localValue": {
    "stringSetValue": {
      "values": ["8.8.8.8", "8.8.4.4"]
    }
  }
}

유효 설정 값

리소스의 로컬 설정 값은 리소스 계층 구조의 모든 리소스 하위 항목에 상속됩니다. 이러한 하위 항목 중 하나에 로컬 설정 값이 있으면 상속된 설정 값을 재정의합니다. 리소스 또는 그 하위 항목에 로컬 설정 값을 설정하지 않은 경우 해당 설정에 Google에서 정의한 기본값이 사용됩니다.

리소스 설정이 평가되고 결과는 유효한 설정 값입니다. 이 값은 특정 리소스의 모든 상속과 로컬 값 설정의 최종 결과를 보여줍니다. 유효 설정 값을 결정하는 규칙은 다음과 같이 평가됩니다.

  1. 리소스에 지정된 리소스 설정 값이 있는 경우, 이 값이 유효 값이며 상속된 값이 재정의됩니다.

  2. 리소스에 이 리소스 설정 값이 없으면 리소스의 상위 항목에 해당 설정의 값이 있는 경우 가장 가까운 상위 항목과 연결된 값이 유효 값입니다.

  3. 이 리소스 또는 상위 항목 모두 이 리소스 설정 값이 없고 설정에 Google에서 관리하는 기본값이 있는 경우 이 기본값이 유효 값입니다.

  4. 리소스 및 상위 항목에 이 리소스 설정 값이 없고 값에 Google 관리 기본값이 없으면 이 리소스에는 이 설정에 대한 유효한 값이 없습니다.

유효 값이 없는 리소스 설정

리소스 설정에 Google에서 관리하는 기본값이 없으면 이 설정에 유효한 값이 없는 리소스가 있을 수 있습니다. 이전 버전과 호환되는 방식으로 가능한 경우 새 리소스 설정에는 Google에서 관리하는 기본값이 없습니다. 따라서 새 설정은 기존 서비스를 중단하지 않습니다.

빈 값 및 설정되지 않은 값

리소스 설정 값이 비어 있으면 리소스 설정 값이 비어 있는 것으로 간주됩니다. 예를 들어 ""는 빈 문자열입니다. 빈 값은 계속 유효 설정 값 평가에 따른 값으로 고려되며 상속을 재정의합니다.

로컬 값이 설정되지 않으면 리소스 설정이 설정되지 않은 상태로 유지됩니다. 이 리소스는 리소스 설정 값을 상속합니다.

다음 단계