Создание кластера

В веб-консоли выберите нужный проект.

В списке сервисов выберите Managed PostgreSQL и нажмите кнопку Создать.

(опционально) Измените автоматически сгенерированное имя кластера. Позже это имя (name) и созданный из него идентификатор (ID) нельзя изменить, меняется только отображаемое имя (display name) кластера.

Выберите тип кластера: Standalone или High-Availability.

Если вы создаете standalone-кластер, укажите зону доступности, где он будет размещен.

Выберите нужную версию PostgreSQL.

Выберите тип ВМ для конфигурации узла.

Выберите тип диска: сетевой или локальный.

Укажите размер диска. Его нельзя уменьшить после создания кластера. Для локальных дисков допустимые размеры зависят от выбранного типа ВМ.

(опционально) Укажите максимальное количество IOPS (операций ввода-вывода в секунду). Для IOPS действуют следующие ограничения:

• Для ВМ с 2 vCPU значение должно быть от 1 000 до 4 000.
• Для ВМ с 4 vCPU и более значение должно быть от 1 000 до 10 000.
• Значение должно быть кратно 100.

Если значение IOPS не задано, применится значение по умолчанию в зависимости от размера диска с учетом ограничения для ВМ с 2 vCPU.

(опционально) Добавьте описание для кластера.

Нажмите кнопку Далее.

Задайте сетевые настройки кластера:

1. Выберите сеть для размещения кластера или создайте новую сеть.

2. Выберите подсеть для размещения primary-эндпоинта кластера или создайте новую подсеть.

3. Выберите тип внутреннего IP-адреса для primary-эндпоинта: временный, который выбирается автоматически из диапазона подсети, или зарезервированный. Если IP-адрес еще не зарезервирован, зарезервируйте его.

4. Если вы планируете подключаться к кластеру из внешней сети, выберите тип внешнего IP-адреса для primary-эндпоинта: временный, который выбирается автоматически из диапазона подсети, или зарезервированный. Если IP-адрес еще не зарезервирован, зарезервируйте его.

5. (опционально) Если вы создаете high-availability-кластер, задайте подсеть и IP-адрес для readOnly-эндпоинта кластера так же, как для primary-эндпоинта в предыдущих шагах. Можно добавить до 3 readOnly-эндпоинтов.

(опционально) Укажите, в какой промежуток времени должно запускаться ежедневное автоматическое резервное копирование. Параметр по умолчанию: 0:00–01:00 UTC.

(опционально) Укажите срок хранения резервных копий. По истечении этого срока резервная копия удалится. Параметр по умолчанию: 7 дней.

(опционально) Укажите день и промежуток времени для запуска сервисного окна. Параметры по умолчанию: воскресенье и 0:00–01:00 UTC.

Нажмите кнопку Далее.

Проверьте заданные настройки и нажмите кнопку Создать.

Убедитесь, что у вас есть сеть и подсеть, где будет размещен основной узел кластера. Если их нет, создайте сеть и подсеть.

Определите тип ВМ для конфигурации узла.

В зависимости от типа кластера выполните команду:

1
mws mpostgres cluster create <имя кластера> \
2
  --version <версия PostgreSQL> \
3
  --active=<состояние кластера: true — запущен, false — остановлен> \
4
  --endpoints '
5
    name: <имя эндпоинта>
6
    network: projects/<имя проекта>/networks/<имя сети>
7
    primaryAddresses:
8
      - spec:
9
          subnet: projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>
10
  ' \
11
  --instance-template-vm-type <тип ВМ — например, vmTypes/gen-2-8> \
12
  --instance-template-disk-type <тип диска — например, сетевой NETWORK_STANDARD_SSD или локальный LOCAL> \
13
  --instance-template-disk-size <размер диска в гигабайтах — например, 20GB> \
14
  --instance-template-disk-iops <количество IOPS — например, 1000> \
15
  --instances '
16
    count: <количество узлов — 1>
17
    zone: <зона доступности — ru-central1-a или ru-central1-b>
18
  '

1
mws mpostgres cluster create <имя кластера> \
2
  --version <версия PostgreSQL> \
3
  --active=<состояние кластера: true — запущен, false — остановлен> \
4
  --endpoints '
5
    name: <имя эндпоинта>
6
    network: projects/<имя проекта>/networks/<имя сети>
7
    primaryAddresses:
8
      - spec:
9
          subnet: projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>
10
    readOnlyAddresses:  # Можно добавить до 3 readOnly-эндпоинтов
11
      - spec:
12
          subnet: projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>
13
  ' \
14
  --instance-template-vm-type <тип ВМ — например, vmTypes/gen-2-8> \
15
  --instance-template-disk-type <тип диска — например, сетевой NETWORK_STANDARD_SSD или локальный LOCAL> \
16
  --instance-template-disk-size <размер диска в гигабайтах — например, 20GB> \
17
  --instance-template-disk-iops <количество IOPS — например, 1000> \
18
  --instances '
19
    count: <количество узлов — 4>
20
  '

Обязательные флаги в команде создания кластера:

• --version — поддерживаемая версия PostgreSQL;
• --instance-template-vm-type — тип ВМ;
• --instance-template-disk-type — тип диска;
• --instance-template-disk-size — размер диска в гигабайтах;
• --instances — узлы;
• --endpoints — сеть и хотя бы одна подсеть в нужной зоне.

Для локальных дисков допустимые размеры зависят от выбранного типа ВМ.

Для IOPS действуют следующие ограничения:

• Для ВМ с 2 vCPU значение должно быть от 1 000 до 4 000.
• Для ВМ с 4 vCPU и более значение должно быть от 1 000 до 10 000.
• Значение должно быть кратно 100.

Если значение IOPS не задано, применится значение по умолчанию в зависимости от размера диска с учетом ограничения для ВМ с 2 vCPU.

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

Убедитесь, что у вас есть сеть и подсеть, где будет размещен основной узел кластера. Если их нет, создайте сеть и подсеть.

Определите тип ВМ для конфигурации узла.

Получите список типов дисков, чтобы определить тип и размер хранилища для кластера:

1
curl -X GET https://compute.mwsapis.ru/compute/v1/diskTypes \
2
  -H "Authorization: Bearer <IAM-токен>"

Опишите характеристики кластера в виде JSON-объекта и сохраните его в отдельном файле. Обязательные параметры в спецификации кластера:

• spec.version — поддерживаемая версия PostgreSQL;
• spec.instanceTemplate — ресурс;
• spec.instances — узлы;
• spec.endpoints — сеть и хотя бы одна подсеть в нужной зоне.

1
{
2
  "metadata": {
3
    "displayName": "<отображаемое имя кластера>"
4
  },
5
  "spec": {
6
    "version": "<версия PostgreSQL>",
7
    "active": <состояние кластера: true — запущен, false — остановлен>,
8
    "endpoints": [
9
      {
10
        "name": "<имя эндпоинта>",
11
        "network": "projects/<проект>/networks/<сеть>",
12
        "primaryAddresses": [
13
          {
14
            "spec": {
15
              "subnet": "projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>"
16
            }
17
          }
18
        ],
19
        "readOnlyAddresses": []
20
      }
21
    ],
22
    "instanceTemplate": {
23
      "vmType": "<тип ВМ — например, vmTypes/gen-2-8>",
24
      "disk": {
25
        "size": "<размер диска в гигабайтах — например, 20GB>",
26
        "type": "<тип диска — например, сетевой NETWORK_STANDARD_SSD или локальный LOCAL>",
27
        "iops": <количество IOPS — например, 1000>
28
      }
29
    },
30
    "instances": [
31
      {
32
        "count": <количество узлов — 1>,
33
        "zone": "<зона доступности — ru-central1-a или ru-central1-b>"
34
      }
35
    ]
36
  }
37
}

1
{
2
  "metadata": {
3
    "displayName": "<отображаемое имя кластера>"
4
  },
5
  "spec": {
6
    "version": "<версия PostgreSQL>",
7
    "active": <состояние кластера: true — запущен, false — остановлен>,
8
    "endpoints": [
9
      {
10
        "name": "<имя эндпоинта>",
11
        "network": "projects/<имя проекта>/networks/<имя сети>",
12
        "primaryAddresses": [
13
          {
14
            "spec": {
15
              "subnet": "projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>"
16
            }
17
          }
18
        ],
19
        "readOnlyAddresses": [ # Можно добавить до 3 readOnly-эндпоинтов
20
          {
21
            "spec": {
22
              "subnet": "projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>"
23
            }
24
          }
25
        ]
26
      }
27
    ],
28
    "instanceTemplate": {
29
      "vmType": "<тип ВМ — например, vmTypes/gen-2-8>",
30
      "disk": {
31
        "size": "<размер диска в гигабайтах — например, 20GB>",
32
        "type": "<тип диска — например, сетевой NETWORK_STANDARD_SSD или локальный LOCAL>",
33
        "iops": <количество IOPS — например, 1000>
34
      }
35
    },
36
    "instances": [
37
      {
38
        "count": <количество узлов — 4>
39
      }
40
    ]
41
  }
42
}

Для локальных дисков допустимые размеры зависят от выбранного типа ВМ.

Для IOPS действуют следующие ограничения:

• Для ВМ с 2 vCPU значение должно быть от 1 000 до 4 000.
• Для ВМ с 4 vCPU и более значение должно быть от 1 000 до 10 000.
• Значение должно быть кратно 100.

Если значение IOPS не задано, применится значение по умолчанию в зависимости от размера диска с учетом ограничения для ВМ с 2 vCPU.

Выполните запрос:

1
curl -X POST https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters/<уникальное имя кластера> \
2
  -H "Authorization: Bearer <IAM-токен>" \
3
  -H "Content-Type: application/json" \
4
  -d '@<путь к файлу с JSON-объектом>'

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

Проверьте статус кластера:

1
curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters/<имя кластера> \
2
  -H "Authorization: Bearer <IAM-токен>"