# MySQL (beta)

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

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

1. На главной странице нажать на кнопку "Создать".
2. Выбрать тип сервиса "Преднастроенное приложение из маркетплейса".
3. Выбрать параметр сервиса "Базы данных" и сервис "MySQL".
4. Ввести произвольное название проекта и выбрать подходящий тариф.

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

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

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

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

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

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

## Бэкапы

### Бэкапы по расписанию
Сервис предоставляет возможность создания бесплатных бэкапов по расписанию.
Бэкапы начнут создаваться со следующего дня в час их активации. Сервис хранит крайние <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  Проверка работоспособности