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