Перейти до вмісту
AggregaAggrega
Обрати мову: Українська
Цю сторінку перекладено машинним способом. Читати оригінал англійською.

Один Aggregate, два розміри кластера MySQL

MySQL InnoDB Cluster і площина керування, що його узгоджує, зібрані двічі з одного незмінного Aggregate: один раз із запитом на один екземпляр сервера, другий — на три.

Урок у тому, де живе розмір. Скільки серверів стоїть за базою даних — це не те, що написав розробник, і не те, що вирішив Recipe: це один рядок операторського розміру в Release, і це все, чим відрізняються два згенеровані дерева.

Що компілятор записує, а що ні

Ця реалізація генерує власний ресурс InnoDBCluster. Вона не генерує сервери, сервіси чи маршрутизатори: 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, тож є один Manifest, а не по одному на кожен Release. Коли два Releases відрізняються лише розміром, Ops-відображенню нічого сказати про цю різницю, а друга його копія була б ще однією річчю, яку треба тримати узгодженою, без жодної користі.

Файли

  • aggregate.yaml — намір розробника, і той самий документ для обох Releases: компонент mysql-operator для площини керування, компонент db типу core/datastore/mysql-innodb-cluster і набір символів, яким розробник хоче, щоб говорив сервер. Тут ніщо не вказує, скільки є серверів.
  • manifest.yaml — Ops-відображення, спільне для обох Releases. Два рядки: який Recipe реалізує площину керування і який реалізує базу даних.
  • release-single.yaml, release-replicated.yaml — розмір від оператора. Вони різняться своїм metadata.name і server_instances, а всі інші поля навмисно однакові, щоб один рядок і був усією різницею.
  • .aggrega-config.yaml — називає реєстр hub, з якого розв’язується каталог стандартної бібліотеки. Цей приклад не створює власних сутностей.

Створення прикладу

Цей приклад можна зібрати командами нижче або доручити збирання вашому ШІ-асистенту.

Запишіть приклад у нову теку, названу за ним:

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/, і збирання додає свої файли, а не очищає те, що залишило попереднє. Видаляйте dist/ між запусками, щоб переглянути вивід одного Release окремо:

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

З ШІ-асистентом

ШІ-асистент, налаштований з інструментами Aggrega, може зробити те саме: вставте йому цей промпт.

Використовуйте лише інструменти Aggrega і не створюйте жодної теки самостійно. Якщо тека робочого простору ще не містить теки `mysql-innodb-cluster`, викличте один раз інструмент `scaffold`, задавши для `example` значення `mysql-innodb-cluster`, без `dir`: він запише приклад у нову теку `mysql-innodb-cluster`. Потім викличте інструмент `build` один раз для кожного файлу Release у такому порядку — `release-single.yaml` і `release-replicated.yaml` — щоразу задаючи для `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 — до server_instances у Release, version — до значення за замовчуванням engine_version сутності Component, secretName — до credentials_secret у Release, а блок 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: контролер, що узгоджує запит на один екземпляр, і контролер, що узгоджує запит на три екземпляри, — це той самий контролер, тож у ньому ніщо не змінюється.

Кількість маршрутизаторів теж не змінюється, і цей компонент не пропонує її як вільне налаштування. Адреса, яку публікує компонент, — це сервіс, на якому відповідають маршрутизатори, тож кількість виставлено на власне значення за замовчуванням власного ресурсу і ніколи нижче. Це межа того, що може запитати 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 не вказує образ. Посилання береться з власного значення за замовчуванням infra.image у Component, тож Release, який нічого не задає, однаково генерує Deployment з однією версією, а не такий, який треба заповнити, перш ніж його можна застосувати. Ціль, яка завантажує образи з власного дзеркала реєстру, задає infra.image у Release і отримує замість цього своє посилання.

Площину керування оголошено в 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

Нічого не записано. Власний ресурс, який ніхто не узгоджує, — це не менший успіх, ніж працюючий: це артефакт, який чисто застосовується, а потім просто лежить, тож збирання відмовляється його створювати й називає ключ, який засвідчив би протилежне.

Обліковий запис root

Обидва Releases тут спрямовують кластер на Secret, який уже існує в цільовому кластері:

db:
infra:
credentials_secret: mysql-root

Для цього Secret нічого не генерується, і жоден пароль не потрапляє у вивід: власний ресурс містить ім’я, а контролер зчитує з нього обліковий запис. Якщо натомість задати infra.credentials як generated, Secret генерується поруч із власним ресурсом з облікових даних, прикріплених до слота root_password компонента, що поміщає пароль у згенерований вивід і є правильним вибором, коли саме вивід підготовлює кластер.

Чого ця реалізація не створює, так це логічної бази даних чи користувача застосунку. Контролер створює обліковий запис root кластера й нічого нижче, тож схеми й облікові записи, потрібні застосунку, створює той, хто має root.

Яку реалізацію обрати

Обирайте core/datastore/mysql і його синтезований Recipe, коли нічого не можна встановлювати заздалегідь: йому не потрібні ні контролер у кластері, ні доступ до репозиторію чартів, тож він збирається без жодних завантажень і створює логічну базу даних і роль входу, яких запитує застосунок. Обирайте core/datastore/mysql-innodb-cluster, коли в цілі вже працює площина керування MySQL Operator або вона встановлюється, як у цьому прикладі, а застосунку потрібен доступ root до кластера за внутрішньокластерною адресою.

Односерверну форму синтезованої реалізації розібрано в ../mysql-standalone/, і тут вона не повторюється.

Де проходить шов

Вибір між одним екземпляром і трьома не торкнувся документа розробника, як і Ops-відображення. Це і є той поділ, який цей приклад має зробити конкретним:

  • розробник каже, що застосунку потрібно від бази даних;
  • Ops каже, з чого складається база даних, — який Recipe її реалізує;
  • оператор каже, наскільки велика саме ця.

Змініть server_instances на будь-яке значення, яке приймає власний ресурс, і aggregate.yaml у цьому каталозі не зміниться.