# MongoDB

## Разворачивание СУБД
Для развертывания СУБД MongoDB вам потребуется выполнить следующие шаги:

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

   Стабильная работа возможна на тарифах не ниже "Начальный".
```

### 2. На этапе "Загрузка данных" выбрать "Через Git"
![db_create](../img/db_create.png)

### 3. На этапе "Конфигурация" выбрать "db" и "mongodb" и нажать "Завершить"
![db_create](../img/mongo.png)

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

   Стабильная работа с MongoDB проверена только с версиями 5.0 и 6.0
```

При развертывании используется образ Docker `mongo:${meta.toolchain.version}`. Параметр `meta.toolchain.version` необязательный. Если его не указать, будет использоваться последний образ `mongo:latest`.

Так как значение параметра `meta.toolchain.version` является тегом образа mongo, можно в качестве его значения использовать произвольный тег из [докер хаба](https://hub.docker.com/_/mongo/tags).

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

В разделе "Переменные" у проекта необходимо задать следующие [переменные окружения](../applications/configuration/variables.md):
* Для добавления имени пользователя необходимо нажать на кнопку "Создать переменную". В поле "Название" указать `MONGO_INITDB_ROOT_USERNAME`, а в поле значение вписать желаемое имя пользователя.
* Для добавления пароля и безопасного его хранения требуется нажать на кнопку "Создать секрет". В поле "Название" указать `MONGO_INITDB_ROOT_PASSWORD`, а в поле значение вписать желаемый пароль.
```{eval-rst}
.. admonition:: Важно
   :class: warning

   Придумать достаточно сложный пароль для базы данных, чтобы злоумышленники не смогли получить к ней доступ.
```
При необходимости, можно задать и другие поддерживаемые образом параметры. Более подробно об этих параметрах можно узнать на [странице образа](https://hub.docker.com/_/mongo).

### 5. На странице "Конфигурация" приложения нажать кнопку "Собрать"
Если конфигурация оказалась пустой, необходимо снова выбрать "db" и "mongodb" и нажать "применить", после чего "собрать".

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

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

`amvera-<имя-пользователя>-run-<транслитерированное-имя-проекта>`

## Развертывание mongo-express

Порядок действий совпадает с развертыванием самой СУБД:

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

   Для работы mongo-express требуется контейнер с тарифом не ниже "Начальный".
```

### 2. На этапе "Загрузка данных" выбрать "Через Git"
![db_create](../img/db_create.png)

### 3. На этапе "Конфигурация" выбрать "db" и "mongo-express" и нажать "Завершить"

При развертывании используется [Docker образ](https://hub.docker.com/_/mongo-express) `mongo-express:${meta.toolchain.version}`. 
Для подключения к MongoDB 5 или 6 версии используйте версии 1 или latest.

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

В разделе "Переменные" у проекта необходимо задать следующие [переменные окружения](../applications/configuration/variables.md):
* Переменная `ME_CONFIG_BASICAUTH_USERNAME` - имя пользователя администратора mongo-express
* Секрет `ME_CONFIG_BASICAUTH_PASSWORD` - пароль для доступа к mongo-express (не имеет ничего общего с паролем от БД)
* `ME_CONFIG_MONGODB_AUTH_USERNAME` - имя пользователя mongodb (то, что указывалось в переменной `MONGO_INITDB_ROOT_USERNAME`)
*  Секрет `ME_CONFIG_MONGODB_AUTH_PASSWORD` - пароль для доступа к mongodb (то, что указывалось в секрете `MONGO_INITDB_ROOT_PASSWORD`)
* Переменная `ME_CONFIG_MONGODB_SERVER` - внутреннее доменное имя проекта с mongodb

### 5. На странице "Конфигурация" приложения нажать кнопку "Собрать"
Если конфигурация оказалась пустой, необходимо снова выбрать "db" и "mongo-express" и нажать "применить", после чего "собрать".

### 6. В разделе "Настройки" приложения активируем [бесплатное доменное имя](../applications/configuration/network.md#бесплатное-доменное-имя-амвера) или [добавляем свое](../applications/configuration/network.md#свое-доменное-имя). 
![db_create](../img/pgadmin_domain.png)

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

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

## Видеопример как использовать MongoDB и Mongo Express в Amvera Cloud

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

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

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

Как развернуть приложение в Amvera Cloud: https://docs.amvera.ru/applications/quick-start.html
Примеры деплоя в Amvera Cloud: https://docs.amvera.ru/general/examples.html

Таймкоды:

- 00:00 Интро
- 00:33 Развертывание MongoDB
- 01:17 Развертывание Mongo Express
- 03:03 Подключение к БД из другого проекта
- 05:15 Проверка работоспособности