Создание инстанса MariaDB и первое подключение
ВВЕДЕНИЕ
MariaDB — реляционная СУБД, совместимая с экосистемой MySQL: классическая клиент-серверная база для веб-приложений, бэкендов и всего, что хранит структурированные данные и коммуницирует по протоколу MySQL.
В DevSpace MariaDB — управляемый сервис. Вы заполняете одну форму, а платформа разворачивает готовую к работе базу: при двух и более репликах — связку primary/secondary с репликацией, где primary принимает запись, а реплики хранят её копию. Пользователи и базы данных описываются прямо в конфигурации сервиса и создаются автоматически.
Чем это отличается от привычной установки на VM:
-
не нужно ставить пакеты, править my.cnf и настраивать репликацию руками — связка создаётся готовой
-
пользователи и базы задаются декларативно в форме, а не через CREATE USER / GRANT в консоли
-
пароль root генерируется платформой и хранится в секрете
-
данные лежат на отдельных постоянных дисках и переживают перезапуск сервера
ПЕРЕД НАЧАЛОМ
Понадобятся:
-
доступ к пространству DevSpace и право создавать в нём сервисы
-
клиент mysql или mariadb (либо любой MySQL-совместимый драйвер) для проверки подключения
Заранее решите, сколько реплик нужно: одна — проще и дешевле, но без отказоустойчивости. Две и больше — репликация и возможность переключения при сбое.
ПОШАГОВОЕ РУКОВОДСТВО
Шаг 1. Откройте Marketplace и выберите MariaDB
Войдите в дашборд DevSpace и откройте раздел Marketplace. Найдите карточку MariaDB (категория PaaS, подпись «Managed MariaDB service») и откройте её. У формы две вкладки: Form (поля) и YAML (та же конфигурация текстом). Под полем имени показан tenant-id вашего пространства.

Шаг 2. Заполните основные поля
Для примера в этой статье используются значения:
|
Поле
|
Значение
|
Зачем
|
|
Name
|
smtest
|
Имя инстанса: строчные латинские буквы, цифры, дефисы. Станет частью имён сервисов и секрета (mariadb-<name>-…).
|
|
replicas
|
2
|
Primary и одна реплика — минимум для переключения при сбое. 1 — одиночный сервер без репликации.
|
|
resourcesPreset
|
t1.small
| |
|
size
|
10Gi
|
Постоянный диск каждой реплики.
|
|
storageClass
|
local
|
Класс хранилища. Выбор зависит от того, сколько экземпляров у сервиса и реплицирует ли он данные сам — подробнее в разделе «Параметры». После создания изменить нельзя.
|
|
external
|
включено
|
Опубликовать базу наружу через LoadBalancer. Если клиенты живут в том же пространстве — оставьте выключенным.
|
|
version
|
v11.8
|
Ветка MariaDB (major.minor).
|
Дальше в статье <name> — это имя, которое вы задали в поле Name: платформа подставляет его в имена сервисов, секретов и компонентов инстанса.
Подсказка: поля cpu и memory в группе resources позволяют задать ресурсы точнее пресета — заполняйте их, только когда типовых пресетов не хватает: явные значения имеют приоритет. Память указывайте с единицами измерения: 512Mi, 2Gi.
|
Шаг 3. Опишите пользователя и базу данных
В группе users добавьте пользователя — это и есть декларативная замена CREATE USER:
-
имя записи — user01
-
password— пароль пользователя. Поле обязательное: придумайте и сохраните пароль, платформа его не генерируйте
-
maxUserConnections— ограничение числа одновременных подключений, например 3. Поле тоже обязательное
В группе databases добавьте базу:
-
имя записи — db01
-
в roles.admin укажите user01 — пользователь получит полные права на эту базу
-
в roles.readonly можно перечислить пользователей только для чтения
Шаг 4. Запустите развёртывание
Нажмите Deploy. Откроется карточка созданного инстанса — дождитесь статуса Ready в шапке.

Шаг 5. Убедитесь, что все компоненты запущены
Статус Ready означает, что платформа применила конфигурацию сервиса, но сами компоненты после этого ещё могут запускаться. Поэтому, прежде чем подключаться, проверьте фактическое состояние развёртывания на вкладке Workloads карточки — по смыслу это аналог systemctl status на сервере: видно, что реально запущено и готово к работе.
В разделе Pods этой вкладки — по строке на каждый запущенный экземпляр компонента, справа в строке — статус и счётчик готовности в формате «готово/всего». Состав строк зависит от конфигурации. Для примера из этой статьи их три:
-
mariadb-<name>-0и mariadb-<name>-1 — серверы MariaDB, по одному на реплику
-
mariadb-<name>-metrics-…— служебный экспортёр метрик
Сервис готов к работе, когда в каждой строке статус Running, а числа в счётчике совпадают: 1/1, 2/2, 3/3. Значение «всего» у разных компонентов своё — важно только, чтобы числа были равны.
Строки со статусом Succeeded и счётчиком 0/1 — это нормально: разовая задача автоматики отработала и завершилась.

Если строка со статусом Running показывает 0/1, 1/2, 1/3, развёртывание ещё не завершилось — даже если в шапке уже Ready. Сразу после создания это нормально: компонентам нужно время на запуск. Если картина долго не меняется, откройте вкладку Events: там отображаются события запуска компонентов, по ним обычно видно, на чём запуск остановился. Если причина непонятна, обратитесь в поддержку и укажите имя инстанса. Возвращайтесь к вкладке Workloads и после изменений конфигурации: если изменение перезапускает компоненты, часть строк какое-то время будет не готова.
|
Шаг 6. Получите адрес подключения
На вкладке Services карточки инстанса:
-
mariadb-<name>— базовый адрес сервиса (есть всегда)
-
mariadb-<name>-primary— primary, принимает запись (появляется при replicas > 1)
-
mariadb-<name>-secondary— реплики для чтения
При включённом external внешний IP выдаётся сервису mariadb-<name>-primary (а при одной реплике — mariadb-<name>) и виден в колонке External IP. Порт — стандартный 3306.
Шаг 7. Получите пароль root
Пароль пользователя user01 вы задали сами на шаге 3. Пароль суперпользователя root платформа сгенерировала автоматически:
-
Откройте вкладку Secrets карточки инстанса.
-
Выберите секрет mariadb-<name>-credentials.
-
Раскройте значение кнопкой с иконкой глаза и скопируйте его.
Рекомендуем пользоваться root только для административных задач, а приложения подключать под их собственными пользователями. Пароли удобнее передавать через хранилище секретов, а не хранить в коде.

ПАРАМЕТРЫ
|
Параметр
|
Что делает
|
Значение по умолчанию
|
Когда менять
|
|
replicas
|
Число серверов MariaDB. При 2 и больше включается репликация: один primary и реплики.
|
2
|
1 — для сред без требований к доступности. Больше — для чтения с реплик и устойчивости к отказу.
|
|
resourcesPreset
|
t1.nano
|
Подбирайте по нагрузке. Базе обычно нужнее память под кеш страниц.
| |
|
resources.cpu
|
Явный CPU вместо пресета.
|
не задан
|
Когда типовых пресетов не хватает. Явные значения имеют приоритет над resourcesPreset.
|
|
resources.memory
|
Явная память вместо пресета.
|
не задана
|
То же. Память указывайте с единицами измерения: 512Mi, 2Gi.
|
|
size
|
Размер постоянного диска каждой реплики.
|
10Gi
|
Под объём данных с запасом. Том можно расширить позже, уменьшить — нельзя.
|
|
storageClass
|
Класс постоянного хранилища.
|
local — копии тома только на одном сервере
|
При одном экземпляре — replicated, при двух и больше обычно local, потому что ввод-вывод у replicated медленнее. Параметр неизменяемый — смена потребует нового инстанса и переноса данных. Разбор — в подсказке в конце раздела.
|
|
external
|
Публикует базу наружу: LoadBalancer с внешним IP на порту 3306.
|
false
|
Включайте, только если клиенты работают вне пространства через публичные сети.
|
|
version
|
Ветка MariaDB: v11.8, v11.4, v10.11, v10.6.
|
v11.8
|
Выбирайте ветку, с которой совместимо приложение. Смена версии — это обновление сервера.
|
|
users
|
Карта пользователей: для каждого — password и maxUserConnections.
|
{}
|
Заводите отдельного пользователя на приложение. Изменения применяются декларативно.
|
|
databases
|
Карта баз: для каждой — роли roles.admin и roles.readonly со списками пользователей.
|
{}
|
Правьте для выдачи и отзыва прав — вместо ручных GRANT.
|
Как выбрать класс хранилища. replicated держит копии тома на нескольких серверах платформы и переживает потерю сервера, но пишет синхронно в несколько мест, поэтому ввод-вывод у него всегда медленнее, чем у local. Критерий выбора — сколько экземпляров у сервиса и реплицирует ли он данные сам между репликами:
-
один экземпляр — берите replicated: другой копии данных нет, и потеря сервера означает потерю тома
-
два и больше — подходит local: копия данных уже есть на других экземплярах, а replicated под таким сервисом только замедлит запись, дублируя то, что и так продублировано
При replicas: 2 и больше MariaDB сама переносит данные с primary на реплики, поэтому обычный выбор — local. Для одиночного сервера берите replicated.
ПРИМЕР КОНФИГУРАЦИИ
Итоговый ресурс, соответствующий шагам выше. Вкладка YAML формы показывает и принимает ту же конфигурацию.
apiVersion: apps.cozystack.io/v1alpha1
kind: MariaDB
metadata:
name: smtest
spec:
# Primary и одна реплика: репликация включается автоматически.
replicas: 2
# Типовой пресет CPU/памяти каждой реплики.
resourcesPreset: t1.small
# Постоянный диск каждой реплики.
size: 10Gi
# Неизменяемый параметр: выбирайте отказоустойчивый класс сразу.
storageClass: replicated
# Внешний LoadBalancer на порту 3306 (для primary).
external: true
# Ветка MariaDB.
version: v11.8
# Пользователь приложения; пароль задаётся здесь.
users:
user01:
password: "<пароль>"
maxUserConnections: 3
# База и права: user01 — администратор базы db01.
databases:
db01:
roles:
admin:
- user01
|
Производные ресурсы получают префикс mariadb-: секрет mariadb-<name>-credentials, сервисы mariadb-<name>, mariadb-<name>-primary, mariadb-<name>-secondary.
|
ПРОВЕРКА
Подключитесь к выданному адресу под пользователем из конфигурации:
mysql -h <внешний-IP> -P 3306 -u user01 -p db01
|
После ввода пароля выполните:
SELECT VERSION();
SHOW DATABASES;
|
В выводе должна быть версия MariaDB выбранной ветки и база db01.
Типовые ошибки подключения: Access denied — неверные пользователь или пароль (сверьте шаг 3 и секрет mariadb-<name>-credentials для root). Таймаут — внешний IP ещё не выдан или нет маршрута до него.
ЧТО ДАЛЬШЕ
-
Подключение из приложения — передайте драйверу адрес, порт, пользователя и базу. Например, на Python:import pymysqlconn = pymysql.connect(host="<адрес>", port=3306,user="user01", password="<пароль>", database="db01")with conn.cursor() as cur:cur.execute("SELECT VERSION()")print(cur.fetchone())Внутри пространства приложения читающей нагрузки могут ходить на mariadb-<name>-secondary, снимая чтение с primary.
-
Пользователи и права — добавляйте записи в users и databases той же формой. Платформа применит изменения без ручных GRANT
-
Масштабирование — replicas и пресет ресурсов меняются в той же форме. Диск можно только увеличивать, storageClass неизменяем
-
Обновление версии — смена version обновляет сервер. Перед обновлением проверьте совместимость приложения и сделайте резервную копию
-
Удаление — удаление инстанса удаляет и его диски с данными. Выгрузите нужные данные заранее
