이 페이지에서는 배포를 만들기 위해 사용할 수 있는 구성을 만드는 방법을 설명합니다. 배포에 대한 자세한 내용은 배포 만들기를 참조하세요.
구성 파일은 배포를 구성하는 모든 Google Cloud 리소스를 정의합니다. 배포를 만들려면 구성 파일이 있어야 합니다. 구성 파일은 YAML 구문으로 작성해야 합니다.
시작하기 전에
- 이 가이드의 명령줄 예시를 사용하려면 'gcloud' 명령줄 도구를 설치합니다.
- 이 가이드의 API 예시를 사용하려면 API 액세스를 설정합니다.
- 구성 파일의 기본 사항을 이해합니다.
구성 파일 구조
구성 파일은 YAML 형식으로 작성되며, 다음 구조를 갖습니다.
# imported templates, if applicable
imports:
# path relative to the configuration file
- path: path/to/template.jinja
name: my-template
- path: path/to/another/template.py
name: another-template
resources:
- name: NAME_OF_RESOURCE
type: TYPE_OF_RESOURCE
properties:
property-a: value
property-b: value
...
property-z: value
- name: NAME_OF_RESOURCE
type: TYPE_OF_RESOURCE
properties:
property-a: value
property-b: value
...
property-z: value
각 섹션은 배포의 각기 다른 부분을 정의합니다.
imports
섹션은 구성에서 사용되는 템플릿 파일 목록입니다. Deployment Manager는 가져온 모든 템플릿을 재귀적으로 확장하여 최종 구성을 형성합니다.resources
섹션은 이 배포를 구성하는 리소스 목록입니다. 가능한 리소스는 다음과 같습니다.
또한 outputs
섹션 및 metadata
섹션과 같은 다른 선택적인 섹션이 포함될 수 있습니다. outputs
섹션에서는 최종 사용자의 출력으로 또는 같은 배포에 있는 다른 템플릿의 출력으로 템플릿 및 구성의 데이터를 노출할 수 있습니다. 반면에 metadata
섹션에서는 리소스 간 명시적 종속 항목 설정과 같은 다른 기능을 사용할 수 있습니다.
최소한 구성은 resources
섹션과 그 다음의 리소스 목록을 항상 선언해야 합니다. 다른 섹션은 선택 사항입니다.
리소스 유형 선언
구성의 각 리소스는 유형으로 지정해야 합니다. 유형은 Google 관리형 기본 유형, 복합 유형, 유형 공급자 또는 가져온 템플릿일 수 있습니다.
Google 관리 기본 유형은 Google Cloud 리소스로 확인되는 유형입니다. 예를 들어 Cloud SQL 인스턴스 또는 Cloud Storage 버킷은 Google 관리형 기본 유형입니다. 이러한 유형은 다음 구문을 사용하여 선언할 수 있습니다.
type: <api>.<api-version>.<resource-type>
예를 들어 Compute Engine 인스턴스는 다음 유형을 포함합니다.
type: compute.v1.instance
BigQuery 데이터베이스의 경우에는 다음 유형일 수 있습니다.
type: bigquery.v2.dataset
지원되는 모든 유형 목록을 보려면 다음 명령어를 사용하세요.
gcloud deployment-manager types list
지원되는 Google에서 관리되는 기본 유형의 전체 목록은 지원되는 리소스 유형을 참조하세요.
복합 또는 유형 공급자를 사용하는 경우 유형을 다음과 같이 선언합니다.
# Composite type
resources:
- name: my-composite-type
type: [PROJECT]/composite:[TYPE_NAME]
유형 공급자에 대해서는 다음과 같이 선언합니다.
# Base type
resources:
- name: my-base-type
type: [PROJECT_ID]/[TYPE_PROVIDER_NAME]:[TYPE_NAME]
또한 Google 관리형 유형 공급자(베타)를 사용하여 리소스를 만들 수도 있습니다. Google Cloud 유형 공급자 목록은 지원되는 유형 공급자를 참조하세요.
템플릿을 사용하려는 경우 템플릿을 유형으로 선언하고, 템플릿 이름 또는 경로를 type
의 값으로 지정합니다.
예를 들어 다음 구성은 my_vm_template.jinja라는 템플릿을 가져오고 유형으로 제공합니다.
imports:
- path: path/to/template/my_vm_template.jinja
name: my-template.jinja
resources:
- name: my-first-virtual-machine
type: my-template.jinja
템플릿에 대한 자세한 내용은 기본 템플릿 만들기를 참조하세요.
리소스 속성 선언
리소스 유형을 선언한 후에는 리소스에 name
을 지정하고 리소스에 필요한 속성을 지정해야 합니다. 예를 들어 다음 구성 파일에서는 vm-created-by-deployment-manager
라는 가상 머신 인스턴스와 여기에서 사용할 속성을 정의합니다. Deployment Manager는 이 정보를 사용하여 이러한 속성이 포함된 VM 인스턴스를 만듭니다.
리소스의 properties
를 확인하려면 리소스의 API 참고 리소스를 사용합니다.
- 리소스의
insert
또는create
메서드에서 요청 형식을 확인합니다. - 요청 URI에 영역이 포함된 경우 영역을 속성에 추가합니다.
배열의 경우 YAML 목록 구문을 사용해서 배열 요소를 나열합니다. 예를 들어 API를 사용해서 Compute Engine 인스턴스를 만드는 경우, 인스턴스에 연결하려는 디스크 배열을 다음 형식으로 제공해야 합니다.
"disks": [ { "type": "PERSISTENT", "deviceName": "disk1", ... }, { "type": "PERSISTENT", "deviceName": "disk2", ... } ]
Deployment Manager 구성에서 다음 구문을 사용하여 이러한 디스크를 추가합니다.
disks: - deviceName: disk1 type: PERSISTENT ... - deviceName: disk2 type: PERSISTENT
또한 해당 리소스의 쓰기 가능 속성을 제공할 수 있습니다. 속성이 쓰기 가능한지 확인하려면 리소스 유형에 대한 API 참고 문서를 사용합니다. 예를 들어 Compute Engine 참조는 특정 속성을 출력 전용으로 표시합니다. 이러한 속성은 변경할 수 없으므로, 개발자가 자신의 구성에 정의할 수 없습니다.
일부 API는 리소스를 만들기 위한 최소 속성 집합이 필요합니다. 예를 들어 Compute Engine 영구 디스크는 새 디스크를 만들 때 디스크 이름, 이미지 소스, 디스크 크기 등이 필요합니다. 특정 리소스에 대한 자세한 내용은 해당 리소스에 대한 API 참조를 검토하세요.
템플릿 속성 정의
구성에서 사용할 템플릿을 가져올 경우 properties
섹션을 사용하여 리소스 속성 대신 템플릿 속성 값을 정의합니다. 또는 템플릿에 템플릿 속성이 없으면 properties
섹션을 함께 생략할 수 있습니다.
다른 Google Cloud 서비스에서 리소스 만들기
마지막으로 구성 파일은 다른 Google Cloud 서비스에서 리소스를 만들 수 있습니다. 예를 들어 다음 구성 파일은 Compute Engine 및 BigQuery에서 리소스를 만듭니다.
지원되는 리소스 유형 및 속성
지원되는 리소스 유형 문서에서 지원되는 Google에서 관리되는 리소스 전체 목록을 참조하세요.