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

Веб-консоль
MWS CLI
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите Managed PostgreSQL и нажмите кнопку Создать.
(опционально) Измените автоматически сгенерированное имя кластера. Позже это имя (name) и созданный из него идентификатор (ID) нельзя изменить, меняется только отображаемое имя (display name) кластера.
Выберите тип кластера: Standalone или High-Availability.
Выберите нужную версию PostgreSQL.
Выберите тип ВМ для конфигурации узла.
Выберите тип диска: сетевой или локальный.
Укажите размер диска. Его нельзя уменьшить после создания кластера. Для локальных дисков допустимые размеры зависят от выбранного типа ВМ.

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

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

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

Размер диска	Значение IOPS
10–32 ГБ	1 000
33–64 ГБ	2 000
65–96 ГБ	3 000
97–128 ГБ	4 000
129–160 ГБ	5 000
161–192 ГБ	6 000
193–224 ГБ	7 000
225–256 ГБ	8 000
257–288 ГБ	9 000
289 ГБ — максимальный	10 000

(опционально) Добавьте описание для кластера.
Нажмите кнопку Далее.
Задайте сетевые настройки кластера:
1. Выберите сеть для размещения кластера или создайте новую сеть.
2. Выберите подсеть для размещения primary-эндпоинта кластера или создайте новую подсеть.
3. Выберите тип внутреннего IP-адреса для primary-эндпоинта: временный, который выбирается автоматически из диапазона подсети, или зарезервированный. При необходимости зарезервируйте внутренний IP-адрес.
4. Если вы планируете подключаться к кластеру из внешней сети, выберите тип внешнего IP-адреса для primary-эндпоинта: временный, который выбирается автоматически из диапазона подсети, или зарезервированный. При необходимости зарезервируйте внешний IP-адрес.
5. (опционально) Для High-Availability кластера задайте подсеть и IP-адрес для readOnly-эндпоинта кластера так же, как для primary-эндпоинта в предыдущих шагах.
Для High-Availability кластера включите опцию Подключение к узлам, если планируете подключаться к узлам кластера по отдельности, и настройте доступ:
1. Выберите тип внутреннего IP-адреса: временный, который выбирается автоматически из диапазона подсети, или зарезервированный. При необходимости зарезервируйте внутренний IP-адрес.
2. Если вы планируете подключаться к узлам из внешней сети, выберите тип внешнего IP-адреса: временный, который выбирается автоматически из диапазона подсети, или зарезервированный. При необходимости зарезервируйте внешний IP-адрес.
3. Выберите подсеть для размещения эндпоинта каждого узла или создайте новые подсети.
(опционально) Задайте настройки резервного копирования:
1. Укажите, в какой промежуток времени должно запускаться ежедневное автоматическое резервное копирование. Параметр по умолчанию: 0:00–01:00 UTC.
2. Укажите срок хранения резервных копий. Параметр по умолчанию: 7 дней.
3. Укажите день и промежуток времени для запуска сервисного окна. Параметры по умолчанию: воскресенье и 0:00–01:00 UTC.
Укажите настройки PostgreSQL.
Нажмите кнопку Далее.
Проверьте заданные настройки и нажмите кнопку Создать.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Убедитесь, что у вас есть сеть и подсеть, где будет размещен эндпоинт основного узла кластера. Если их нет, создайте сеть и подсеть.
Определите тип ВМ для конфигурации узла.
Если вы назначаете зарезервированные IP-адреса, узнайте их идентификаторы:
bash
```
1
mws vpc external-address get <имя адреса>
```

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

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
        externalAccess:
11
          allowed: <доступ из внешней сети: true — включен, false — выключен>
12
          ref: <(опционально) идентификатор зарезервированного IP-адреса>
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: <количество узлов — 1>
20
    zone: <зона доступности — ru-central1-a или ru-central1-b>
21
  ' \
22
  --postgres-parameters '{"<параметр>": "<значение>", "<параметр>": "<значение>"}'

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
        externalAccess:
11
          allowed: <доступ из внешней сети: true — включен, false — выключен>
12
          ref: <(опционально) идентификатор зарезервированного IP-адреса>
13
    readOnlyAddresses:
14
      - spec:
15
          subnet: projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>
16
        externalAccess:
17
          allowed: <доступ из внешней сети: true — включен, false — выключен>
18
          ref: <(опционально) идентификатор зарезервированного IP-адреса>
19
    directAddresses:
20
      - spec:
21
          subnet: projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>
22
        externalAccess:
23
          allowed: <доступ из внешней сети: true — включен, false — выключен>
24
          ref: <(опционально) идентификатор зарезервированного IP-адреса>
25
      - spec:
26
          subnet: projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>
27
        externalAccess:
28
          allowed: <доступ из внешней сети: true — включен, false — выключен>
29
          ref: <(опционально) идентификатор зарезервированного IP-адреса>
30
      - spec:
31
          subnet: projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>
32
        externalAccess:
33
          allowed: <доступ из внешней сети: true — включен, false — выключен>
34
          ref: <(опционально) идентификатор зарезервированного IP-адреса>
35
      - spec:
36
          subnet: projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>
37
        externalAccess:
38
          allowed: <доступ из внешней сети: true — включен, false — выключен>
39
          ref: <(опционально) идентификатор зарезервированного IP-адреса>
40
  ' \
41
  --instance-template-vm-type <тип ВМ — например, vmTypes/gen-2-8> \
42
  --instance-template-disk-type <тип диска — например, сетевой NETWORK_STANDARD_SSD или локальный LOCAL> \
43
  --instance-template-disk-size <размер диска в гигабайтах — например, 20GB> \
44
  --instance-template-disk-iops <количество IOPS — например, 1000> \
45
  --instances '
46
    count: <количество узлов — 4>
47
  ' \
48
  --postgres-parameters '{"<параметр>": "<значение>", "<параметр>": "<значение>"}'

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

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

Без указания опционального параметра ref эндпоинту будет назначен временный внутренний IP-адрес из диапазона подсети или внешний IP-адрес из пула провайдера.

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

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

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

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

Размер диска	Значение IOPS
10–32 ГБ	1 000
33–64 ГБ	2 000
65–96 ГБ	3 000
97–128 ГБ	4 000
129–160 ГБ	5 000
161–192 ГБ	6 000
193–224 ГБ	7 000
225–256 ГБ	8 000
257–288 ГБ	9 000
289 ГБ — максимальный	10 000

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.
Убедитесь, что у вас есть сеть и подсеть, где будет размещен эндпоинт основного узла кластера. Если их нет, создайте сеть и подсеть.
Определите тип ВМ для конфигурации узла.
Получите список типов дисков, чтобы определить тип и размер хранилища для кластера:
bash
```
1
curl -X GET https://compute.mwsapis.ru/compute/v1/diskTypes \
2
  -H "Authorization: Bearer <IAM-токен>"
```

Если вы назначаете зарезервированные IP-адреса, узнайте их идентификаторы:

1
curl -X GET https://vpc.mwsapis.ru/vpc/v1/projects/<имя проекта>/networks/<имя сети>/addresses \
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
            "externalAccess": {
18
              "allowed": <доступ из внешней сети: true — включен, false — выключен>,
19
              "ref": "<(опционально) идентификатор зарезервированного IP-адреса>"
20
            }
21
          }
22
        ],
23
        "readOnlyAddresses": []
24
      }
25
    ],
26
    "instanceTemplate": {
27
      "vmType": "<тип ВМ — например, vmTypes/gen-2-8>",
28
      "disk": {
29
        "size": "<размер диска в гигабайтах — например, 20GB>",
30
        "type": "<тип диска — например, сетевой NETWORK_STANDARD_SSD или локальный LOCAL>",
31
        "iops": <количество IOPS — например, 1000>
32
      }
33
    },
34
    "instances": [
35
      {
36
        "count": <количество узлов — 1>,
37
        "zone": "<зона доступности — ru-central1-a или ru-central1-b>"
38
      }
39
    ],
40
    "postgresParameters": {
41
        "<параметр>": "<значение>",
42
        "<параметр>": "<значение>"
43
    }
44
  }
45
}

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
            "externalAccess": {
18
              "allowed": <доступ из внешней сети: true — включен, false — выключен>,
19
              "ref": "<(опционально) идентификатор зарезервированного IP-адреса>"
20
            }
21
          }
22
        ],
23
        "readOnlyAddresses": [
24
          {
25
            "spec": {
26
              "subnet": "projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>"
27
            },
28
            "externalAccess": {
29
              "allowed": <доступ из внешней сети: true — включен, false — выключен>,
30
              "ref": "<(опционально) идентификатор зарезервированного IP-адреса>"
31
            }
32
          }
33
        ],
34
        "directAddresses": [
35
          {
36
            "spec": {
37
              "subnet": "projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>"
38
            },
39
            "externalAccess": {
40
              "allowed": <доступ из внешней сети: true — включен, false — выключен>,
41
              "ref": "<(опционально) идентификатор зарезервированного IP-адреса>"
42
            }
43
          },
44
          {
45
            "spec": {
46
              "subnet": "projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>"
47
            },
48
            "externalAccess": {
49
              "allowed": <доступ из внешней сети: true — включен, false — выключен>,
50
              "ref": "<(опционально) идентификатор зарезервированного IP-адреса>"
51
            }
52
          },
53
          {
54
            "spec": {
55
              "subnet": "projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>"
56
            },
57
            "externalAccess": {
58
              "allowed": <доступ из внешней сети: true — включен, false — выключен>,
59
              "ref": "<(опционально) идентификатор зарезервированного IP-адреса>"
60
            }
61
          },
62
          {
63
            "spec": {
64
              "subnet": "projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>"
65
            },
66
            "externalAccess": {
67
              "allowed": <доступ из внешней сети: true — включен, false — выключен>,
68
              "ref": "<(опционально) идентификатор зарезервированного IP-адреса>"
69
            }
70
          }
71
        ]
72
      }
73
    ],
74
    "instanceTemplate": {
75
      "vmType": "<тип ВМ — например, vmTypes/gen-2-8>",
76
      "disk": {
77
        "size": "<размер диска — например, 20GB>",
78
        "type": "<тип диска: NETWORK_STANDARD_SSD или LOCAL>",
79
        "iops": <количество операций ввода-вывода в секунду — например, 1000>
80
      }
81
    },
82
    "instances": [
83
      {
84
        "count": <количество узлов в кластере — например, 4>
85
      }
86
    ],
87
    "postgresParameters": {
88
        "<параметр>": "<значение>",
89
        "<параметр>": "<значение>"
90
    }
91
  }
92
}

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

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

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

Размер диска	Значение IOPS
10–32 ГБ	1 000
33–64 ГБ	2 000
65–96 ГБ	3 000
97–128 ГБ	4 000
129–160 ГБ	5 000
161–192 ГБ	6 000
193–224 ГБ	7 000
225–256 ГБ	8 000
257–288 ГБ	9 000
289 ГБ — максимальный	10 000

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

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-токен>"