×

Создание инстанса 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
Типовой пресет CPU и памяти каждой реплики (справочник пресетов).
 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
Типовой пресет CPU и памяти каждой реплики (справочник пресетов).
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 pymysql
     
    conn = 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 обновляет сервер. Перед обновлением проверьте совместимость приложения и сделайте резервную копию
  • Удаление — удаление инстанса удаляет и его диски с данными. Выгрузите нужные данные заранее