Один 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 во время сборки записывает lock-файл, которого нет в свежем клоне. Каждая сборка пишет в 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 в этом каталоге не изменится.