Terraform RDS (인라인 HCL 아티팩트)
개발자 의도로 한 번 작성되고, 관리형 AWS RDS 인스턴스를 프로비저닝하는 Terraform HCL 파일로 렌더링되는 단일 MariaDB 데이터베이스입니다.
이 예제는 Terraform provider의 아티팩트 형태를 보여 줍니다.
Recipe는 artifacts: 아래에 인라인 main.tf 본문을 담고 있으며, 컴파일러는
템플릿 표현식을 해석한 뒤 그 본문을 그대로 출력합니다. provider는
terraform을 실행하지 않으며, 다운스트림의 terraform apply가 실행할 HCL을 생성합니다.
파일
aggregate.yaml— 개발자 의도: 논리 데이터베이스 이름을 가진core/datastore/mariadb타입의dbcomponent 하나입니다. 클라우드 대상에 관한 내용은 여기에 전혀 없습니다.release.yaml— 운영자 사이징:infra경계에 대한 엔진 버전, 스토리지, HA입니다.db항목은 Component의 필수root_password슬롯을core/generated-secret으로 바인딩합니다. 이는 엔진이 자격 증명을 소유한다고 선언하는 자격 증명 Feature입니다(아래 참조). 또한 인스턴스가 백업을 보관하는 기간을 설정하는core/backup을 연결합니다.manifest.yaml— MariaDB component 타입을 Terraform Recipeterraform/mariadb-rds에, 자격 증명 Feature 타입을terraform/generated-secret에, 백업 Feature 타입을terraform/backup-native에 바인딩합니다..aggrega-config.yaml— 카탈로그 엔터티를 해석해 오는 허브 레지스트리를 지정합니다.
예제 생성하기
아래 명령으로 이 예제를 빌드하거나, AI 어시스턴트에게 대신 빌드하게 할 수 있습니다.
예제 이름을 딴 새 폴더에 예제를 씁니다:
aggrega scaffold --example terraform-rds그런 다음 이어서 실행할 명령을 출력합니다. 첫 번째 명령은 새 폴더로 이동합니다:
cd terraform-rds빌드
aggrega build --release release.yaml --auto-pull--auto-pull은 새로 클론한 사본에 없는 잠금 파일을 빌드 중에 기록합니다. 렌더링된 main.tf는 dist/infra/terraform/modules/db/ 아래에 놓이며, dist/infra/terraform/에 있는 경계의 루트 구성 aggrega.modules.tf가 db를 그곳을 가리키는 module 블록으로 선언합니다. 본문은 빌드를 식별하는 # 주석 출처 블록으로 시작하고, 이어서 AWS provider 버전을 제한하는 required_providers 블록, 해석된 aws_db_instance 리소스(스토리지와 HA 값은 Release에서 치환되고, 백업 보존 기간은 core/backup 연결이 설정하며, 자격 증명은 manage_master_user_password를 통해 RDS가 관리함), 그리고 인스턴스의 호스트 이름을 담는 address 출력이 옵니다. Recipe는 이 출력을 ${module.db.address} 형태의 host로 게시합니다.
그 module 블록에는 인수가 없으며, 그 이유는 이 예제의 형태에 있습니다.
Recipe가 본문을 작성했으므로 Release의 값을 리소스에 직접 치환했습니다. 모듈은
variable 블록을 선언하지 않으며, 컴파일러가 전달할 것이 남아 있지 않습니다.
module "db" { source = "./modules/db"}대신 모듈을 벤더링하는 Recipe는(
terraform-rds-module 예제) 해당 입력을 본문에서
선언하지 않은 채로 두므로, 컴파일러가 이를 이 블록의 인수로 제공합니다.
AI 어시스턴트 사용
Aggrega 도구로 설정한 AI 어시스턴트도 같은 작업을 할 수 있습니다. 다음 프롬프트를 붙여 넣으십시오.
Aggrega 도구만 사용하고 폴더를 직접 만들지 마십시오. 작업 공간 폴더에 아직 `terraform-rds` 폴더가 없으면 `example`을 `terraform-rds`로 설정하고 `dir` 없이 `scaffold` 도구를 한 번 호출하십시오. 그러면 새 `terraform-rds` 폴더에 예제가 작성됩니다. 그런 다음 `workspace_root`를 `terraform-rds`로, `release`를 `release.yaml`로, `auto_pull`을 true로, `write`를 true로 설정하여 `build` 도구를 호출하십시오. 빌드가 작성한 파일을 알려 주십시오. 파일은 `terraform-rds/dist/` 아래에 있습니다.관리형 대상의 자격 증명 슬롯
core/datastore/mariadb는 root_password를 필수 슬롯으로 선언합니다. 아무것도
바인딩하지 않으면 빌드가 중단됩니다. 자체 호스팅 MariaDB는 작성 시점에 비밀번호를
바인딩해야 하지만, 관리형 RDS 인스턴스는 그렇지 않습니다. RDS가 마스터 비밀번호를
직접 생성하고 교체하며, 이 Recipe의 manage_master_user_password가 그 기능을
켭니다.
따라서 운영자는 Release의 db 항목에서 엔진이 자료를 소유하는 자격 증명 Feature인
core/generated-secret으로 슬롯을 바인딩합니다. 엔진이 자격 증명을 소유하는지는
Manifest가 고르는 Recipe에 따라 결정되므로 바인딩은 운영자의 몫이며, Aggregate는
이에 대해 아무것도 말하지 않습니다.
components: db: features: root_password: type: core/generated-secret작성할 것이 없으므로 첨부는 아무것도 구성하지 않으며, Manifest가 선택하는
FeatureRecipe(terraform/generated-secret)는 아무것도 렌더링하지 않는 순수한
연결입니다. 따라서 렌더링된 main.tf는 첨부가 전혀 없을 때와 바이트 단위로
동일합니다. 슬롯은 바인딩되고, 이를 위해 출력되는 아티팩트는 없습니다.
Manifest의 FeatureRecipe 참조는 provider로 한정되어 있다는 점에 유의하십시오
(terraform/generated-secret:1.0.0). 한정되지 않은 recipe 이름은 정확히 하나의
provider만 그것을 가질 때에만 해석되며, 표준 라이브러리는 둘 이상의 provider 아래에
generated-secret FeatureRecipe를 제공합니다. 따라서 한정되지 않은
generated-secret:1.0.0은 전혀 해석되지 않으며, 빌드는 조용히 provider를 대신
고르는 대신 명시적으로 중단됩니다.
관리형 대상에서의 백업
RDS는 인스턴스를 직접 백업하며, 달리 지정하지 않으면 각 자동 백업을 7일 동안 보관합니다. 운영자는 Release에서 자격 증명 옆에 core/backup을 연결하여 이를 변경합니다.
backup: type: core/backup infra: retention_days: 14Manifest는 이 Feature를 terraform/backup-native에 바인딩하며, 이는 자체적으로 아무것도 렌더링하지 않습니다. 백업은 인스턴스의 설정이므로, Recipe가 연결을 읽어 이미 렌더링하는 리소스에 기록합니다. main.tf에 있는 aws_db_instance의 백업 부분:
## ── Backup ─────────────────────────────────────────────── backup_retention_period = 1430 2 * * * 같은 infra.schedule은 인스턴스의 backup_window도 02:30-03:00(UTC 기준)으로 설정합니다. 여기처럼 생략하면 RDS가 기간을 선택합니다. RDS가 유지할 수 없는 값 — 35일을 넘는 보존 기간, 매일 한 시각이 아닌 일정 — 은 연결을 지목하며 빌드를 중단시킵니다.