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

하나의 Aggregate, 두 가지 크기의 MySQL 클러스터

MySQL InnoDB Cluster와 이를 조정하는 컨트롤 플레인을 변경되지 않은 하나의 Aggregate로 두 번 빌드합니다. 한 번은 서버 인스턴스 하나를 요청하고, 한 번은 세 개를 요청합니다.

이 예제의 교훈은 크기가 어디에 있는가입니다. 데이터베이스 뒤에 몇 개의 서버가 있는지는 개발자가 작성한 것도, Recipe가 결정한 것도 아닙니다. 그것은 Release에 있는 운영자 크기 설정 한 줄이며, 렌더링된 두 트리 사이의 차이 전부입니다.

컴파일러가 작성하는 것과 작성하지 않는 것

이 구현은 InnoDBCluster 커스텀 리소스를 출력합니다. 서버, Service, 라우터는 출력하지 않습니다. 이들은 커스텀 리소스가 적용된 후 MySQL Operator for Kubernetes가 대상 클러스터 안에서 생성하며, 이 작업은 컴파일러가 끝난 지 한참 후에 일어납니다.

따라서 아래의 모든 내용은 렌더링된 커스텀 리소스가 요청하는 것을 설명합니다. 실행 중인 클러스터가 결국 무엇을 포함하게 되는지는 그 요청에 대한 컨트롤러의 응답이며, 컴파일러가 볼 수 없는 시점에 이루어집니다. 컴파일러는 이를 확인할 방법이 없으므로 이에 대해 아무것도 주장하지 않습니다.

달라지는 단 한 가지

.-- release-single.yaml ----- spec.instances: 1
/
one Aggregate -- one Manifest -+
one Component \
one Recipe '- release-replicated.yaml -- spec.instances: 3

두 Releases 모두 같은 Component와 같은 Recipe를 선택하므로, Release마다 하나씩이 아니라 Manifest는 하나입니다. 두 Releases가 크기 설정만 다를 때, Ops 매핑은 그 차이에 대해 할 말이 없으며, 매핑의 두 번째 사본은 아무 이득 없이 동기화를 유지해야 할 또 하나의 대상이 될 뿐입니다.

파일

  • aggregate.yaml — 개발자의 의도이며, 두 Releases에 대해 동일한 문서입니다. 컨트롤 플레인용 mysql-operator 컴포넌트, core/datastore/mysql-innodb-cluster 유형의 db 컴포넌트, 그리고 개발자가 서버에서 사용하기를 원하는 문자 집합을 담고 있습니다. 여기에는 서버가 몇 개인지에 대한 내용이 없습니다.
  • manifest.yaml — 두 Releases가 공유하는 Ops 매핑입니다. 두 줄로, 어떤 Recipe가 컨트롤 플레인을 구현하고 어떤 Recipe가 데이터베이스를 구현하는지를 나타냅니다.
  • release-single.yaml, release-replicated.yaml — 운영자의 크기 설정입니다. 두 파일은 metadata.name과 server_instances에서 다르며, 한 줄이 차이의 전부가 되도록 다른 모든 필드를 의도적으로 같게 유지합니다.
  • .aggrega-config.yaml — 표준 라이브러리 카탈로그를 해석해 오는 hub 레지스트리를 지정합니다. 이 예제는 자체 엔터티를 작성하지 않습니다.

예제 생성하기

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

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

Terminal window
aggrega scaffold --example mysql-innodb-cluster

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

Terminal window
cd mysql-innodb-cluster

빌드

Terminal window
aggrega build --release release-single.yaml --auto-pull
aggrega build --release release-replicated.yaml --auto-pull

--auto-pull은 새로 클론한 저장소에 없는 lockfile을 빌드 중에 기록합니다. 각 빌드는 dist/에 기록하며, 이전 빌드가 남긴 것을 지우지 않고 자신의 파일을 추가합니다. 한 Release의 출력만 따로 보려면 실행 사이에 dist/를 삭제하십시오:

Terminal window
rm -rf dist && aggrega build --release release-replicated.yaml --auto-pull

각 Release는 다섯 개의 파일을 렌더링합니다. 데이터베이스의 커스텀 리소스와, 컨트롤 플레인을 구성하는 네 개의 파일입니다.

dist/stack/helm/db/innodbcluster.yaml
dist/stack/helm/mysql-operator/clusterrole.yaml
dist/stack/helm/mysql-operator/clusterrolebinding.yaml
dist/stack/helm/mysql-operator/deployment.yaml
dist/stack/helm/mysql-operator/serviceaccount.yaml

AI 어시스턴트 사용

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

Aggrega 도구만 사용하고 폴더를 직접 만들지 마십시오. 작업 공간 폴더에 아직 `mysql-innodb-cluster` 폴더가 없으면 `example`에 `mysql-innodb-cluster` 값을 지정하고 `dir` 없이 `scaffold` 도구를 한 번 호출하십시오. 그러면 예제가 새 `mysql-innodb-cluster` 폴더에 작성됩니다. 그런 다음 각 Release마다 `release-single.yaml`, `release-replicated.yaml` 순서로 `build` 도구를 한 번씩 호출하되, 매번 `workspace_root` 값은 `mysql-innodb-cluster`, `release` 값은 해당 파일, `auto_pull` 값은 true, `write` 값은 true로 설정하십시오. 각 빌드가 작성한 파일을 알려 주십시오. 파일은 `mysql-innodb-cluster/dist/` 아래에 있습니다.

데이터베이스의 렌더링 결과

# dist/stack/helm/db/innodbcluster.yaml — aggrega build --release release-single.yaml
apiVersion: mysql.oracle.com/v2
kind: InnoDBCluster
metadata:
[… omitted: the labels and annotations, described below]
name: db
spec:
instances: 1
router:
instances: 1
version: "8.4.0"
secretName: "mysql-root"
mycnf: |
[mysqld]
character-set-server=utf8mb4
collation-server=utf8mb4_0900_ai_ci

렌더링된 파일에는 Aggrega가 렌더링하는 모든 아티팩트에 붙이는 레이블과 어노테이션도 포함됩니다. 어떤 Aggregate, 어떤 컴포넌트, 어떤 Recipe, 어떤 경계에서 왔는지를 나타내며, 요청 자체에 집중하기 위해 여기서는 생략했습니다.

다섯 개의 spec 항목 중 네 개는 작성된 무언가로 곧바로 거슬러 올라갑니다. instances는 Release의 server_instances로, version은 Component의 engine_version 기본값으로, secretName은 Release의 credentials_secret으로, mycnf 블록은 개발자의 charset과 collation으로 이어집니다. 다섯 번째인 router.instances는 아래에서 다룹니다.

핵심이 되는 비교

렌더링된 두 트리 사이의 차이 전부:

--- dist/stack/helm/db/innodbcluster.yaml (single)
+++ dist/stack/helm/db/innodbcluster.yaml (replicated)
spec:
- instances: 1
+ instances: 3
router:
instances: 1

다섯 파일 중 하나에서 한 줄입니다. 네 개의 컨트롤 플레인 파일은 두 Releases 사이에서 바이트 단위로 동일합니다. 인스턴스 하나의 요청을 조정하는 컨트롤러와 인스턴스 세 개의 요청을 조정하는 컨트롤러는 같은 컨트롤러이므로, 그에 관해서는 아무것도 달라지지 않습니다.

라우터 수도 달라지지 않으며, 이 컴포넌트가 자유롭게 조절하도록 제공하는 값도 아닙니다. 컴포넌트가 게시하는 주소는 라우터가 응답하는 Service이므로, 라우터 수는 커스텀 리소스 자체의 기본값으로 노출되며 그보다 낮아지지 않습니다. 이는 이 예제가 변화시키는 크기가 아니라 Release가 요청할 수 있는 범위의 한계이며, 그래서 이 줄이 위의 diff에 변경 없이 나타납니다.

컨트롤 플레인

dist/stack/helm/mysql-operator/deployment.yaml
[… omitted: the Deployment's metadata, selector and pod template up to the containers]
containers:
- name: controller
image: container-registry.oracle.com/mysql/community-operator:26.7.0-2.3.0
[… omitted: the controller's readiness probe]

어느 Release도 이미지를 지정하지 않습니다. 참조는 Component 자체의 infra.image 기본값에서 오므로, 아무것도 설정하지 않은 Release도 적용하기 전에 채워 넣어야 하는 Deployment가 아니라 하나의 버전이 지정된 Deployment를 렌더링합니다. 자체 레지스트리 미러에서 이미지를 가져오는 대상은 Release에서 infra.image를 설정하여 그 참조를 대신 사용합니다.

컨트롤 플레인은 Aggregate에서 데이터베이스 옆에 선언됩니다. 커스텀 리소스는 그 자체로는 아무 동작도 하지 않으며, 컨트롤러가 이를 감시할 때 비로소 실행 중인 서버가 되기 때문입니다. 둘을 함께 선언하기 때문에 둘을 하나의 단위로 적용할 수 있습니다.

전제 조건은 탐지되지 않고 선언됩니다

컴파일러는 사전에 실행되며 클러스터에 접속하지 않으므로, 컨트롤러가 설치되어 있는지 확인할 수 없습니다. 대신 묻습니다. control_plane_present를 설정하지 않으면 빌드가 중단됩니다.

[… omitted: the pull's lines, which carry the same halt]
[CATALOG_ERROR E0033]
Recipe/FeatureRecipe assertions
caused by: Recipe "mysql-innodb-cluster" instance "db" assertion "mysql_operator_prerequisite": assertion "Recipe/mysql-innodb-cluster/db/mysql_operator_prerequisite": template: Recipe/mysql-innodb-cluster/db/mysql_operator_prerequisite:1:48: executing "Recipe/mysql-innodb-cluster/db/mysql_operator_prerequisite" at <fail "the MySQL Operator control plane must be installed in the target cluster before this realization emits its InnoDBCluster custom resource; once the control plane is present, affirm the prerequisite by setting infra.control_plane_present to true in the Release">: error calling fail: assertion failed: the MySQL Operator control plane must be installed in the target cluster before this realization emits its InnoDBCluster custom resource; once the control plane is present, affirm the prerequisite by setting infra.control_plane_present to true in the Release

아무것도 기록되지 않습니다. 아무도 조정하지 않는 커스텀 리소스는 작동하는 것보다 작은 성공이 아닙니다. 깔끔하게 적용된 뒤 그대로 방치되는 아티팩트일 뿐이므로, 빌드는 이를 생성하지 않고 그렇지 않음을 밝힐 수 있는 키의 이름을 알려 줍니다.

루트 계정

여기서 두 Releases는 모두 대상 클러스터에 이미 존재하는 Secret을 클러스터가 가리키도록 합니다.

db:
infra:
credentials_secret: mysql-root

그 Secret에 대해서는 아무것도 렌더링되지 않으며 어떤 비밀번호도 출력에 포함되지 않습니다. 커스텀 리소스는 이름을 담고, 컨트롤러가 그 Secret에서 계정을 읽습니다. 대신 infra.credentials를 generated로 설정하면 컴포넌트의 root_password 슬롯에 연결된 자격 증명으로 커스텀 리소스 옆에 Secret을 렌더링합니다. 이 경우 비밀번호가 렌더링된 출력에 포함되며, 출력이 클러스터를 프로비저닝하는 경우에 적합한 선택입니다.

이 구현이 생성하지 않는 것은 논리 데이터베이스나 애플리케이션 사용자입니다. 컨트롤러는 클러스터의 루트 계정만 설정하고 그 아래의 것은 설정하지 않으므로, 애플리케이션에 필요한 스키마와 계정은 루트 권한을 가진 사람이 생성합니다.

어떤 구현을 선택할 것인가

먼저 설치해야 할 것이 없어야 한다면 core/datastore/mysql과 그 합성된 Recipe를 선택하십시오. 클러스터에 컨트롤러가 필요 없고 접근할 차트 저장소도 필요 없으므로 아무것도 가져오지 않고 빌드되며, 애플리케이션이 요청하는 논리 데이터베이스와 로그인 역할을 생성합니다. 대상이 이미 MySQL Operator 컨트롤 플레인을 실행하고 있거나 이 예제처럼 이를 설치하고, 애플리케이션에 필요한 것이 클러스터 내부 주소의 클러스터에 대한 루트 접근이라면 core/datastore/mysql-innodb-cluster를 선택하십시오.

합성된 구현의 단일 서버 형태는 ../mysql-standalone/에서 다루며, 여기서는 반복하지 않습니다.

경계가 있는 곳

인스턴스 하나와 세 개 사이의 선택은 개발자 문서를 건드리지 않았으며, Ops 매핑도 마찬가지였습니다. 이것이 이 예제가 구체적으로 보여 주려는 분담입니다.

  • 개발자는 애플리케이션이 데이터베이스에 무엇을 필요로 하는지를 말합니다.
  • Ops는 데이터베이스가 무엇으로 이루어지는지, 즉 어떤 Recipe가 이를 구현하는지를 말합니다.
  • 운영자는 이 데이터베이스가 얼마나 큰지를 말합니다.

server_instances를 커스텀 리소스가 허용하는 어떤 값으로 바꾸어도 이 디렉터리의 aggregate.yaml은 달라지지 않습니다.