콘텐츠로 이동
AggregaAggrega
언어 선택: 한국어
이 페이지는 기계 번역되었습니다. 영어 원문 읽기.

Terraform Provider

terraform 프로바이더는 Aggrega Recipes를 Terraform 구성으로 렌더링합니다. 이 프로바이더는 구성을 출력할 뿐 Terraform을 실행하지 않습니다. Aggrega 빌드는 AOT(ahead-of-time) 컴파일이므로 terraform apply 이후에만 존재하는 리소스 ID, IP 주소, 출력값을 확인할 수 없습니다. Terraform의 ${ ... } 보간은 수정되지 않은 채 결정적인 포인터 문자열로 그대로 전달되며, 이후 Terraform 런타임이 이를 해석합니다. 이 프로바이더는 오프라인이며 밀폐형(hermetic)입니다. 네트워크에 접근하지 않으며 terraform이나 tofu를 호출하지 않습니다.

boundary의 배치 방식

terraform provider는 boundary의 component들을 나란히 내보내는 대신 하나로 구성합니다. 이 provider가 렌더링하는 모든 boundary에는 루트 구성 aggrega.modules.tf가 하나 생기며, 여기에서 렌더링되는 각 component는 module 블록으로 선언되고 그 source는 modules/ 아래에 있는 해당 component 고유의 하위 디렉터리입니다:

module "cache" {
source = "./modules/cache"
}
module "db" {
source = "./modules/db"
allocated_storage = 100
db_name = "appdb"
engine_version = "11.4"
}

각 component 고유의 파일, 즉 vendoring된 모듈 또는 직접 작성한 본문과 출처 스탬프는 그 블록이 가리키는 하위 디렉터리에 놓입니다. 이는 루트가 자식을 구성하는 Terraform의 표준 구조이며, 그 관례는 중첩 모듈이 modules/ 하위 디렉터리 아래에 있는 것입니다. component를 하나 담든 여러 개 담든 모든 terraform boundary가 이 배치를 따릅니다. component 또는 boundary에 연결된 Feature는 같은 루트 구성 안에서 자체 module 블록으로 선언됩니다. 연결된 Feature의 출력이 놓이는 위치를 참고하십시오.

이 형태는 겉모양이 아니라 실질적인 역할을 하며, 그 이유는 두 가지입니다.

Terraform 의존성 그래프는 구성별로 존재합니다. 서로 다른 디렉터리로 출력된 Components는 서로 관계가 없는 별개의 그래프입니다. 참조도 depends_on도 한쪽에서 다른 쪽으로 닿을 수 없으며, 단일 terraform plan이 둘을 함께 보지 못합니다. 하나의 루트가 각 컴포넌트를 자식 모듈로 구성하면 하나의 경계 전체가 하나의 그래프와 하나의 plan에 들어갑니다.

component의 파일은 그 component 고유의 디렉터리로 주소가 정해집니다. 한 boundary 안의 두 component가 main.tf, variables.tf처럼 이름이 같은 파일을 쓰는 모듈을 vendoring할 수 있으며, 각 파일 세트는 하나의 경로를 두고 다투는 대신 각자의 component 디렉터리 아래에 놓입니다.

provider가 구성되는 위치

provider의 구성, 즉 provider 블록은 루트에 작성되며 component의 모듈 안에는 절대 작성되지 않습니다. Terraform 문서에 따르면 다른 모듈에서 호출되도록 만든 모듈은 provider 블록을 포함해서는 안 되며, 호출된 모듈은 그 모듈이 사용하는 각 provider에 대해 루트의 기본 구성을 상속합니다. 자체 provider 블록을 가진 모듈은 depends_on, count, for_each와 함께 호출할 수 없습니다. 그리고 이 provider는 아래 배포 순서에서 설명하듯이 같은 루트의 다른 component가 더 이른 syncWave를 가질 때마다 component의 module 블록에 depends_on을 작성합니다. 그러면 Terraform은 아무것도 plan하기 전에 구성을 불러오는 단계에서 구성 전체를 거부합니다.

따라서 provider에 구성이 필요한 Recipe는 그 구성을 spec.boundary.artifacts 아래의 파일로 작성합니다. 그러한 각 파일은 aggrega.modules.tf 옆에 한 번 작성되고, Terraform은 이를 루트 구성과 함께 읽습니다. component의 모듈에는 provider의 소스와 버전을 선언하는 required_providers만 남습니다:

infra/terraform/
aggrega.modules.tf
provider-azurerm.tf
modules/
gateway/main.tf

하나의 루트에 속하며 같은 파일을 같은 바이트로 선언하는 Components는 하나의 사본을 공유합니다. 같은 이름에 다른 바이트가 있으면 빌드가 중단됩니다. 모듈의 리소스는 그 하나의 구성을 기준으로 기록되므로, Terraform이 그 리소스를 삭제할 때 사용하는 것도 이 구성입니다. 그 파일을 선언하는 마지막 컴포넌트를 제거하는 Release는 파일도 함께 제거하며, 그러면 Terraform은 해당 모듈이 생성한 것의 삭제를 plan하기를 거부하고 provider를 구성하는 provider 블록을 요구합니다. 그러한 마지막 컴포넌트를 제거하기 전에 해당 리소스를 먼저 삭제하십시오.

component의 입력이 제공되는 위치

component의 입력은 루트 구성에 있는 그 module 블록의 인수이며, 입력이 작성되는 곳은 그곳뿐입니다. 컴파일러가 모듈의 입력을 제공하는 경우, 즉 source:로 모듈을 vendoring하는 Recipe의 경우 블록에 인수가 있습니다. Recipe가 구성 본문을 직접 작성하고 값을 그 본문 안에 해석해 넣은 경우에는 컴파일러가 전달할 것이 남지 않으므로 블록이 비어 있습니다.

모듈 인수는 Terraform이 평가하는 위치이며, 그래서 값이 그곳으로 갑니다. Recipe가 제공하는 ${ ... } 포인터는 리터럴 문자열로 모듈에 전달되는 대신 그곳에서 해석됩니다. 해석의 기준은 루트 구성입니다. 참조는 그 구성이 선언하는 것, 즉 module.<name>.<output> 형태로 그 구성의 module 블록 중 하나를 가리키며, 구성이 선언하지 않은 것에 대한 참조는 plan 시점에 누락된 대상을 명시하는 명확한 오류가 됩니다.

따라서 component 고유의 디렉터리는 배포된 상태 그대로 plan할 수 있는 구성이 아닙니다. 그 입력은 한 단계 위인 루트에 작성되어 있으므로, modules/<component>에서 엔진을 실행하면 다른 것을 plan하게 됩니다. 두 결과 중 어느 쪽이 될지는 모듈 자체의 variable 블록에 달려 있습니다:

  • default를 선언하지 않은 입력이 하나라도 있으면 plan은 명확하게 실패합니다. No value for required variable이 설정되지 않은 각 변수와 그 줄을 명시하고, Terraform 자체의 -var / -var-file 해결책을 제시합니다.
  • 모든 입력이 default를 가지고 있으면 plan은 성공하며, 루트 구성이 제공하는 값이 아니라 모듈의 기본값으로 빌드합니다. 아무런 경고도 없으므로 반드시 알아 두어야 하는 경우입니다. 올바르게 보이는 plan이 아무도 요청하지 않은 구성을 설명하고 있는 것입니다.

대신 boundary 자체의 출력 디렉터리, 즉 modules/ 바로 위에서 aggrega.modules.tf를 담고 있는 디렉터리를 plan하십시오. 배포의 값이 있는 곳이 그곳이며, 하나의 plan이 boundary 전체를 볼 수 있는 유일한 곳입니다.

다른 component가 게시한 값 사용하기

uses 엣지로 다른 component에 연결된 component는 자체 .context.inject 파이프(또는 .context.uses.<alias>.provides.<name>)를 통해 그 component가 게시한 값을 읽습니다. 읽는 것은 컴파일러가 해석하지 않고 전달하는 문자열이며, 그 문자열이 놓이는 곳은 Recipe가 그것을 작성한 스코프에서 Terraform이 평가하는 텍스트입니다. terraform boundary에는 그러한 스코프가 두 개 있으며, component 간 참조에 필요한 모듈 호출을 선언하는 것은 그중 하나뿐입니다:

  • 루트 구성은 모든 기여자를 module 블록으로 선언하므로 module.<name>.<output>이 그곳에서 해석됩니다.
  • component 고유의 디렉터리는 모듈 호출을 전혀 선언하지 않으므로, 그곳에서 module.<name>.<output>은 아무것도 가리키지 않습니다. <name>이 무엇이든 마찬가지입니다. 올바른 이름으로 바꾸어도 달라지는 것은 없습니다. 빠진 것은 철자가 아니라 선언이기 때문입니다.

따라서 사용된 참조가 해석될 수 있는지는 사용하는 쪽 Recipe의 입력 종류가 결정하며, 사용되는 값은 이를 결정하지 않습니다.

값을 사용하는 Recipe는 source: Recipe로 작성하십시오. 그 valuesMapping:은 루트 구성에 있는 자체 module 블록의 인수가 됩니다. 이곳은 평가되면서 동시에 이웃이 선언된 스코프 안에 있는 유일한 위치입니다.

예제 한 쌍

생산자는 자체 모듈 호출을 가리키는 주소를 게시하며, 이는 소비자의 스코프가 선언하는 형태입니다. .context.instance_id는 provides 평가 범위에 있으며, 배포의 Aggregate가 선언하는 component의 경우 그 component의 module 블록이 가지는 이름입니다:

# Recipe — the producer. Its vendored module declares `output "endpoint"`.
spec:
capability: terraform
implements: example/storage/object-store:1.0.0
source: ./module
valuesMapping: |
bucket: "{{ .values.bucket }}"
provides:
endpoint: "${module.{{ .context.instance_id }}.endpoint}"

소비자는 입력을 선언하는 모듈을 vendoring하고, 주입된 값을 그 입력에 매핑합니다:

# Recipe — the consumer. Its vendored module declares `variable "store_endpoint"`.
spec:
capability: terraform
implements: example/compute/reporting-api:1.0.0
source: ./module
valuesMapping: |
store_endpoint: "{{ .context.inject.env.STORE_ENDPOINT }}"

Aggregate는 엣지가 전달하는 게시된 키를 명시하여 둘을 연결합니다:

spec:
components:
store:
type: example/storage/object-store
values:
bucket: app-artifacts
api:
type: example/compute/reporting-api
uses:
store:
store:
target: store
inject:
env:
- in: STORE_ENDPOINT
from: endpoint

빌드는 참조와 그 대상이 함께 선언된 하나의 루트 구성을 내보냅니다:

module "api" {
source = "./modules/api"
store_endpoint = "${module.store.endpoint}"
}
module "store" {
source = "./modules/store"
bucket = "app-artifacts"
}

같은 구성이 module "store"를 선언하므로 Terraform은 module.store.endpoint를 해석하며, 그 값은 일반 입력으로 소비자의 모듈에 전달됩니다.

aws-rds-and-ecs-service 예제는 표준 라이브러리 Recipes로 이 한 쌍을 빌드합니다. 게시된 RDS 모듈로 프로비저닝되는 PostgreSQL 데이터베이스와 Amazon ECS에서 실행되는 서버로 구성되며, 서버의 environment 인수는 module "db"를 선언하는 루트 구성에서 ${module.db.db_instance_address}를 전달합니다.

이것이 잘못되는 세 가지 경우와 각각의 모습

자체 본문을 작성하는 Recipe는 컴포넌트 간 참조를 소비할 수 없습니다. artifacts: Recipe는 자신이 작성하는 본문에 값을 해석해 넣고, 그 본문은 컴포넌트 자체 디렉터리로 출력됩니다. 그러면 참조는 모듈 호출을 하나도 선언하지 않는 범위에 놓이게 됩니다:

Error: Reference to undeclared module
on modules/api/main.tf line 11, in output "seen":
11: value = "${module.store.endpoint}"
No module call named "store" is declared in module.api.

이를 고치는 철자는 없습니다. 중첩 모듈의 표현식은 형제 모듈을 전혀 이름으로 가리킬 수 없기 때문입니다. 중첩 모듈은 이웃의 값을 입력으로만 받으며, 이는 소스 경로가 이미 제공하는 module 블록 인수입니다. 다른 컴포넌트가 게시한 값을 소비하는 컴포넌트는 source: Recipe로 작성합니다.

생산자 자체 모듈 내부의 무언가를 가리키는 주소는 그 모듈이 아니라 루트를 기준으로 해석됩니다. aws_db_instance.this.endpoint라고 쓴 provides 항목은 생산자의 모듈이 선언하는 리소스를 가리킵니다. 보간으로 작성하면 소비자의 인수가 놓인 위치, 즉 루트에서 평가됩니다:

Error: Reference to undeclared resource
on aggrega.modules.tf line 19, in module "api":
19: store_endpoint = "${aws_db_instance.this.endpoint}"
There is no managed resource "aws_db_instance" "this" definition in the root module.

모듈의 리소스 안으로 직접 접근하는 대신 ${module.<...>.<output>}를 게시하고 해당 값에 대한 output 블록을 모듈에 추가합니다.

보간이 없는 provides 항목은 텍스트로 전달됩니다. 이것은 실패하지 않는 경우입니다. 컴파일러는 문자열을 전달할 뿐 포인터와 리터럴을 구별할 수 없으므로, ${ ... } 없이 작성한 aws_db_instance.this.endpoint는 따옴표로 묶인 문자열로 렌더링되고, 빌드는 성공하며, 엔진의 검증도 통과하고, 소비자는 aws_db_instance.this.endpoint라는 문자들을 받습니다. 값을 참조로 의도할 때는 항상 ${ ... } 래퍼를 작성하십시오. 이 래퍼가 문자열을 Terraform이 평가할 대상으로 표시합니다.

의존하기 전에 알아 둘 만한 한계 하나

.context.instance_id는 컴포넌트의 식별자를 나타내며, module 블록의 이름은 컴포넌트의 파일이 놓인 디렉터리에서 파생됩니다. 배포 자체의 Aggregate가 선언하는 컴포넌트의 경우, 이 둘은 같은 이름입니다. 다른 Aggregate에서 합성되어 들어온 컴포넌트의 경우에는 그렇지 않습니다. 합성된 식별자와 모듈 이름은 각자의 두 알파벳으로 서로 다르게 기록되며, 이때 참조는 조용히 넘어가지 않고 루트에서 명시적으로 실패합니다:

Error: Reference to undeclared module
on aggrega.modules.tf line 25, in module "api":
25: store_endpoint = "${module.nested-zdinner.endpoint}"
No module call named "nested-zdinner" is declared in the root module.

다른 컴포넌트가 주소를 해석하는 생산자는 그것을 소비하는 컴포넌트와 함께 배포 자체의 Aggregate에 선언하십시오.

연결된 Feature의 출력이 놓이는 위치

자체 구성을 렌더링하는 Feature 연결은 자체 모듈을 받으며, 이 모듈은 옆에 있는 컴포넌트들과 같은 루트 구성에 선언됩니다. 바로 이것이 그 구성을 배포의 일부로 만듭니다. Terraform은 디렉터리에 직접 놓인 파일만 로드하고 중첩 디렉터리는 명시적으로 호출해야 하는 완전히 별개의 모듈로 취급하므로, 연결의 파일은 루트가 그 파일이 놓인 디렉터리를 가리키는 블록을 선언하기 때문에 읽힙니다.

연결의 모듈 디렉터리는 컴포넌트의 디렉터리 옆에, modules/ 아래 한 단계에 놓이며, 이를 식별하는 두 가지, 즉 이를 호스팅하는 컴포넌트와 연결 시 사용된 이름을 --로 이어 붙인 이름을 가집니다. 따라서 aux라는 연결을 가진 컴포넌트 api의 경우 루트 구성은 두 개의 모듈을 선언합니다:

module "api--aux" {
source = "./modules/api--aux"
}
module "api" {
source = "./modules/api"
}

컴포넌트가 아닌 경계에 연결된 Feature는 이름으로 삼을 호스트 컴포넌트가 없으므로, 그 디렉터리는 자체 이름만으로 구성됩니다. 컴포넌트 api를 담은 경계에 aux라는 연결이 있으면 ./modules/api 옆에 ./modules/aux가 생깁니다.

내부가 아니라 옆에 두는 이유. Terraform은 모듈 디렉터리의 모든 최상위 파일을 하나의 네임스페이스로 병합합니다. output, variable, resource, locals 모두 마찬가지입니다. 따라서 디렉터리를 공유하는 두 기여자는 파일 이름이 무엇이든 둘 다 선언하는 모든 이름에서 충돌합니다. 각자 디렉터리를 갖는 것이 이들을 분리합니다. 내부가 아닌 옆에 두는 것은 중첩 모듈에 대한 Terraform 자체 지침이 요구하는 바이기도 합니다. 즉, 모듈이 서로를 직접 호출하여 깊게 중첩된 모듈 트리를 만드는 대신 호출자가 이들을 합성할 수 있어야 합니다.

결합은 좌표별로 이스케이프됩니다. 두 좌표는 각각 결합되기 전에 디렉터리 알파벳으로 기록되므로, --를 포함하는 좌표도 결합과 혼동되지 않습니다. 연결 c를 가진 a--b라는 호스트는 연결 b--c를 가진 호스트 a와 구별됩니다. 대소문자 ASCII 문자, 숫자, 마침표, 밑줄은 작성된 그대로 통과합니다. 작성한 하이픈은 그 뒤 문자가 이들 중 하나인 경우 유지되며, 그 밖의 모든 것은 이스케이프됩니다. 같은 규칙과 같은 알파벳이 차트 대상의 하위 디렉터리를 생성하므로, 한 연결의 디렉터리는 두 대상 중 어느 쪽이 렌더링하든 같은 방식으로 표기됩니다.

블록의 이름은 그 source가 가리키는 디렉터리에서 파생되며, 모듈 이름에 대한 Terraform 문법을 벗어나는 각 문자는 밑줄로 대체됩니다. 이 매핑은 일대일이 아니므로, 두 기여자가 하나의 모듈 이름에 도달하는 경우 빌드는 Terraform이 거부할 구성을 출력하는 대신 중단하고 두 기여자의 이름을 모두 알립니다.

연결이 자체 모듈이라는 점에서 세 가지가 따라옵니다.

입력은 자체 매핑의 것입니다. FeatureRecipe가 모듈을 소스로 삼고 valuesMapping을 선언하는 연결은, 컴포넌트의 소스 모듈이 값을 받는 방식과 같이, 그 매핑이 생성하는 값이 자체 module 블록의 인수로 기록됩니다. valuesMapping을 선언하지 않는 FeatureRecipe는 모듈에 인수를 전달하지 않습니다. 모듈이 default와 함께 선언한 변수는 그 기본값을 사용하고, 기본값 없이 선언된 변수는 설정되지 않은 채로 남으므로 Terraform이 계획을 거부합니다.

리소스는 경계의 단일 의존성 그래프에 놓입니다. 참조나 depends_on은 연결과 그것이 연결된 컴포넌트 사이에 닿으며, 하나의 terraform plan이 둘 다 봅니다. 이는 루트가 자식을 합성하는 구조가 같은 이유로 컴포넌트에 제공하는 것과 같은 속성입니다.

최상위 이름은 자체의 것입니다. 위에서 설명한 네임스페이스 병합은 디렉터리 단위이므로, 자체 디렉터리에 놓인 기여자는 이웃과 다투지 않고 자신의 output, variable, resource, locals 이름을 선언합니다. 따라서 연결은 호스트가 이미 선언한 이름을 재사용할 수 있으며, 어느 쪽도 상대가 무엇을 어떻게 이름 지었는지 알 필요가 없습니다.

이 대상이 요구하지 않는 것에 유의하십시오. 차트 대상의 제약은 다르며, 공유 레이아웃은 실제보다 더 많은 것을 암시하는 것처럼 읽힐 수 있기 때문입니다. 다른 기여자의 디렉터리 안에 중첩된 모듈도 여기서는 여전히 도달할 수 있습니다. 루트 구성은 각 기여자의 source를 식별자에서 다시 구성하는 대신 빌드가 합성한 위치에서 읽기 때문입니다. 이 대상이 거부하는 것은 두 기여자가 디렉터리를 공유하는 경우입니다. 차트 대상은 자식 차트를 한 단계 아래에서만 찾고 그보다 깊이는 찾지 않으므로 중첩된 위치를 아예 거부합니다.

지원되는 입력 종류

terraform provider는 세 가지 Recipe 입력 종류 중 두 가지를 받습니다.

  • Artifacts 모드. Recipe가 Terraform 구성을 템플릿 본문으로 작성합니다. provider는 Aggrega 템플릿을 평가하고 그 결과를 다시 쓰지 않고 내보냅니다. HCL(main.tf)이 사용하기 편한 기본값이며, Terraform JSON(.tf.json)도 동등하게 받습니다. 빌드 출처 정보는 HCL 본문의 맨 위에 Terraform 주석 블록으로 기록됩니다. 주석 문법이 없는 JSON 본문의 경우 출처 정보는 인라인이 아니라 동반 파일 aggrega.provenance.tf로 기록됩니다.
  • Sourced 모드. Recipe가 source:로 Terraform 모듈을 참조합니다. 모듈의 파일은 해당 component의 디렉터리에 그대로 vendoring되며, Recipe의 valuesMapping:은 경계의 루트 구성에서 해당 component의 module 블록 인수가 됩니다. 모듈 본문은 작성된 그대로 보존되고 그 안에는 아무것도 기록되지 않습니다. 값은 Terraform이 평가하는 루트에 한 번만 기술됩니다. 노드에 선언된 values 리프가 모듈의 입력이 그대로 되는 경우, 즉 valuesMapping:이 없는 source: Recipe에서는, 작성자가 민감하다고 선언한 내용을 담은 입력에 Terraform 자체의 민감도 속성을 담은 오버라이드 파일도 생성됩니다. valuesMapping: 템플릿은 출력 이름을 스스로 만들어 내므로 그 경우에는 표시가 붙지 않으며, 빌드가 권고로 이를 보고합니다. 두 경우 모두 민감하다고 선언된 모듈 입력에서 설명합니다.

valuesMapping:의 null은 null 인수입니다. 매핑이 null로 설정한 키는 모듈 블록에 <name> = null로 기록되며, 엔진은 모듈의 변수에 null 값을 주어 default를 덮어씁니다. 단, 변수가 nullable = false를 선언한 경우에는 default가 적용됩니다. 입력에 모듈의 기본값을 주려면 매핑에서 해당 키를 빼십시오.

synthesized 입력 종류는 제공되지 않습니다. 플랫폼 Workload 종류를 임의의 Terraform 리소스로 충실하게, 기능에 구애받지 않고 매핑하는 방법이 없으므로, terraform provider에 대해 workload:를 선언한 Recipe는 지어낸 변환이 아니라 명시적인 오류가 됩니다.

omits:를 선언한 Recipe는 거부됩니다. omits: 키는 소스가 렌더링하는 문서를 빌드에서 제외하는데, 이 provider는 빌드 시점에 sourced 모듈에서 아무것도 렌더링하지 않습니다. 모듈의 파일을 그대로 vendoring하고, Terraform이 구성을 plan하고 apply할 때 이를 평가합니다. 렌더링되는 것이 없으니 제외할 것도 없으므로, 이 provider는 해당 키를 지원한다고 선언하지 않으며, 이를 선언한 Recipe나 FeatureRecipe는 무엇이든 vendoring되기 전에 거부됩니다. The provider does not support omits (provider가 omits를 지원하지 않음)을 참조하십시오. Recipe 옆에 두는 모듈이라면, 그곳의 .aggregaignore에 한 줄을 추가하여 다음에 Recipe를 고정할 때부터 모듈의 파일을 대신 제외할 수 있습니다.

레지스트리가 게시하는 모듈 가져오기

모듈 레지스트리는 모듈의 각 버전을 해당 모듈 자체 git 저장소의 태그로 게시하며, 버전 다운로드를 요청받으면 그 태그가 가리키는 커밋에 고정된 git 소스를 응답합니다. 따라서 Recipe는 git-repository 소스 종류를 사용하여 게시된 모듈을 그 저장소의 그 태그에서 가져옵니다.

spec:
capability: terraform
implements: example/storage/database:1.0.0
source:
kind: git-repository
url: https://github.com/terraform-aws-modules/terraform-aws-rds.git
ref: v7.2.2
valuesMapping: |
identifier: "{{ .values.identifier }}"
provides:
host: "${module.{{ .context.instance_id }}.db_instance_address}"
port: "${module.{{ .context.instance_id }}.db_instance_port}"

ref:는 저장소가 부르는 그대로의 릴리스 태그입니다. valuesMapping:은 모듈의 variable 블록이 선언하는 이름으로 모듈의 입력을 제공하며(Terraform은 default를 선언하지 않은 모든 입력에 값을 요구합니다), 이 값들은 다른 sourced 모듈과 마찬가지로 루트 구성에서 이 component의 module 블록 인수가 됩니다.

고정되는 것. aggrega pin과 pull은 태그를 그것이 가리키는 커밋으로 해석하고 그 커밋 시점의 저장소를 아카이브합니다. 그런 다음 Release의 lockfile은 그 커밋을 소스의 고정 버전으로, 태그를 작성한 참조로, 그리고 아카이브의 다이제스트를 기록합니다. 이후의 모든 빌드는 캐시에서 아카이브를 읽고 무엇이든 vendoring하기 전에 그 다이제스트와 대조하여 검증하므로 네트워크가 필요 없으며, 바이트가 더 이상 일치하지 않는 캐시된 아카이브는 빌드를 중단시킵니다. 태그는 저장소가 다른 커밋으로 옮길 수 있는 이름입니다. 이후의 pull에서 태그가 다른 곳으로 해석되면 새 커밋을 채택하지 않고 중단하며, aggrega pull --upgrade로 의도적으로 채택합니다. 이는 Terraform 자체의 dependency lock file보다 엄격한 고정입니다. 그 파일은 구성이 선택한 provider만 기록하고 모듈은 전혀 기록하지 않으므로, 태그를 지정한 git 소스로 구성에 작성된 모듈은 그 태그만큼만 고정됩니다. 여기서는 모듈의 커밋과 바이트의 다이제스트가 lock에 고정되고, 바이트가 출력에 vendoring되며, 루트 구성이 로컬 경로로 이를 호출하므로, 엔진은 모듈 자체를 로드하기 위해 아무것도 가져오지 않습니다. 단, vendoring된 모듈이 레지스트리나 원격 소스로 호출하는 모듈은 여전히 가져오며, 빌드는 엔진이 초기화할 때 가져오는 모듈 호출에서 설명하듯 그러한 호출을 각각 보고합니다.

vendoring되는 것. 고정된 커밋 시점의 저장소 전체가 .git/ 디렉터리를 제외하고 modules/ 아래 component 자체 디렉터리에 바이트 단위 그대로 들어갑니다. 모듈 자체의 구성 파일과 하위 모듈뿐 아니라 저장소가 담고 있는 나머지 모든 것, 즉 examples/ 및 wrappers/ 디렉터리, 문서, CI 구성, 바이너리를 포함한 모든 테스트 픽스처도 포함됩니다. 엔진은 모듈이 호출하는 것만 읽습니다. 루트 구성이 component의 디렉터리를 호출하면, 엔진은 그 디렉터리 바로 안의 구성 파일과 거기서 로컬 source가 닿는 각 디렉터리의 구성 파일을 로드합니다. 따라서 다른 레지스트리 모듈을 호출하는 예제 디렉터리는 vendoring되지만 로드되지 않으며, 그것이 호출하는 것은 아무것도 가져오지 않습니다.

vendoring 범위 좁히기. 가져온 소스는 가져온 아카이브 그대로이므로, 범위를 좁히는 유일한 방법은 저장소의 한 디렉터리를 아티팩트로 만드는 module_subdir:입니다. 이는 원하는 모듈이 하위 디렉터리에 있을 때만 도움이 됩니다. 저장소 루트에 있으면서 자체 ./modules/*를 호출하는 모듈은 트리 전체가 필요합니다. 저장소가 담고 있는 .terraformignore도, Recipe 옆의 .aggregaignore도 가져온 소스가 vendoring하는 내용을 바꾸지 않습니다. 둘 다 Recipe 옆에 둔 모듈을 다듬는 것이며, 저장소에서 가져온 모듈에 대해서는 어느 쪽도 읽히지 않습니다.

모듈이 게시하는 값 읽기. 모듈이 게시하는 값은 그 모듈의 output 블록 중 하나이며, 소비자는 이를 ${module.<name>.<output>}으로 읽습니다. 여기서 <name>은 생산자의 모듈 블록입니다. 위의 생산자가 ${module.{{ .context.instance_id }}.<output>}을 게시하는 이유가 이것입니다. 엔진은 루트 구성을 검증할 때 모듈 자체의 output 블록에 대해 참조를 해석하므로, 모듈이 선언하지 않은 출력 이름은 그 시점에 이름이 명시되며 거부됩니다.

Error: Unsupported attribute
on aggrega.modules.tf line 9, in module "api":
9: db_host = "${module.db.db_instance_addresz}"
This object does not have an attribute named "db_instance_addresz".

빌드는 모듈의 variable 또는 output 블록을 전혀 읽지 않고, 모듈에 아무것도 기록하지 않으며, provider 구성을 추가하지도 않으므로, 잘못 입력한 출력 이름은 빌드가 아니라 엔진이 잡아냅니다. 소비자 측에 대해서는 다른 component가 게시한 값 소비하기를 참조하십시오.

원문 그대로의 출력과 벤더링

terraform provider는 Terraform 본문을 트랜스파일하거나, 재포맷하거나, 다시 쓰지 않습니다. 작성된 HCL 또는 .tf.json 본문은 템플릿이 평가된 그대로 출력되고(HCL 본문은 출처 주석으로 시작합니다), 소스로 지정된 모듈은 파일 단위로 그대로 벤더링됩니다. 이것이 terraform 출력을 결정적이고 재현 가능하게 유지하는 방식입니다. 같은 입력이 주어지면 렌더링된 구성은 실행할 때마다 바이트 단위로 동일하며, 벤더링된 모듈은 변경 없이 그대로 왕복합니다. provider가 런타임 상태를 결코 해석하지 않으므로, 런타임에 의존하는 모든 것은 Terraform이 apply 시점에 바인딩하는 보간 문자열로 남습니다.

플랫폼 어노테이션

terraform provider는 aggrega.ai/ 어노테이션을 하나도 읽지 않습니다. 벤더링된 모듈, Recipe의 아티팩트 파일, provider가 작성하는 루트 구성에는 네임스페이스, 레지스트리 접두사, 풀 시크릿, 서비스 계정을 넣을 자리가 없으므로, 이 중 하나에 설정된 값은 렌더링된 구성에서 아무것도 바꾸지 않습니다. 이러한 값이 필요한 모듈은 컴포넌트의 values를 통해 그 값을 자신의 입력 중 하나로 받습니다.

provider는 자신의 Plugin 엔터티에서 readsNoWellKnownAnnotations: true로 이를 밝히며(Plugin 엔터티 참조), 따라서 빌드는 이 provider를 통해 렌더에 도달하는 모든 aggrega.ai/ 어노테이션에 대해 키별, 렌더별로 한 번씩, 해당 렌더가 선언하는 입력 종류를 지명하며 경고합니다:

warning: node "db" (provider "terraform"): target "terraform" does not support annotation aggrega.ai/namespace on sourced input and ignored it

값은 여전히 변경 없이 빌드를 통과하며 빌드는 중단되지 않습니다. 경계 어노테이션은 그 아래의 모든 컴포넌트로 캐스케이드되며, 컴포넌트들이 서로 다른 대상을 통해 렌더링되는 경계는 실수가 아니라 일반적인 경우이기 때문입니다. 이 경고는 unsupported-field 클래스에 속하며 해당 클래스의 플래그로 억제할 수 있습니다.

민감으로 선언된 모듈 입력

Terraform은 값 단위의 네이티브 민감도 기본 요소를 갖춘 유일한 표준 라이브러리 대상이므로, 작성자가 민감으로 선언한 데이터를 Aggrega의 방식으로 기록하는 데 그치지 않고 Terraform 자체의 방식으로 렌더링할 수 있습니다.

벤더링된 모듈의 입력이 작성자가 민감으로 선언한 내용을 담고 있으면, provider는 모듈 옆에 파일 하나, aggrega_override.tf.json을 추가로 덧붙여 해당 입력에 대해 sensitive = true를 선언합니다:

{
"variable": {
"db_password": {
"sensitive": true
}
}
}

Terraform은 이름이 override 그 자체이거나 _override로 끝나는 구성 파일을 같은 디렉터리의 구성에 병합하므로, 벤더링된 모든 바이트가 작성된 그대로 유지되면서도 모듈 자체의 variable 블록이 이 속성을 얻게 됩니다. 입력에 선언된 타입, 기본값, 설명은 건드리지 않습니다. override는 민감도 속성만 담고 그 밖에는 아무것도 담지 않습니다. 표시되지 않은 노드에는 이러한 파일이 생기지 않습니다.

이 제한은 파일 형식이 부과하는 것이 아니라 의도된 것입니다: override에는 두 번째 속성을 거부하는 요소가 전혀 없으며, 벤더링된 모듈의 바이트를 편집하지 않고 값을 전달하고 싶다면 variable 블록의 default가 가장 손쉽게 떠올릴 자리입니다. 하지만 그 값은 도달하지 않습니다. 이 파일이 작성되는 JSON 구성 구문에서 default는 Terraform이 평가하는 위치가 아니므로, 그곳에 작성된 ${ ... } 포인터를 담은 값은 포인터의 문자 그대로 모듈에 도달하며, plan은 성공하고 아무것도 알리지 않습니다. 같은 포인터를 네이티브 HCL의 default에 작성하면 즉시 거부되므로, 이 침묵은 override 파일 자체가 아니라 이 구문에 있는 것입니다. 그래서 override는 sensitive만 담습니다. 그 의미는 평가 여부에 의존하지 않기 때문입니다.

어떤 입력을 표시할지는 이름이 아니라 선언에서 결정됩니다. provider는 컴파일이 계산한 표시를 읽을 뿐 스스로 아무것도 검사하지 않습니다. password, secret, token을 인식하지 않으며, 추측하기 위해 모듈의 텍스트를 읽지도 않습니다. 값에 선언이 없는 db_password라는 이름의 모듈 입력은 표시 없이 내보내지고, 선언된 region이라는 입력은 표시됩니다.

표시는 선언으로부터 입력의 정체를 복원할 수 있는 경우에만 전달됩니다. source:로 모듈을 벤더링하고 노드에 선언된 values 리프가 그대로 모듈의 입력이 되게 하는 Recipe는 각 입력에 작성자가 선언한 것과 같은 이름을 부여하므로 연결이 정확합니다. 같은 방식으로 모듈을 벤더링하는 component에 연결된 Feature의 FeatureRecipe도 그 Feature가 선언한 리프에 대해 마찬가지입니다. valuesMapping: 템플릿으로 그 값들을 재구성하는 Recipe나 그러한 FeatureRecipe는 출력 이름을 새로 만들어 내며, 어떤 선언도 그 이름을 지정하지 않습니다. 그래서 표시는 근사되는 대신 생략되고, 빌드는 선언된 리프마다 하나의 권고를 내어 그 리프와 해당 매핑을 가진 엔터티를 명시합니다(boundary에 연결된 Feature는 values 없이 렌더링되므로 표시할 것이 없고 권고도 발생하지 않습니다). A declared-sensitive value reaches the target through a values mapping (민감으로 선언된 값이 values 매핑을 통해 대상에 도달함)을 참조하십시오. 생략은 의도된 것입니다. 재구성된 입력 중 어느 것이 선언된 데이터를 담았는지 추측하면 공개 입력을 비밀로 표시하게 되고, 그러면 Terraform은 한 번도 민감하지 않았던 값을 plan 출력에서 숨기게 됩니다.

작업 예제 terraform-declared-sensitivity는 이를 처음부터 끝까지 빌드하며, 전체를 읽을 수 있을 만큼 작습니다. 하나의 component가 세 개의 values 리프를 선언하고, 그중 둘은 공개 식별자를, 하나는 자격 증명을 담습니다. 렌더링된 출력은 module 블록의 인수가 세 모듈 입력을 모두 담고 override는 선언된 하나만 지정하는 모습을 보여 주므로, 규칙의 양면을 같은 빌드에서 확인할 수 있습니다. 비밀 옆에 있는 자격 증명 식별자가 표시되지 않는다는 점도 포함됩니다. 그 하나의 선언을 제거하고 다시 빌드하면 override 파일이 전혀 생성되지 않습니다.

Terraform의 sensitive가 보장하는 것과 보장하지 않는 것

Aggrega는 Terraform 자체 속성이 제공하는 것만을 정확히 약속하며, 그 이상은 약속하지 않습니다.

표시를 제한합니다. 민감한 값은 plan 출력에서 (sensitive value)로, apply 출력에서 <sensitive>로 나타납니다. 표시는 표현식을 통해 전파되므로 민감한 입력에서 파생된 값도 민감하며, Terraform은 그 자체가 민감으로 표시되지 않은 루트 output에서 그러한 값을 내보내는 것을 거부합니다. 조용한 노출이 아니라 명확한 오류가 발생합니다.

저장 방식을 바꾸지 않으며, 암호화가 아닙니다. Terraform은 민감한 값을 state에 평문으로 기록합니다. sensitive = true를 state를 커밋하거나 공유해도 안전하다는 약속으로 읽는 것이 피해야 할 유일한 오해입니다. state 보호는 표시가 전혀 없는 모듈과 마찬가지로 여전히 state 백엔드를 어떻게 구성하느냐의 문제입니다. 이 속성은 또한 누가 값을 읽을 수 있는지 제한하지 않고, provider가 전송하는 내용에 영향을 주지 않으며, 렌더링된 구성을 다른 어떤 방식으로도 바꾸지 않습니다.

따라서 표시는 누군가 plan을 읽을 때 민감으로 선언된 입력이 실수로 노출되기 어렵게 합니다. 배포물을 공개해도 안전하게 만들지는 않습니다. 키워드와 선언이 모든 대상에서 달성하는 내용은 리프를 민감으로 선언하기를 참조하십시오.

구조적 입력 검증

terraform provider는 소스로 가져온 모듈의 구조를 렌더링하기 전에 검증합니다. 모듈의 HCL 및 .tf.json 파일을 파싱하여 파싱 오류를 보고하고, 문제가 된 노드와 provider를 명시하는 명확한 메시지와 함께 빌드를 중단합니다. 파싱은 의미가 아니라 형태를 검사합니다. 즉, provider를 해석하거나 표현식을 평가하거나 레지스트리에 접속하지 않습니다. 검증은 밀폐적입니다. provider에 컴파일되어 포함된 독립적인 HCL 파서를 사용하며, terraform 바이너리나 네트워크 접근은 필요하지 않습니다. 형식이 잘못된 모듈은 이후의 terraform 실행에서 혼란스러운 오류로 드러나는 대신 작성 경계에서 잡힙니다.

엔진이 초기화 시 가져오는 모듈 호출

같은 읽기 과정에서, 구성이 초기화될 때 Terraform이 소스를 다운로드하는 각 module 블록을 아무것도 거부하지 않는 경고로 보고합니다. vendor된 모듈의 커밋과 아카이브 다이제스트는 lock에 고정되지만, 그 안에 있는 module 블록의 source가 레지스트리 주소, git, Mercurial 또는 HTTP 아카이브 URL, S3 또는 GCS 버킷, 또는 절대 경로라면 엔진이 초기화 시점에 그때 선택하는 버전으로 가져오는 모듈을 가리킵니다. 그리고 Terraform 자체의 의존성 lock 파일은 provider만 기록하므로 그 모듈을 고정하는 것은 아무것도 없습니다. vendor된 모듈 밖으로 올라가는 로컬 source도 보고되는데, 빌드가 vendor하지 않은 파일을 가리키기 때문입니다. 각 결과에는 노드와 provider, 이어서 블록, 그 블록이 있는 파일과 줄, 그리고 작성된 그대로의 소스가 명시됩니다.

warning: node "app" (provider "terraform"): module "vpc" (main.tf, line 2) has the source "terraform-aws-modules/vpc/aws", which Terraform downloads when the configuration is initialised, at whatever version it then selects, so no commit or digest this build records covers that module

읽는 대상. 모듈이 호출될 때 엔진이 로드하는 파일입니다. 즉, 모듈 자체 디렉터리에 직접 있는 구성 파일, 그리고 그곳에서 로컬 source(./ 또는 ../로 시작하거나 그 백슬래시 표기로 시작하는 것)가 도달하는 각 디렉터리의 구성 파일로, 디렉터리에서 디렉터리로 따라가며 각각 한 번씩 읽습니다. 아무것도 호출하지 않는 디렉터리는 읽지 않으므로, 모듈의 examples/ 또는 tests/ 디렉터리가 하는 호출은 보고되지 않습니다. 모듈이 호출될 때 엔진은 그것들을 로드하지 않으며, 그것들이 호출하는 것도 가져오지 않습니다. 위의 파싱 검사는 여전히 vendor된 모든 구성 파일을 파싱합니다. Recipe의 작성된 본문도 렌더링될 때 본문이 기록되는 디렉터리부터 같은 방식으로 읽으므로, 작성된 본문이 레지스트리 소스로 기록하는 module 블록도 보고됩니다. spec.boundary.artifacts 아래의 파일은 컴파일러가 직접 평가하고 기록하며 어떤 provider에도 전달되지 않으므로, 그 안에 작성된 module 블록은 읽지 않으며 경고도 발생하지 않습니다.

읽지 않는 대상. source가 말하는 내용만 읽습니다. 빌드는 호출이 가리키는 모듈을 읽지 않고, 그 모듈이 무엇을 하는지 판단하지 않으며, 호출이 허용 가능한지 결정하지 않습니다. 엔진이 작성된 그대로 읽지 않고 평가하는 source(보간이나 참조를 포함하는 것)는 앞부분 텍스트로 판단합니다. 주소로 시작하는 것은 작성된 그대로 보고되고, 로컬 접두사나 보간 자체로 시작하는 것은 보고되지도 따라가지도 않습니다. 어디로 이어지는지가 텍스트에 없기 때문입니다. required_providers 안의 source는 모듈이 아니라 provider를 가리키므로 모듈 호출이 아닙니다.

거부하지 않고 보고하는 이유. 다른 모듈을 호출하는 모듈은 정당한 입력입니다. Terraform은 호출된 모듈을 가져오고 구성은 동작합니다. 작성자가 포기하는 것은 호출된 모듈에 대한 빌드의 고정이며, 이는 고쳐야 할 결함이 아니라 알아 둘 가치가 있는 사실이고, 그 가져오기가 허용 가능한지는 작성자의 판단입니다. 완전히 고정된 상태를 유지해야 하는 구성은 그러한 호출을 하지 않는 모듈만 vendor합니다. 경고, 그 클래스 코드, 그리고 경고가 그 밖에 어디까지 미치는지는 Warnings and Linter Output(경고 및 린터 출력)에 설명되어 있습니다.

FeatureRecipe 패치 경계

렌더링 후 FeatureRecipe pipeline 단계는 provider가 구조화된 트리로 렌더링하는 출력만 패치합니다. terraform의 경우 이는 다음을 의미합니다.

  • JSON으로 작성된 Terraform은 패치할 수 있습니다. .tf.json 모듈은 구조화된 문서이므로, pipeline 단계의 JSONPatch는 지정된 값을 제자리에서 편집하고 순서, 서식, 주변 키 등 나머지 모든 바이트는 그대로 둡니다.
  • 네이티브 HCL은 불투명합니다. 네이티브 HCL 본문(main.tf)은 구조화된 패치 대상이 아닙니다. 불투명한 본문에 대한 패치는 구조적으로 지정할 수 없는 텍스트를 변경하는 대신 진단과 함께 빌드를 중단합니다. HCL 본문을 대상으로 pipeline 단계를 작성하는 것은 설계 오류이며, 아무 일도 하지 않고 조용히 넘어가는 것이 아니라 명시적인 중단으로 드러납니다.
  • 소스로 가져온 모듈의 입력은 애초에 패치 대상이 아닙니다. 이 입력은 루트 구성에 위치한 component의 module 블록의 인수입니다. 이 블록은 네이티브 HCL이므로 불투명하며, 특정 노드 하나가 아니라 경계 전체의 산출물입니다. pipeline 단계는 노드 자체의 렌더링된 출력을 패치하므로, 이 입력을 지정할 수 있는 위치가 없습니다.

따라서 Terraform 본문을 pipeline으로 패치할 수 있어야 하는 작성자는 이를 .tf.json으로 작성합니다. provider 전반의 일반적인 패치 대상 경계는 FeatureRecipe를 참조하십시오.

배포 순서

Release 경계의 syncWave: 값은 해당 경계가 조립되는 루트 구성의 module 블록 순서를 정합니다. 경계 안의 모든 컴포넌트는 경계의 웨이브를 상속하며, 여러 경계가 같은 출력 디렉터리로 해석되어 그 컴포넌트들이 하나의 루트 구성으로 합성되는 경우에는 그 루트가 둘 이상의 웨이브를 가지게 되고, 프로바이더는 웨이브 사이의 순서를 module 블록의 depends_on으로 표현합니다.

각 모듈은 component가 하나라도 있는 바로 이전 wave의 모든 모듈을 지정하며, 그보다 이른 wave는 지정하지 않습니다. 나머지는 Terraform이 연결합니다. wave 2의 모듈은 wave 1에 의존하고, 그 wave는 다시 wave 0에 의존하므로, 전체 순서가 정해지면서도 각 모듈의 목록은 경계 전체가 아니라 wave 하나의 크기로 유지됩니다. wave는 연속적일 필요가 없으며, 음수 값도 평범하게 사용됩니다. -1은 구성의 나머지 부분이 읽는 버킷이나 역할에 흔히 쓰이는 값입니다. 가장 낮은 wave는 앞선 것이 없으므로 아무것도 지정하지 않습니다.

순서가 의미하는 것: Terraform이 작업을 수행하는 순서입니다. Terraform은 의존성 그래프를 만들고 그래프가 허용하는 범위에서 병렬로 처리합니다. depends_on은 그 그래프에 간선을 추가하므로, Terraform은 지정된 모듈에 대한 작업을 완료한 뒤에 의존성을 선언한 모듈에 대한 작업을 시작합니다. 따라서 웨이브는 실행을 단계로 나눕니다. 이전 웨이브의 컴포넌트에 대한 작업이 끝난 뒤에 이후 웨이브의 작업이 시작됩니다.

준비 상태 순서가 아닙니다. Terraform 구성에는 리소스가 서비스 가능한 상태라는 개념이 없으므로, 여기서는 리소스가 준비될 때까지 기다리지 않고 Terraform이 해당 리소스에 대한 작업을 마칠 때까지만 기다립니다. 이는 compose의 같은 웨이브와 실제로 다른 점입니다. compose에서는 healthcheck를 선언한 서비스가 정상 상태를 보고할 때까지 기다립니다. compose에는 기준으로 삼을 준비 상태 기본 요소가 있지만 Terraform 구성에는 없습니다. 이 대상이 제공하는 것은 작업 순서이며, 지킬 수 없는 약속에 단서를 다는 것보다 이를 분명히 밝히는 편이 더 유용합니다.

해체 순서는 보장하지 않습니다. depends_on이 명시하는 것은 Terraform이 의존 대상의 작업을 완료한 뒤에 의존하는 쪽의 작업을 시작한다는 것입니다. destroy가 이들을 제거하는 순서는 그 명시에 포함되지 않으므로, 여기서는 해체 순서에 대해 아무것도 주장하지 않습니다. 이는 양방향을 모두 제어하는 속성을 가진 cloudformation의 같은 웨이브보다 좁은 약속입니다. 웨이브로 해체 순서를 정하려 한다면 알아 두어야 합니다. 이 대상에서는 그렇게 되지 않기 때문입니다.

모든 컴포넌트가 하나의 웨이브를 가진 경계에는 아무런 영향이 없습니다. syncWave를 전혀 선언하지 않은 Release도 마찬가지입니다. 모든 기여 요소가 필드 기본값 0을 가지고, 루트 구성은 단일 웨이브를 가지며, 출력되는 바이트는 프로바이더가 웨이브 순서를 전혀 표현하지 않았을 때와 정확히 같습니다.

두 루트 구성 사이의 순서는 표현할 수 없으며, 근사하지도 않습니다. Terraform 의존성 그래프는 구성 단위이고 depends_on은 그것을 선언한 구성 안의 모듈을 지정하므로, 웨이브는 해당 루트에 합성된 모든 컴포넌트의 순서를 정할 뿐 그 밖의 것은 정하지 않습니다. 두 구성의 순서를 정하는 것은 운영자의 몫입니다. 원격 상태 참조가 빌드 시점이 아니라 배포 시점에 해석되는 것과 같습니다.

웨이브는 실행에 반영될 뿐 아니라 기록도 됩니다. 웨이브는 노드의 나머지 빌드 출처 정보와 함께, 스탬프된 주석 블록의 aggrega.ai/sync-wave로, 또는 본문이 JSON이거나 벤더링된 모듈인 경우 동반 출처 파일에 기록됩니다. 따라서 렌더링된 구성은 웨이브에 따라 순서가 정해질 뿐 아니라 그 경계가 선언한 웨이브도 기록합니다.

웨이브가 표현하지 않는 순서는 Terraform이 스스로 처리하며, 리소스 간 참조가 이미 그 상당 부분을 담당합니다. 다른 리소스의 속성을 참조하면 Terraform은 그 리소스에 대한 작업을 먼저 수행합니다. 참조나 웨이브로 나타나지 않는 제약이 필요한 모듈은 모듈 안에 자체 depends_on을 작성하며, 프로바이더는 이를 본문의 다른 모든 부분과 마찬가지로 그대로 출력합니다.

  • Provider 아키텍처 — provider가 컴파일 파이프라인과 provider별 디스패치에 어떻게 맞물리는지 설명합니다.
  • Provider 참조 색인 — 각 표준 라이브러리 프로바이더가 무엇을 생성하는지, 그리고 어떤 페이지가 어떤 질문에 답하는지 설명합니다.
  • Recipe 엔터티 — Recipe 작성 인터페이스와 세 가지 입력 종류를 설명합니다.
  • FeatureRecipe — 렌더링 후 pipeline 패치 모델과 그 구조화/불투명 경계를 설명합니다.
  • Recipe 입력 구성 — 정식 Provider 기능 매트릭스입니다.