Terraform RDS (벤더링된 모듈)
terraform-rds 예제와 같은 MariaDB 의도를 Terraform 프로바이더의
소스 지정 형태로 렌더링합니다. 인라인 HCL 본문 대신
Recipe가 로컬 Terraform 모듈을 가리키고, 컴파일러는 이를 그대로 벤더링한 뒤
개발자 축과 운영자 축에서 입력 변수를 제공합니다.
컴파일러가 출력하는 것
빌드는 dist/infra/terraform/ 아래에 경계의 루트
구성을 생성하고, dist/infra/terraform/modules/db/ 아래에 db 컴포넌트
자체의 파일을 생성합니다.
- 경계 루트의
aggrega.modules.tf— 루트 구성으로,db를module블록으로 선언하며 그source는./modules/db이고 인수는 모듈의 입력 변수이며, 결정적인 키 순서를 따릅니다. 모든 terraform 경계에 하나씩 생성되며, 경계의 컴포넌트를 하나의 Terraform 구성에 넣는 것이 이 파일입니다. - 바이트 단위로 그대로 복사된 모듈 파일(
variables.tf,main.tf, 모듈 작성자가 작성한${...}보간 포함). - 그 파일들 옆의
aggrega.provenance.tf— 빌드를 식별하는#주석 파일입니다.
이 예제가 출력하는 db 블록:
module "db" { source = "./modules/db"
allocated_storage = 100 backup_retention_period = 14 db_name = "appdb" engine_version = "11.4" instance_class = "db.t3.small" multi_az = true port = 3306 skip_final_snapshot = false storage_type = "gp3" subnet_id = "production-private-db-subnets"}이 인수 중 두 개는 작성된 위치까지 거슬러 따라가 볼 만합니다.
subnet_id는 Release가
infra.overrides 아래에서 제공하는 DB 서브넷 그룹 이름입니다. 이 그룹은 이 배포 밖에서 운영되고, 이름은
환경마다 다르며, 모듈 자체의 선언에는 기본값이 없습니다. 그래서
Recipe가 이를 필수로 지정하고, 값이 없으면 잘못된 네트워크를 대상으로 계획하는 대신
빌드가 명시적으로 중단됩니다. instance_class는 같은 축에서 오지만
Recipe에 기본값이 있으므로, 아무것도 지정하지 않은 Release는
db.t3.small을 받습니다.
Recipe가 이 인수에 매핑하는 것은 무엇이든 컴파일러가 손대지 않고 그대로 전달하며
해석하지 않습니다. Terraform ${...} 포인터도 마찬가지입니다. 위치에 따라
달라지는 것은 그 포인터가 도달하는 곳입니다. 모듈 인수는 Terraform이 평가하는 위치 중
하나이므로, 그곳에 작성된 포인터는 모듈에 리터럴
문자열로 전달되는 대신 계획 시점에 루트 구성을 기준으로 해석됩니다. 다만 여전히 그 구성이 선언하는 것을 가리켜야 합니다.
입력이 루트에 지정되므로, modules/db/만으로는 배포된 상태로
계획할 수 있는 구성이 아닙니다. 시도할 경우 엔진이 어떻게 동작하는지는
Terraform 프로바이더 페이지를
참고하십시오.
파일
aggregate.yaml— 개발자 의도: 타입이core/datastore/mariadb인db컴포넌트 하나.release.yaml—infra경계에 대한 운영자의 크기 설정입니다.db항목은 Component의 필수root_password슬롯을core/generated-secret에 바인딩하고(아래 참고),core/backup을 연결하여 인스턴스의 자동 백업을 각각 14일 동안 보관하게 합니다. 이것이 위의backup_retention_period이며, 연결이 없으면 인스턴스는 7일 동안 보관합니다.manifest.yaml— MariaDB 컴포넌트 타입을 모듈을 로컬에서 가져오는 Terraform Recipeterraform/mariadb-rds-module에, 자격 증명 Feature 타입을terraform/generated-secret에, 백업 Feature 타입을terraform/backup-native에 바인딩합니다. 후자는 아무것도 렌더링하지 않습니다. Recipe가 연결을 읽고 모듈의 백업 입력을 직접 제공합니다..aggrega-config.yaml— 카탈로그 엔터티를 해석해 오는 허브 레지스트리를 지정합니다.
관리형 대상의 자격 증명 슬롯
core/datastore/mariadb는 root_password를 필수 슬롯으로 선언합니다. 아무것도 이를 바인딩하지 않으면
빌드가 중단됩니다. RDS는 마스터 비밀번호를 직접
생성하고 교체하며, 이 Recipe가 복사하는 벤더링된 모듈은
manage_master_user_password를 설정하여 이를 활성화합니다. 따라서 슬롯은 작성된 값으로 채워지는 대신
엔진에 위임됩니다.
엔진이 자격 증명을 소유하는지 여부는 Manifest가 선택하는 Recipe에 따라
결정되므로, 운영자가 Release의 db 항목에서 슬롯을 바인딩합니다.
바인딩에는 core/generated-secret을 사용합니다. 작성할 것이 없으므로 이는 아무것도 구성하지 않으며,
그 FeatureRecipe
(terraform/generated-secret)는 아무것도 렌더링하지 않는 순수한 연결입니다. 벤더링된
모듈과 루트 구성은 첨부가 전혀 없을 때와 바이트 단위로 동일하게
출력됩니다. Manifest의 참조가 프로바이더로 한정되는 이유는, 한정되지 않은
레시피 이름은 정확히 하나의 프로바이더가 그것을 제공할 때만 해석되는데,
표준 라이브러리가 generated-secret FeatureRecipe를 둘 이상의 프로바이더 아래에 제공하기 때문입니다.
따라서 한정되지 않은 이름은 전혀 해석되지 않으며, 빌드는 조용히 프로바이더를 대신 선택하는 대신
명시적으로 중단됩니다.
예제 생성하기
아래 명령으로 이 예제를 빌드하거나, AI 어시스턴트에게 대신 빌드하게 할 수 있습니다.
예제 이름을 딴 새 폴더에 예제를 씁니다:
aggrega scaffold --example terraform-rds-module그런 다음 이어서 실행할 명령을 출력합니다. 첫 번째 명령은 새 폴더로 이동합니다:
cd terraform-rds-module빌드
aggrega build --release release.yaml --auto-pull--auto-pull은 새로 클론한 저장소에 없는 lockfile을 빌드 중에 기록합니다.
AI 어시스턴트 사용
Aggrega 도구로 설정한 AI 어시스턴트도 같은 작업을 할 수 있습니다. 다음 프롬프트를 붙여 넣으십시오.
Aggrega 도구만 사용하고, 폴더를 직접 만들지 마십시오. 작업 영역 폴더에 아직 `terraform-rds-module` 폴더가 없으면 `example`을 `terraform-rds-module` 값으로 설정하고 `dir` 없이 `scaffold` 도구를 한 번 호출하십시오. 그러면 새 `terraform-rds-module` 폴더에 예제가 작성됩니다. 그런 다음 `workspace_root`를 `terraform-rds-module` 값으로, `release`를 `release.yaml` 값으로, `auto_pull`을 true로, `write`를 true로 설정하여 `build` 도구를 호출하십시오. 빌드가 작성한 파일을 알려 주십시오. 파일은 `terraform-rds-module/dist/` 아래에 있습니다.