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

Day-2 수명 주기

Day-2 라이프사이클과 시간적 실행

기능에 구애받지 않는 AOT(Ahead-of-Time) 컴파일러는 본질적으로 선언적 의도(Day-1)와 운영 현실(Day-2) 사이에 간극을 만듭니다. 클라우드는 완벽하게 결정적이지 않고, 배포에는 시간적 순서가 필요하며, 개발자에게는 유지 관리 작업을 위한 명령형 트리거가 필요합니다.

Aggrega는 특정한 아키텍처 폴리필과 GitOps 네이티브 라우팅으로 이러한 간극을 구조적으로 메우며, 핵심 컴파일러의 순수성을 해치지 않으면서 생성된 구성이 이러한 운영상의 요구를 충족하게 합니다.

1. DAG 실행 모델(시간적 순서 지정)

문제: 인프라 배포는 시간의 방향성 비순환 그래프(DAG)입니다. 데이터베이스 마이그레이션 task는 웹 server가 부팅되기 전에 완료까지 실행되어야 합니다. 그러나 AOT 컴파일러는 정적 YAML 또는 Terraform의 평면 폴더를 생성합니다. 이러한 평면 폴더를 GitOps 컨트롤러(ArgoCD 등)에 넘기면 모든 것을 동시에 적용하므로, 웹 서버가 데이터베이스를 기다리는 동안 크래시 루프에 빠집니다.

해결책: Release의 경계별 syncWave 개발자의 Aggregate는 건드리지 않습니다. 순서 지정은 물리적 운영 현실이므로 도메인 4(Release)에서만 엄격하게 관리됩니다. Release의 각 경계는 선택적 syncWave: <integer> 필드를 가지며, 이를 통해 플랫폼 운영자가 경계 수준에서 롤아웃 순서를 명시적으로 단계화할 수 있습니다.

apiVersion: aggrega.ai/v1beta1
kind: Release
metadata:
name: sequenced-release
version: 1.0.0
environment: production
spec:
aggregate: my-app
manifest: prod-manifest
boundaries:
infra:
syncWave: 0
components:
core-vpc: {}
postgres-db: {}
migrations:
syncWave: 1
components:
db-migration-task: {}
apps:
syncWave: 2
components:
web-server: {}
support-agent: {}

웨이브 값의 의미:

  • 웨이브는 부호 있는 정수이며 기본값은 0입니다. 음수 값은 다른 모든 것보다 먼저 실행되며(CRD, 네임스페이스, RBAC), 큰 값은 작은 값보다 나중에 실행됩니다. 운영자는 자신의 배포 토폴로지에 맞게 값을 설정합니다.
  • 경계에 직접 포함된 모든 component 인스턴스는 경계의 웨이브 값을 자신의 IR 노드로 상속합니다. 작성 계층에는 component별 재정의가 없습니다. 단일 경계 내부의 provider 내부 리소스별 순서는 provider가 담당합니다.
  • 중첩된 경계는 암묵적으로 상속하지 않습니다. syncWave를 선언하지 않은 중첩 경계는 바깥 경계의 선언과 관계없이 기본값 0이 됩니다. “inner 하위 경계를 포함해 outer 전체가 웨이브 1”을 원하는 운영자는 양쪽 모두에 syncWave: 1을 선언합니다.

컴파일러의 효과: 컴파일러는 각 경계의 웨이브 값을 해당 경계에서 렌더링되는 매니페스트에 전파합니다. Providers는 네이티브 순서 지정 기본 요소를 출력합니다:

  • Kubernetes(ArgoCD/Flux)의 경우: helm provider는 렌더링되는 모든 매니페스트에 argocd.argoproj.io/sync-wave: "<N>"를 metadata.annotations 항목으로 출력하며, 차트가 Helm 훅으로 표시한 리소스는 네이티브 Helm 훅 순서 지정을 위해 helm.sh/hook-weight: "<N>"도 추가로 받습니다. helm-chart provider는 Recipe가 artifacts:를 통해 차트에 추가하는 템플릿 파일에만 이 어노테이션을 출력합니다. 차트 자체의 템플릿은 변경 없이 복사하므로 그 템플릿에는 웨이브가 없습니다.
  • Compose의 경우: compose provider는 경계가 렌더링되는 파일의 서비스들 사이에 depends_on으로 순서를 표현하며, 대상이 healthcheck를 선언한 경우에는 대상의 상태(health)를, 선언하지 않은 경우에는 시작을 조건으로 삼습니다. depends_on은 한 파일 안의 서비스를 가리키므로 두 compose 파일에 걸친 순서는 표현할 수 없습니다. 운영자는 별도의 compose 프로젝트를 docker compose up 호출 계층에서 순서화합니다.
  • CloudFormation의 경우: cloudformation provider는 디스패치 그룹이 조립되는 스택 템플릿의 리소스들 사이에 DependsOn으로 순서를 표현합니다. 각 리소스는 바로 앞의 채워진 웨이브의 리소스를 가리키고, 대상이 나머지를 연결합니다. 이 속성은 생성 순서뿐 아니라 역순으로 삭제 순서도 규정합니다. 템플릿에는 리소스가 서비스 가능한 상태라는 개념이 없으므로 준비 조건은 표현하지 않습니다. DependsOn은 한 템플릿 안의 리소스를 가리키므로 두 스택에 걸친 순서는 표현할 수 없습니다. 운영자는 별도의 스택을 배포 계층에서 순서화합니다.
  • Terraform의 경우: terraform provider는 경계가 조립되는 루트 구성의 module 블록 사이의 depends_on으로 순서를 표현하며, 각 모듈은 바로 앞의 채워진 웨이브의 모듈을 지정하고 나머지는 Terraform이 연쇄합니다. 이는 Terraform이 수행하는 작업의 순서를 정할 뿐 준비 상태 조건은 표현하지 않습니다. 구성에는 리소스가 서비스 가능하다는 개념이 없기 때문입니다. depends_on은 하나의 구성 안의 모듈을 지정하므로 두 루트 구성에 걸친 순서는 표현할 수 없으며, 이들의 순서 지정은 운영자의 몫입니다.

Aggrega 내부 aggrega.ai/sync-wave: "<N>" 키는 관측성과 출처 추적 용도로 ArgoCD 어노테이션과 함께 제공됩니다. helm 출력과 Recipe가 helm-chart 차트에 추가하는 템플릿 파일에서는 어노테이션으로, compose에서는 서비스 레이블로, 각 terraform 모듈에서는 출처 주석의 한 줄로, 각 cloudformation 리소스에서는 Metadata."aggrega.ai/provenance" 아래에 제공되며, GitOps 컨트롤러가 소비하는 것은 ArgoCD 어노테이션입니다.

웨이브 작성 단위와 배포 가능 단위

경계는 웨이브 작성 단위입니다. 배포 가능 단위는 조립 경로, 즉 컴파일러가 생성하고 CI/CD 파이프라인이 대상으로 삼아 오케스트레이션하는 디스크상의 출력입니다. 기본적으로 하나의 경계는 하나의 조립 경로에 대응합니다. 각 경계의 component는 boundaries/<boundary-name>/<provider>/ 아래에 출력되며, helm install / docker compose up은 그 경로를 대상으로 실행됩니다.

운영자는 이 1:1 대응을 합칠 수 있습니다. 경계는 directory:(및 subDirectory:) 경로 템플릿 필드를 선언할 수 있으며, 이 필드가 여러 경계에서 공유되면 해당 경계들의 component가 공유 경로의 단일 조립 출력으로 라우팅됩니다. directory: "deploy/cluster"를 선언한 두 경계는 양쪽 component를 모두 담은 하나의 조립 출력을 생성합니다. 배포 가능 단위는 경계의 정체성이 아니라 조립 경로가 됩니다.

하나의 조립 출력 안에 웨이브가 섞인 매니페스트가 있는 것은 정상이며 지원됩니다. 경계 A가 syncWave: 1을, 경계 B가 syncWave: 2를 선언하고 둘 다 directory: "deploy/cluster"를 공유하면, 결과 배포 단위에는 두 경계의 component가 모두 포함되며 각 매니페스트는 작성한 경계의 웨이브 어노테이션을 가집니다. 런타임 도구는 리소스별 어노테이션을 읽고 조립된 배포 단위 안에서 순서를 정합니다. ArgoCD의 Application별 동기화 컨텍스트는 웨이브 1 매니페스트를 처리하고, 그것들이 Healthy가 될 때까지 기다린 다음 웨이브 2를 처리합니다. Helm의 훅 순서 지정은 훅 리소스별로 helm.sh/hook-weight를 읽습니다. 이것이 표준 ArgoCD 패턴이며, 리소스별 출력은 도구 간 소비자가 기대하는 입력 그대로입니다.

Application 간 순서 지정(운영자가 별도의 조립 출력을 대상으로 여러 ArgoCD Application을 실행하는 경우)은 운영자 수준의 CI 구성입니다. Aggrega는 아티팩트를 생성하고, 운영자는 app-of-apps 또는 Progressive Sync로 그 주위에 ArgoCD Application을 연결합니다. Aggrega의 리소스별 어노테이션 패턴은 모든 도구 간 소비자가 기대하는 표준 입력 형태입니다.

2. 동적 주소 지정 폴리필

문제: 클라우드는 생성 시점에 비결정적입니다. AWS RDS 인스턴스나 S3 버킷 같은 리소스는 물리적으로 프로비저닝된 후에야 무작위 URL 해시를 생성합니다. AOT 컴파일러는 클라우드가 무엇이든 프로비저닝하기 전에 구성을 생성하므로, 컴파일러가 실제 데이터베이스 URL을 컨테이너의 환경 변수에 주입하는 것은 물리적으로 불가능합니다.

해결책: 자격 증명 Features를 통한 결정적 포인터 Aggrega는 기존 자격 증명 Features를 활용하여 “결정적”의 정의를 실제 IP 주소에서 결정적 포인터로 옮김으로써 이를 해결합니다. 생성된 구성은 URL을 전달하지 않고, URL이 존재하게 될 Cloud Vault의 경로를 전달합니다.

  • 예시 1: 출력 생성(Terraform RDS) 데이터베이스용 Ops Recipe가 AWS RDS 인스턴스를 생성합니다. 핵심은 이 Recipe가 새로 생성된 동적 URL을 결정적으로 이름 붙여진 경로(예: /aggrega/prod/db-url)의 AWS Systems Manager(SSM) Parameter Store에 네이티브하게 출력하도록 작성된다는 점입니다.
  • 예 2: 입력 주입(Kubernetes 앱) 개발자는 자격 증명 Feature core/referenced-secret를 worker의 Component가 선언한 슬롯에 연결하고, origin을 결정적 포인터 문자열("/aggrega/prod/db-url")로 설정합니다. Kubernetes 대상에서 Manifest는 그 연결을 helm/k8s-external-secret에 바인딩하며, 이는 클러스터의 시크릿 저장소 오퍼레이터에게 그 항목을 Secret으로 가져오도록 요청하는 Kubernetes ExternalSecret을 렌더링하고 Secret의 이름과 데이터 키를 게시합니다. worker의 Recipe는 컨테이너의 attachments:를 통해 이를 읽고 valueFrom: secretKeyRef에 매핑된 Pod 환경 변수를 렌더링합니다(자격 증명이 컨테이너에 도달하는 방식 참조). 컴파일러는 포인터 문자열을 전달할 뿐 URL을 읽지 않습니다.

런타임에 Terraform이 DB를 프로비저닝하고 URL을 vault에 저장합니다. 컨테이너가 부팅되어 vault에서 조정된 Secret을 읽고 연결합니다. AOT 컴파일러는 실제 IP 주소가 전혀 필요 없이 안정적인 포인터 문자열로 관계를 생성했습니다.

3. 명령형 작업(실행 가능한 인계)

문제: 선언적 상태는 Day-1 프로비저닝에는 완벽하지만, 개발자는 명령형 작업을 실행해야 합니다: “지금 바로 DB 백업을 실행하라.” 엄격하게 선언적인 GitOps 파이프라인에는 정적 스크립트를 다시 트리거하는 기본 메커니즘이 없습니다.

해결책: 휴면 작업과 대상 자체의 명령 Aggrega는 엄격한 AOT 순수성을 유지하면서 이 문제를 해결합니다. 시작하지 않은 채로 배포되는 작업의 구성을 생성하며, 각 실행은 대상에서 대상 자체의 명령으로 시작됩니다.

  1. 개발자 의도: 개발자는 스크립트를 Aggregate에서 task로 선언하고, 요청 시 실행되도록 요구하는 Feature를 연결합니다(예: core/manual-trigger). 요청 시 실행된다는 것은 작업의 본질의 일부이므로 개발자가 연결합니다. 입력이 모두 운영에 관한 Feature는 대신 운영 측이 Release에서 연결합니다.
  2. 휴면 형태: 각 대상에서 작업 자체의 Recipe가 attachment를 읽고, 실행을 시작하지 않은 채 배포되는 형태로 작업을 렌더링합니다. Kubernetes에서 작업은 배포되자마자 실행될 Job 대신, suspend: true로 보류되고 결코 오지 않는 날짜를 지정한 일정을 가진 CronJob이 됩니다. Docker Compose에서는 종료된 후 Compose가 다시 시작하지 않는 작업의 서비스에 프로필 manual이 붙으므로, docker compose up은 이를 중지된 상태로 둡니다. Amazon ECS에서는 Terraform을 통하든 CloudFormation을 통하든 작업 정의가 단독으로 배포되며, 이를 시작할 일정이 없습니다. Manifest가 이 attachment에 바인딩하는 FeatureRecipe는 어떤 대상에서도 자체 파일을 추가하지 않습니다. 변경은 작업 자체의 출력에 있습니다.
  3. 인계: 컴파일러는 어떤 클러스터에도 접근하지 않고 어떤 클라우드 API도 호출하지 않으며, 빌드는 실행을 시작하지 않고 스크립트를 작성하지 않습니다. 각 실행은 운영자가 대상 자체의 명령으로 시작합니다. Kubernetes에서는 kubectl create job <run-name> --from=cronjob/<cronjob>, Docker Compose에서는 docker compose run --rm <service>, Amazon ECS에서는 aws ecs run-task를 사용하며, Release가 작업의 infra.overrides 아래에 설정한 클러스터, 작업 정의, 네트워크 구성을 지정합니다. 구성 생성과 런타임 실행은 분리된 상태로 유지됩니다.

(참고: Kubernetes와 Amazon ECS에서는 일정을 가진 작업이 attachment 유무와 관계없이 그 일정에 따라 실행되며, 같은 명령으로 예약된 실행 사이에 추가 실행을 시작합니다. 스케줄러가 없는 Docker Compose에서는 작업의 Recipe가 일정을 거부합니다. 실습 예제 task-run-on-demand는 하나의 Aggregate를 Kubernetes, Docker Compose, Terraform, CloudFormation용으로 빌드하고, 각각에 대해 렌더링된 출력과 실행을 시작하는 명령을 보여 줍니다.)

4. 사전 분석: Workspace 훅(플랫폼 RBAC 및 할당량)

문제: 일부 변경은 대규모 GPU 클러스터처럼 비용이 많이 들거나 프로덕션에 중요한 인프라를 프로비저닝하므로, 검토 없이 GitOps 파이프라인으로 흘러가서는 안 됩니다. 어떤 기여자가 어떤 변경을 어떤 환경으로 승격할 수 있는지는 조직의 정책 결정이며, 컴파일러가 이를 하드코딩해서는 안 됩니다.

해결책: 순수한 AOT 컴파일러는 빌드를 실행하는 주체를 파악하기 위해 Active Directory에 핑을 보내거나 클라우드 자격 증명을 가져올 수 없습니다. CI/CD가 실행되기 전에 무단 생성을 방지하기 위해, 이 아키텍처는 명시적인 컨텍스트 주입에 의존합니다.

CI/CD 러너가 aggrega build를 호출하면, 파이프라인은 실행 컨텍스트를 --config로 전달하는 구성 파일에, 이를 판정하는 거버넌스 연결의 with.settings로 기록합니다(예: approval: standard). 이 파일은 연결을 governance_append 아래에 나열하므로, 이 연결들은 워크스페이스 자체 구성이 연결하는 거버넌스 플러그인으로 대체되지 않고 그 플러그인에 추가됩니다. ir-verdict 역할의 정책은 이 설정을 input.settings로 읽습니다. 이 정책은 Release가 아니라 조립된 그래프를 받으므로 Release의 환경은 레이블로 전달됩니다. label-transform 역할의 정책이 input.compilation_context.environment를 읽고 각 노드에 그 레이블을 붙입니다. 판정은 둘을 비교하여 일치하지 않으면 빌드를 중단합니다. 여기서는 설정에 approval: platform-approved가 없는 프로덕션 빌드입니다:

# ci-governance.yaml — written by the CI/CD runner, passed as `aggrega build --config ci-governance.yaml`
plugins:
governance_append:
- uri: governance/rego:<version>
role: label-transform
with:
sources:
- policies/environment.rego
- uri: governance/rego:<version>
role: ir-verdict
with:
sources:
- policies/approval.rego
settings:
approval: standard
# policies/environment.rego — evaluated by the governance label-transform role, during topology construction
package acme.context
import rego.v1
labels contains {"node": id, "key": "acme.com/environment", "value": input.compilation_context.environment} if {
some id, _ in input.graph.nodes
}
# policies/approval.rego — evaluated by the governance ir-verdict role over the assembled graph
package acme.approval
import rego.v1
approved if input.settings.approval == "platform-approved"
deny contains msg if {
not approved
some node in input.graph.spec.nodes
node.labels["acme.com/environment"] == "production"
msg := "a production build needs the approval platform-approved in the pipeline's governance settings."
}

설정에 승인이 전혀 없는 실행도 거부됩니다. 규칙은 다른 승인이 있는지가 아니라 해당 승인이 있는지를 묻기 때문입니다. 이렇게 하면 RBAC가 컴파일러의 네이티브 로직과 분리되어, 컴파일러는 제공된 데이터의 결정적 평가자로만 동작합니다.

5. Shift-Left FinOps(정책을 통한 비용 추정)

문제: 실수로 인한 잘못된 구성(예: workers: 500 요청)은 재무 안전장치를 우회하여 큰 클라우드 비용 초과를 일으킬 수 있습니다.

해결책(엔터프라이즈 Wasm 정책): IR 그래프에는 전체 토폴로지가, Release에는 물리적 매핑(.infra)이 들어 있으므로, 기업은 하드코딩된 컴파일러 기능 없이도 생성 전에 Release가 배포하는 것의 정확한 비용을 평가할 수 있습니다. 기업은 사용자 정의 FinOps WebAssembly 플러그인을 작성하여 판정 역할로 거버넌스 소켓에 연결하기만 하면 됩니다. 이 사용자 정의 플러그인은 .infra 페이로드를 읽고 예상 월간 비용을 계산한 뒤, 계산된 비용이 기업 내부에서 정의한 예산 한도를 초과하면 빌드를 중단할 수 있습니다.

6. “브라운필드” 가져오기 수명 주기

문제: 기업은 이미 대부분의 인프라를 운영하고 있습니다. Aggrega는 참조 워크로드(패스스루 네트워킹, 참조 워크로드 참조)를 통해 빌드를 관리되지 않는 인프라에 연결하도록 설계되었지만, 기존 Oracle 데이터베이스를 Aggrega가 생성한 Terraform 상태로 옮기면 일반적으로 오케스트레이터가 데이터베이스를 재생성하려고 시도하여 기존 데이터가 파괴됩니다.

해결책(계획됨): 가져오기 수명 주기를 관리하기 위한 core/resource-adoption Feature가 계획되어 있습니다.

개발자가 기존 데이터베이스를 Aggregate에 모델링하고 순차적으로 실행되는 파이프라인에서 resource-adoption 기능을 연결하면, Wasm 렌더링 플러그인은 기본 운영 Recipe 페이로드를 평가하도록 설계되어 있습니다. 플러그인은 표준 생성 구성을 내보내는 대신 대상 플랫폼의 명시적 채택 구문을 출력하도록 설계되어 있습니다(예: Terraform import {} 블록이나 Crossplane ObserveOnly 관리 정책이 담긴 JSONPatch 반환). 이를 통해 기업은 다운타임 없이 레거시 아키텍처를 GitOps 컨트롤 플레인으로 흡수하는 구성을 안전하게 생성할 수 있습니다.

7. 운영 모범 사례와 결정적 명명

코어 컴파일러는 평면 IR 그래프에서 안정적인 내부 노드 ID(예: support-db)에 의존하지만, 물리적 클라우드 공급자(AWS, Azure, GCP 등)는 물리적 인프라에 전역적으로 고유한 문자열(예: S3 버킷 이름, IAM 역할 이름, API Gateway 도메인)을 요구하는 경우가 많습니다.

플랫폼 운영 엔지니어가 기본 템플릿에 물리적 이름을 하드코딩하면(예: bucket_name: "enterprise-data-bucket"), 생성된 아티팩트는 처음에는 문제없이 적용됩니다. 그러나 개발자가 두 번째 환경(예: staging 대 prod)을 배포하면 클라우드 공급자는 이름 충돌로 인해 런타임에 두 번째 환경의 리소스를 거부합니다.

결정적 출력 규칙(GitOps 안전성): GitOps 컨트롤러(ArgoCD, Flux)는 렌더링된 아티팩트에 대해 바이트 수준의 차이 감지를 수행하므로, 컴파일러는 동일한 입력이 바이트 단위로 동일한 출력을 생성하도록 보장합니다. 템플릿 컨텍스트를 통해 흐르는 맵(.context.inject.env, .values, .infra 및 나머지 런타임 뷰)은 데이터 계층 전반에서 작성자의 삽입 순서를 보존하는 순서 있는 맵 구조를 기반으로 하며, 템플릿 경계가 유일한 예외입니다. 이러한 맵에 대한 {{ range }}는 Go 템플릿과 마찬가지로 작성자 순서가 아니라 키의 알파벳 순서로 반복합니다. 운영 엔지니어는 동일한 입력의 실행 간에 그 반복 순서가 결정적이라는 점에 의존할 수 있습니다. 순서가 의미를 가지는 경우에는 맵에서 복원하는 대신 목록으로 작성합니다. 그러나 Sprig keys 함수는 Go 맵 반복 순서(언어 설계상 비결정적)를 반환하므로, keys 출력으로 결정적인 키 시퀀스를 구성하는 템플릿은 결정성을 회복하기 위해 sortAlpha를 거쳐야 합니다(예: {{ keys .values | sortAlpha }}).

운영 Recipes를 위한 황금률(Helm 패턴): 플랫폼 운영 엔지니어는 물리적 클라우드 리소스 이름을 절대 하드코딩해서는 안 됩니다. 대신 템플릿 평가 단계에서 Aggrega 배포 컨텍스트를 연결하여 결정적으로 고유한 이름을 구성해야 합니다. 이는 결정성 규칙이 아니라 재사용성 및 충돌 안전성 규칙입니다. 하드코딩된 이름은 안정적인 출력을 생성하지만, 동일한 Recipe가 여러 컴포넌트 인스턴스를 렌더링하거나 동일한 Aggregate가 여러 Releases에 걸쳐 배포될 때 치명적으로 충돌합니다.

컴파일러는 전역 고유성을 보장하기 위해 정확히 두 개의 변수를 제공합니다:

  1. {{ .metadata.release_name }}: 배포를 주도하는 Release의 이름(예: prod-billing).
  2. {{ .context.instance_id }}: 개발자의 Aggregate에 있는 특정 Component ID(예: receipt-storage).

이들을 연결하면(예: {{ .metadata.release_name }}-{{ .context.instance_id }}), 운영 측은 개발자가 물리적 명명 관례를 관리할 필요 없이 Wasm 플러그인이 생성한 구성이 환경별, 컴포넌트별로 고유한 리소스 이름을 사용하도록 보장합니다.