# MySQL (beta)

Облако Amvera поддерживает создание управляемого кластера MySQL с одной или несколькими запущенными репликами.
Создание кластера происходит в несколько простых шагов:

## Разворачивание кластера

1. На главной странице нажать на кнопку "Создать".
2. Ввести название проекта и выбрать "MySQL".

      ```{eval-rst}
      .. admonition:: Внимание
         :class: attention
      
         Работа возможна на тарифе не ниже "Начальный".
         Если Вам требуется создание бэкапов, то необходимо повысить тариф до "Начальный Плюс"
      ```

3. Задать параметры СУБД MySQL
   - `Версия СУБД` - версия СУБД, которая будет создана в кластере.
   - `Пароль root пользователя` - пароль для указанного выше пользователя, под которым будет реализовываться вход в СУБД.
      ```{eval-rst}
      .. admonition:: Важно
         :class: warning

         Это пароль для пользователя `root`, который будеть иметь доступ ко всем БД и права на любые действия.
         Пароль необходимо запомнить, его будет невозможно восстановить или изменить.
      ```
   - `Размер кластера СУБД` - количество реплик СУБД. При этом одна из реплик будет мастером и в связи с особенностями СУБД доступ на запись будет доступен только через неё.
      ```{eval-rst}
      .. admonition:: Важно
         :class: warning
    
         Тарификация происходит отдельно за каждую реплику согласно выбранному тарифу
      ```
4. Нажать кнопку "Завершить" и дождаться перехода кластера в статус "Приложение запущено".

## Добавление БД
После создания кластера по дефолту будет создана БД "mysql", которая доступна для полноценной работы.

Если Вам необходимо добавить другую базу данных, перейдите на вкладку "Конфигурация", нажмите кнопку "Добавить базу данных" и введите ее имя.

```{eval-rst}
.. admonition:: Важно
   :class: warning

   Добавить базу данных возможно только после полного запуска кластера (статус "Приложение запущено")

   Имя БД может состоять только из [A-Z], [a-z], [0-9], "_" и "-"
```

![db_create](../img/mysql_db_create.png)

## Добавление пользователя БД

Чтобы добавить пользователя, перейдите в раздел нужной базы данных на вкладке "Кофигурация"  и нажмите кнопку "Добавить пользователя".

```{eval-rst}
.. admonition:: Важно
   :class: warning

   Добавить пользователя можно только после создания базы данных, когда кнопка "Добавить пользователя" будет активна.

   Пароль пользователя необходимо запомнить, он не подлежит восстановлению или изменению.

   Имя пользователя может состоять только из [A-Z], [a-z], [0-9], "_" и "-"
```

![user_create](../img/mysql_user_create.png)

## Бэкапы

### Бэкапы по расписанию
Сервис предоставляет возможность создания бесплатных бэкапов по расписанию.
Бэкапы начнут создаваться со следующего дня в час их активации. Сервис хранит крайние <ins>**три**</ins> бэкапа.

### Бэкапы по клику
Для создания бэкапа нажмите на кнопку "Создать бэкап" и введите его описание, чтобы отличить его от других. 
Имя бэкапа будет сгенерировано автоматически.

Максимально вы можете создать <ins>**три**</ins> бэкапа, они также являются бесплатными.

![backups](../img/mysql_backups.png)

## Восстановление кластера

```{eval-rst}
.. admonition:: Внимание
   :class: attention

   Восстановление кластера повлечет за собой потерю несохраненных данных. Убедитесь, что у вы создали бэкап требуемого состояния перед восстановлением из другого бэкапа.
```

Восстановить кластер можно по клику на иконку необходимого бэкапа.

Во время восстановления Ваш кластер остановится и запустится автоматически, в течении этого времени он будет недоступен.

![restore](../img/mysql_restore.png)

## Подключение к кластеру
```{eval-rst}
.. admonition:: Внимание
   :class: attention

   Подключение к базе данных возможно только из других проектов, созданных в Amvera.
```
Для доступа к базе данных из других проектов Амвера необходимо указать доменное имя, которое находится на вкладке "Инфо".

![internal_domain](../img/mysql_internal_domain.png)

## Развертывание phpMyAdmin

### 1. Создать приложение с подходящим тарифом.
```{eval-rst}
.. admonition:: Внимание
   :class: attention

   Для работы phpMyAdmin требуется выбрать тариф "Начальный".
```

![phpmyadmin_create](../img/phpmyadmin_create.png)

### 2. Указать необходимые переменные окружения.

В разделе "Переменные" у проекта необходимо задать следующие [переменные окружения](../applications/configuration/variables.md):
* Переменная `PMA_ABSOLUTE_URI` - ссылка на приложение (в формате  `https://<транслитерированное-имя-проекта>-<имя-пользователя>.amvera.io`)
* Переменная `PMA_ARBITRARY`, установленная в 1

![phpmyadmin_variables](../img/phpmyadmin_variables.png)

### 3. Активировать в настройках [бесплатное доменное имя](../applications/configuration/network.md#бесплатное-доменное-имя-амвера) или [добавляем свое](../applications/configuration/network.md#свое-доменное-имя). 
![db_create](../img/pgadmin_domain.png)

```{eval-rst}
.. admonition:: Хитрость
   :class: hint

   Чтобы экономить на потреблении проекта с phpMyAdmin рекомендуем ставить его на паузу после окончания работы.
```

### 4. Подключиться к кластеру MySQL

![phpmyadmin_connect](../img/phpmyadmin_connect.png)

* введите внутренне [доменное имя](#подключение-к-кластеру)
* имя пользователя (по дефолту создается пользователь `root`)
* пароль пользователя (для `root` пользователя Вы устанавливали пароль при создании кластера)

```{eval-rst}
.. admonition:: Важно
   :class: warning

   Доступ ко всем базам данных имеет только пользователь `root`.

   Вы можете зайти под иным созданным пользователем, тогда будет открыт доступ только к той бд, в которой он был создан.
```

![phpmyadmin_success](../img/phpmyadmin_success.png)

## Видеопример как использовать MySQL и phpMyAdmin в Amvera Cloud

```{eval-rst}
..  youtube:: ofkja-vNxuo
   :align: center
   :width: 100%
```

В этом видео мы рассмотрим, как использовать базу данных MySQL в Amvera Cloud:

- Как развернуть базу данных MySQL
- Как подключаться к базе данных MySQL из других приложений
- Как использовать phpMyAdmin для управления базами данных MySQL

Таймкоды:

- 00:00  Интро
- 00:34  Развертывание MySQL
- 01:28  Развертывание phpMyAdmin
- 02:47  Подключение к БД из другого проекта
- 05:04  Проверка работоспособности