Как начать работать с Managed Service for PostgreSQL

Чтобы начать работу с сервисом:

• Создайте кластер БД.
• Подключитесь к БД.

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

1. Перейдите в консоль управления, затем войдите в Yandex Cloud или зарегистрируйтесь, если вы еще не зарегистрированы.

2. Если у вас еще нет каталога, создайте его:

   1. В консоли управления в списке слева выберите нужное облако.

   2. Справа сверху нажмите кнопку Создать каталог.

   3. Введите имя каталога. Требования к имени:

      • длина — от 2 до 63 символов;
      • может содержать строчные буквы латинского алфавита, цифры и дефисы;
      • первый символ — буква, последний — не дефис.

   4. (Опционально) Введите описание каталога.

   5. Выберите опцию Создать сеть по умолчанию. Будет создана сеть с подсетями в каждой зоне доступности. Также в этой сети будет создана группа безопасности по умолчанию, внутри которой весь сетевой трафик разрешен.

   6. Нажмите кнопку Создать.

3. Назначьте вашему аккаунту в Yandex Cloud роль vpc.user и роль managed-postgresql.editor или выше. Эти роли позволяют создать кластер.

   Примечание

   Если вы не можете управлять ролями, обратитесь к администратору вашего облака или организации.

4. Подключаться к кластерам БД можно как изнутри, так и извне Yandex Cloud:

   • Чтобы подключиться изнутри Yandex Cloud, создайте виртуальную машину в той же облачной сети, что и кластер БД (на основе Linux).

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

   Примечание

   Следующий шаг предполагает, что подключение к кластеру производится с ВМ на основе Linux.

5. Подключитесь к ВМ по SSH.

6. Установите необходимые зависимости и клиент PostgreSQL:

   sudo apt update && sudo apt install -y postgresql-client
   

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

1. В консоли управления выберите каталог, в котором нужно создать кластер БД.
2. Выберите сервис Managed Service for PostgreSQL.
3. Нажмите кнопку Создать кластер.
4. Задайте параметры кластера и нажмите кнопку Создать кластер. Процесс подробно рассмотрен в разделе Создание кластера.
5. Дождитесь, когда кластер будет готов к работе: его статус на панели Managed Service for PostgreSQL сменится на Running, а состояние — на Alive. Это может занять некоторое время.

Подключитесь к БДПодключитесь к БД

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

2. Для подключения к серверу БД получите SSL-сертификат:

   Linux (Bash)/macOS (Zsh)

   Windows (PowerShell)

   mkdir -p ~/.postgresql && \
   wget "https://storage.yandexcloud.net/cloud-certs/CA.pem" \
        --output-document ~/.postgresql/root.crt && \
   chmod 0655 ~/.postgresql/root.crt
   

   Сертификат будет сохранен в файле ~/.postgresql/root.crt.

   mkdir $HOME\.postgresql; curl.exe -o $HOME\.postgresql\root.crt https://storage.yandexcloud.net/cloud-certs/CA.pem
   

   Сертификат будет сохранен в файле $HOME\.postgresql\root.crt.

   Корпоративные политики и антивирус могут блокировать скачивание сертификата. Подробнее см. в разделе Вопросы и ответы.

3. Используйте для подключения команду psql:

   psql "host=c-<идентификатор_кластера>.rw.mdb.yandexcloud.net \
         port=6432 \
         sslmode=verify-full \
         dbname=<имя_БД> \
         user=<имя_пользователя> \
         target_session_attrs=read-write"
   

Что дальшеЧто дальше

• Изучите концепции сервиса.
• Узнайте подробнее о создании кластера и подключении к БД.
• Ознакомьтесь с вопросами и ответами.