Один 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, з якого розв’язується каталог стандартної бібліотеки. Цей приклад не створює власних сутностей.
Створення прикладу
Цей приклад можна зібрати командами нижче або доручити збирання вашому ШІ-асистенту.
Запишіть приклад у нову теку, названу за ним:
aggrega scaffold --example mysql-innodb-clusterПотім вона виводить команди, які слід виконати далі. Перша переходить у нову теку:
cd mysql-innodb-clusterЗбирання
aggrega build --release release-single.yaml --auto-pullaggrega build --release release-replicated.yaml --auto-pull--auto-pull під час збирання записує lockfile, якого бракує свіжому клону. Кожне збирання записує в dist/, і збирання додає свої файли, а не очищає те, що залишило попереднє. Видаляйте dist/ між запусками, щоб переглянути вивід одного Release окремо:
rm -rf dist && aggrega build --release release-replicated.yaml --auto-pullКожен Release генерує п’ять файлів: власний ресурс бази даних і чотири, що розгортають площину керування.
dist/stack/helm/db/innodbcluster.yamldist/stack/helm/mysql-operator/clusterrole.yamldist/stack/helm/mysql-operator/clusterrolebinding.yamldist/stack/helm/mysql-operator/deployment.yamldist/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.yamlapiVersion: mysql.oracle.com/v2kind: InnoDBClustermetadata: [… omitted: the labels and annotations, described below] name: dbspec: 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 вище без змін.
Площина керування
[… 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 у цьому каталозі не зміниться.