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

카탈로그 전용 — 플랫폼 작성 없이 구성하는 MariaDB + Adminer

이 예제는 표준 라이브러리 카탈로그 엔터티만 참조하여 작지만 실제로 동작하는 스택, 즉 MariaDB 데이터베이스와 그 앞단의 Adminer 웹 UI를 배포합니다. 여기서는 Component, Feature, Recipe를 하나도 작성하지 않습니다. 짧은 YAML 파일 세 개가 모든 것을 카탈로그가 이미 제공하는 엔터티로 라우팅합니다.

이는 Aggrega가 제공하는 가장 작은 작성 범위이며, 언어를 처음 접하기에 자연스러운 출발점입니다. 작성 계층의 자매 예제는 자체 카탈로그 계층을 만들면서 같은 스택을 배포합니다. 먼저 이 예제를 읽고 완성된 카탈로그가 무엇을 제공하는지 확인한 다음, 그 예제를 읽고 그 아래 계층이 어떻게 만들어지는지 알아보십시오.

세 개의 파일

  • aggregate.yaml — Developer의 의도, 즉 스택이 무엇인지를 나타냅니다. type:으로 카탈로그에서 고른 두 개의 컴포넌트, 슬롯을 채우는 첨부로 지정한 필수 자격 증명, 그리고 데이터베이스를 Adminer의 databases 소켓에 연결하는 uses 엣지 하나로 구성됩니다.
  • release.yaml — Operator의 환경별 이행, 즉 얼마나 크게, 어디에를 나타냅니다. infra: 블록(엔진 버전, 스토리지 크기, 공개 포트)은 Operator에 속하며, Aggregate는 이를 절대 담지 않습니다.
  • manifest.yaml — Operator의 라우팅, 즉 이 대상에서 각 타입을 어떤 Recipe가 구현하는지를 나타냅니다. 참조가 provider로 한정되는 이유는 아래를 참조하십시오.

보여 주는 내용

  • 카탈로그 참조로서의 Components. type: core/datastore/mariadb와 type: core/devtool/adminer가 컴퓨트 선언의 전부입니다. Developer는 Component 스키마가 노출하는 값만 작성하며, 생략된 모든 필드는 스키마 기본값을 따릅니다(렌더링된 출력의 charset 및 collation 환경 변수를 이를 생성한 한 줄짜리 values: 블록과 비교해 보십시오).
  • String Pipe. Adminer의 카탈로그 Component는 component.aggrega.ai/type=stateful-server 레이블이 붙은 모든 컴포넌트를 받아들이는 databases uses 소켓을 선언합니다. Aggregate의 엣지는 데이터베이스 Recipe의 provides.host를 ADMINER_DEFAULT_SERVER에 주입합니다. 컴파일러는 이 문자열을 해석하지 않고 라우팅합니다. 이 대상에서는 compose 서비스 이름이지만, Kubernetes 대상에서는 같은 엣지가 Service DNS 이름을 전달합니다.
  • 첨부 기둥. 데이터베이스 Component의 featuresSchema는 root_password 슬롯을 요구하며, 이 슬롯은 카탈로그의 core/secret-value Feature로 채워집니다. 이 슬롯은 블랙박스입니다. Manifest가 선택한 FeatureRecipe가 전달 방식을 제어하며, Developer는 이를 지정할 수 없습니다.
  • Provider로 한정된 Recipe 라우팅. Manifest는 core/datastore/mariadb:1.0.0을 provider로 한정된 compose/mariadb:1.0.0에 매핑합니다. 표준 라이브러리가 mariadb Recipe를 둘 이상의 provider(compose와 helm 등)에서 제공하기 때문입니다. 대상을 명확히 정하는 것은 Operator의 매핑입니다. 한정되지 않은 단순 참조가 둘 이상의 provider의 Recipe와 일치하면, 조용히 하나를 고르지 않고 빌드를 명시적으로 중단합니다. 이 매핑을 다시 지정하여 스택의 대상을 바꾸십시오. Aggregate는 바뀌지 않습니다.

예제 생성하기

아래 명령으로 이 예제를 빌드하거나, AI 어시스턴트에게 대신 빌드하게 할 수 있습니다.

예제 이름을 딴 새 폴더에 예제를 씁니다:

Terminal window
aggrega scaffold --example catalog-only

그런 다음 이어서 실행할 명령을 출력합니다. 첫 번째 명령은 새 폴더로 이동합니다:

Terminal window
cd catalog-only

빌드

이 디렉터리에서, .aggrega-config.yaml이 지정하는 기본 레지스트리인 hub.aggrega.ai에서 카탈로그 엔터티를 해석하여 실행합니다:

Terminal window
aggrega pull --release release.yaml
aggrega build --release release.yaml

pull은 참조된 모든 엔터티를 해석하고 release.lock에 고정합니다(식별자 + 콘텐츠 다이제스트. 오래된 lockfile은 pull을 다시 실행하면 재생성됩니다). 표준 라이브러리 카탈로그의 체크아웃(얻는 곳)이 있으면 두 명령 모두에서 그 aggrega-catalog 디렉터리를 --catalog로 지정하여 엔터티를 그곳에서 읽을 수 있습니다. 빌드는 그 lockfile을 읽습니다. lockfile이 없으면 빌드는 중단되고 pull 또는 --auto-pull이라는 두 가지 진행 방법을 알려 줍니다. 그런 다음 dist/compose/docker-compose.yaml을 렌더링합니다. Release는 컴포넌트를 직접 작성하므로(boundaries: 블록 없음), 컴파일러는 이를 합성된 기본 범위로 합치고 dist/ 아래에 평탄하게 출력합니다. 경계는 하나이며, 경로에 경계 이름 세그먼트가 없습니다.

AI 어시스턴트 사용

Aggrega 도구로 설정한 AI 어시스턴트도 같은 작업을 할 수 있습니다. 다음 프롬프트를 붙여 넣으십시오.

Aggrega 도구만 사용하고 폴더를 직접 만들지 마십시오. 워크스페이스 폴더에 아직 `catalog-only` 폴더가 없으면 `example`에 `catalog-only`를 지정하고 `dir` 없이 `scaffold` 도구를 한 번 호출하십시오. 그러면 예제가 새 `catalog-only` 폴더에 쓰입니다. 그런 다음 `workspace_root`에 `catalog-only`, `release`에 `release.yaml`, `auto_pull`에 true, `write`에 true를 지정하여 `build` 도구를 호출하십시오. 빌드가 어떤 파일을 썼는지 알려 주십시오. 파일은 `catalog-only/dist/` 아래에 있습니다.

출력 읽기

렌더링된 compose 파일에서 연결 관계가 드러납니다.

  • web 서비스는 ADMINER_DEFAULT_SERVER: db를 담습니다. 이는 uses 엣지를 통해 전달된 데이터베이스 Recipe의 provides.host(compose 서비스 이름)입니다.
  • 같은 엣지가 depends_on: [db]를 생성했습니다. 문자열뿐 아니라 토폴로지도 전달됩니다.
  • db 서비스의 MARIADB_CHARACTER_SET_SERVER와 MARIADB_COLLATION_SERVER는 Aggregate가 전혀 언급하지 않는 스키마 기본값에서 옵니다.
  • image: mariadb:11.4와 8080:8080 포트 바인딩은 Release의 infra: 블록에서 옵니다. 이는 Operator의 기둥으로, Developer의 기둥과 나란히 렌더링됩니다.

실행

Terminal window
cd dist/compose
docker compose up -d

http://localhost:8080을 여십시오. 서버 필드에는 db가 미리 채워져 있습니다. Aggregate의 첨부에 있는 개발용 비밀번호(dev-root-pw-change-me — 로컬 개발 이외의 용도에서는 교체해야 하는 자리 표시자)로 root로 로그인하고, 데이터베이스는 appdb를 사용합니다.

다음 단계

작성 계층에서는 이 예제가 완성된 형태로 사용한 같은 플랫폼 계층, 즉 Components, Recipes, 자격 증명 FeatureRecipes를 직접 만들고, 하나의 Aggregate를 네 개의 대상으로 컴파일합니다.