빌드의 파일
이 페이지는 하나의 개념, 즉 빌드의 어떤 파일이 무엇을 말하는지를 설명하며, 실행 가능한 작업 공간이 아닙니다. PostgreSQL을 사용하는 웹 앱, 한 단계씩 구성하기에서 직접 빌드하는 작업 공간으로 이를 보여 줍니다. 다음 명령으로 자신의 폴더에 작성하십시오:
aggrega scaffold --example quickstart-web그런 다음 이어서 실행할 명령을 출력합니다:
cd quickstart-webcd 1aggrega build --release release.yaml --auto-pullexport QUICKSTART_DB_PASSWORD=choose-a-passworddocker compose -p quickstart-web -f dist/compose/docker-compose.yaml up -d --wait# then open http://127.0.0.1:8080/ in your browser다섯 종류의 파일, 각각 한 명의 작성자
빌드는 다섯 종류의 파일을 읽습니다. 각 파일은 한 가지를 말하며, 일반적인 팀에서는 각각 고유한 작성자가 있습니다:
- Component는 어떤 종류의 컴포넌트가 무엇인지를 말합니다. 개발자가 설정할 수 있는 값, 운영자가 설정할 수 있는 인프라 설정, 자신에게 연결하는 컴포넌트에 게시하는 내용, 그리고 연결에 사용하는 소켓입니다. 표준 라이브러리 카탈로그는
core/datastore/postgres와core/compute/server처럼 대부분의 애플리케이션에 필요한 Components를 제공하므로, 작업 공간은 보통 하나도 작성하지 않습니다; - Aggregate는 개발자의 것입니다. 애플리케이션에 어떤 컴포넌트가 있고 각각이 무엇에 연결되는지를 나타냅니다;
- Recipe는 한 종류의 컴포넌트를 하나의 도구용 파일로 변환합니다 — Compose 서비스, Helm 차트, Terraform 모듈 등입니다;
- Manifest는 하나의 대상에 대해 각 종류의 컴포넌트를 어떤 Recipe가 구현할지 선택합니다;
- Release는 Aggregate와 Manifest를 지정하고 한 환경의 설정을 제공합니다. 빌드하는 대상이 바로 이것입니다:
aggrega build --release release.yaml.
이 분담은 지침입니다. 한 사람이 다섯 가지를 모두 작성해도 되며, 빌드는 각각이 유효하기만 하면 어느 것이든 받아들입니다.
Aggregate: 컴포넌트와 그 연결
예제의 첫 단계는 웹 애플리케이션과 그 데이터베이스입니다. 주석을 생략한 1/aggregate.yaml의 Aggregate는 다음과 같습니다:
spec: components: web: type: core/compute/server features: db_password: type: core/secret-value values: key: PGPASSWORD origin: "${QUICKSTART_DB_PASSWORD}" uses: database: db: target: db inject: env: - in: PGHOST from: host - in: PGPORT from: port - in: PGUSER from: user - in: PGDATABASE from: database
db: type: core/datastore/postgres features: password: type: core/secret-value values: key: POSTGRES_PASSWORD origin: "${QUICKSTART_DB_PASSWORD}"여기서는 포트, 호스트, 네임스페이스, 도구 중 어느 것도 지정하지 않습니다. web은 자신의 database 소켓을 통해 db에 연결되며, inject 목록은 데이터베이스가 게시하는 각 항목을 애플리케이션의 어떤 변수가 받는지를 나타냅니다. from:은 항목을, in:은 변수를 지정합니다.
연결은 파이프로 전달되는 문자열
데이터베이스의 Recipe는 연결이 읽을 수 있도록 host, port, user, database를 게시합니다. host가 어떤 주소를 담는지는 Manifest가 선택한 Recipe에 따릅니다. 데이터베이스가 애플리케이션 옆에서 실행되는 경우에는 서비스 이름, 관리형 데이터베이스의 경우에는 프로비저닝 도구가 해석하는 포인터 문자열, 또는 이미 존재하는 서버의 주소입니다. 빌드는 게시된 각 문자열을 Aggregate가 지정한 변수에 복사하며 그 의미를 해석하지 않습니다. 주소를 해석하거나 도달 가능한지 확인하는 일은 결코 없습니다.
Manifest와 Release
1/manifest.yaml의 Manifest는 각 종류의 컴포넌트와 비밀번호 첨부를 Docker Compose에서 이를 구현하는 Recipe에 바인딩합니다:
spec: mappings: components: type: core/compute/server:1.1.0: compose/server:2.0.0 core/datastore/postgres:1.0.0: compose/postgres:1.0.0 features: type: core/secret-value:1.0.0: compose/dotenv-secret:1.0.01/release.yaml의 Release는 Aggregate와 Manifest를 지정하고 환경만이 아는 것, 여기서는 애플리케이션이 실행하는 이미지, 수신 대기하는 포트, 그리고 Docker Compose가 머신의 루프백 주소에서 이를 게시하는 포트를 제공합니다(이미지의 다이제스트는 줄여서 표시):
spec: aggregate: quickstart-web manifest: quickstart-web-compose components: web: infra: image: hub.aggrega.ai/tools/quickstart-web:1.1.0@sha256:… port: 8080 published_port: 8080 db: {}예제의 이후 단계에서 이를 확장합니다. 데이터베이스 옆에 Redis 캐시를 추가하고, 그다음 같은 컴포넌트를 Terraform을 통해 AWS에 배치하고, 그다음 데이터베이스의 백업을 추가합니다.
매개변수: 하나의 Aggregate, 여러 환경
환경마다 다른 값은 Aggregate에서 타입이 지정된 매개변수로 선언하고, 사용되는 곳에서 참조하며, 각 Release가 값을 제공합니다. 필요할 때 실행하는 작업에서 Aggregate는 보고서의 일정을 선언합니다:
spec: parameters: report_schedule: type: string default: "" components: report: type: core/compute/task values: schedule: "{{ .parameters.report_schedule }}"그리고 Release가 이를 충족합니다:
spec: parameters: report_schedule: "30 2 * * 1-5"빌드는 템플릿을 채우기 전에 Release가 제공하는 각 값을 매개변수의 타입과 대조해 검사합니다. Release는 컴포넌트의 values를 직접 작성하지 않습니다. Aggregate가 노출하는 매개변수를 충족할 뿐이므로, 어떤 값이 환경에 따라 달라지는지를 말하는 곳은 여전히 Aggregate 하나뿐입니다. Release는 매개변수 전용 파일에서 매개변수를 읽을 수도 있습니다: parameters: { $import: ./env/prod-values.yaml }.