Быстрый старт сервиса Managed DocumentDB

Перед началом работы

1. Зарегистрируйтесь в личном кабинете Cloud.ru.

   Если вы уже зарегистрированы, войдите под своей учетной записью.

2. Сгенерируйте SSH-ключ и загрузите его в облачный каталог.

3. Создайте виртуальную машину с ОС Ubuntu 24.04 в том же проекте, зоне доступности и подсети, где будет располагаться кластер Managed DocumentDB.

4. Назначьте виртуальной машине публичный IP-адрес.

5. Убедитесь, что вы можете подключиться к виртуальной машине по SSH.

Создайте кластер

1. На верхней панели слева нажмите и выберите Базы данных → Managed DocumentDB.

2. На главной странице сервиса нажмите Создать кластер.

3. Введите название кластера.

   Требования к названию

4. Выберите версию DocumentDB.

   После создания кластера версию продукта изменить нельзя.

5. Нажмите Продолжить.

6. На шаге Конфигурация:

   1. В блоке Конфигурация тип кластера Single-node.

   2. Выберите зону доступности.

   3. В блоке Вычислительный ресурс выберите флейвор с 4 vCPU и 16 ГБ RAM.

   4. В блоке Диск выберите из списка тип диска SSD и укажите размер диска 40 ГБ.

7. Нажмите Продолжить.

8. На шаге Сетевые настройки из списка Подсеть выберите адрес подсети, где расположена виртуальная машина, с которой вы будете подключаться к базе данных.

9. Нажмите Создать.

Кластер готов к работе, когда его статус изменится на «Доступен».

Подключитесь к базе данных

Для подключения вам понадобятся следующие данные кластера:

• внутренний IP;

• порт;

• логин;

• пароль.

Их можно найти на странице информации кластера в блоке Данные для подключения.

1. Подключитесь по SSH к виртуальной машине, созданной ранее в том же проекте, что и кластер DocumentDB.

2. На виртуальной машине установите соответствующую версию утилиты MongoDB Shell.

3. Чтобы подключиться к базе данных, введите команду:

   mongosh --host <private_IP> --port <port> --username <login> --password <password>
   
   

   Где:

   • <private_IP>, <port> — внутренний IP и порт.

   • <login>, <password> — имя и пароль пользователя.

   Скопируйте их на странице информации о кластере в блоке Данные для подключения.

   После подключения в качестве текущей используется база данных по умолчанию test.

4. Чтобы увидеть доступные базы данных, введите команду show dbs .

В терминале отобразится список баз данных, размещенных в кластере DocumentDB. Обратите внимание, что среди них нет базы test, так как она еще не содержит данные. База данных test будет создана после выполнения на ней первой операции.

Добавьте запись

Для примера добавим запись в базу данных по умолчанию test.

1. (Опционально) Переключитесь на базу данных test с помощью команды use test .

2. Добавьте запись в базу данных:

   db.User.insertOne({name: "John", age: 25})
   
   

   После добавления первой записи база данных будет создана.

3. Чтобы увидеть доступные базы данных, введите команду show dbs .

   База данных test отобразится в списке баз данных.

Что дальше

Далее для созданного кластера вы можете:

• настроить политику резервного копирования;

• создать резервную копию вручную;

• изучить метрики мониторинга.

Если вы закончили работу с примером, удалите кластер.