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

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

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

(опционально) Укажите максимальное количество 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-адрес.
(опционально) Задайте настройки резервного копирования:
1. Выберите, в какой промежуток времени должно запускаться ежедневное автоматическое резервное копирование. Параметр по умолчанию: 0:00–01:00 UTC.
2. Укажите срок хранения резервных копий. Параметр по умолчанию: 7 дней.
3. В блоке Сервисное окно выберите день и промежуток времени, когда кластер будет проходить техническое обслуживание. Параметры по умолчанию: воскресенье и 0:00–01:00 UTC.
Нажмите кнопку Далее.
Проверьте заданные настройки и нажмите кнопку Создать.

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

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

1
mws mmysql cluster create <имя кластера> \
2
  --display-name <отображаемое имя кластера> \
3
  --description <описание кластера> \
4
  --version <версия MySQL> \
5
  --active=<состояние кластера: true — запущен, false — остановлен> \
6
  --endpoints '
7
    name: "<имя эндпоинта>"
8
    network: vpc/projects/<имя проекта>/networks/<имя сети>
9
    primaryAddresses:
10
    - externalAccess:
11
        allowed: <доступ из внешней сети: true — включен, false — выключен>
12
        ref: vpc/projects/<имя проекта>/externalAddresses/<имя зарезервированного внешнего IP-адреса>
13
      ref: vpc/projects/<имя проекта>/networks/<имя сети>/addresses/<имя зарезервированного внутреннего IP-адреса>
14
      spec:
15
        subnet: projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>
16
  ' \
17
  --instance-template-vm-type <тип ВМ — например, vmTypes/gen-2-8> \
18
  --instance-template-disk-type <тип диска — NETWORK_STANDARD_SSD> \
19
  --instance-template-disk-size <размер диска в гигабайтах — например, 20GB> \
20
  --instance-template-disk-iops <количество IOPS — например, 1000> \
21
  --instances 'count: <количество узлов — 1>, zone: "<зона доступности — ru-central1-a или ru-central1-b>"' \
22
  --maintenance-window-weekly-days "<день для сервисного окна — например, MONDAY>" \
23
  --maintenance-window-weekly-hour <время начала сервисного окна — от 0 до 23> \
24
  --backup-daily-hour <время начала резервного копирования — от 0 до 23> \
25
  --backup-retain-period-days <время хранения резервных копий в днях>

Если не указать идентификаторы (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-токен для авторизации запроса. Если нет, получите его.
Убедитесь, что у вас есть сеть и подсеть, где будет размещен эндпоинт основного узла кластера. Если их нет, создайте сеть и подсеть.
Определите тип ВМ для конфигурации узла.
Определите тип внутреннего IP-адреса для primary-эндпоинта: временный, который выбирается автоматически из диапазона подсети, или зарезервированный. При необходимости зарезервируйте новый внутренний IP-адрес или узнайте имя существующего:
bash
```
1
curl -X GET https://vpc.mwsapis.ru/vpc/v1/projects/<имя проекта>/networks/<имя сети>/addresses \
2
  -H "Authorization: Bearer <IAM-токен>"
```
Если вы планируете подключаться к кластеру из внешней сети, определите тип внешнего IP-адреса для primary-эндпоинта: временный, который выбирается автоматически из диапазона подсети, или зарезервированный. При необходимости зарезервируйте новый внешний IP-адрес или узнайте имя существующего:
bash
```
1
curl -X GET https://vpc.mwsapis.ru/vpc/v1/projects/<имя проекта>/externalAddresses \
2
  -H "Authorization: Bearer <IAM-токен>"
```

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

1
{
2
  "metadata": {
3
    "displayName": "<отображаемое имя кластера>",
4
    "description": "<описание кластера>"
5
  },
6
  "spec": {
7
    "version": "<версия MySQL>",
8
    "active": <состояние кластера: true — запущен, false — остановлен>,
9
    "endpoints": [
10
      {
11
        "name": "<имя эндпоинта>",
12
        "network": "vpc/projects/<имя проекта>/networks/<имя сети>",
13
        "primaryAddresses": [
14
          {
15
            "spec": {
16
              "subnet": "projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>"
17
            },
18
            "ref": "vpc/projects/<имя проекта>/networks/<имя сети>/addresses/<имя зарезервированного внутреннего IP-адреса>",
19
            "externalAccess": {
20
              "allowed": <доступ из внешней сети: true — включен, false — выключен>,
21
              "ref": "vpc/projects/<имя проекта>/externalAddresses/<имя зарезервированного внешнего IP-адреса>"
22
            }
23
          }
24
        ]
25
      }
26
    ],
27
    "instanceTemplate": {
28
      "vmType": "<тип ВМ — например, vmTypes/gen-2-8>",
29
      "disk": {
30
        "size": "<размер диска в гигабайтах — например, 20GB>",
31
        "type": "<тип диска — NETWORK_STANDARD_SSD>",
32
        "iops": <количество IOPS — например, 1000>
33
      }
34
    },
35
    "instances": [
36
      {
37
        "count": <количество узлов — 1>,
38
        "zone": "<зона доступности — ru-central1-a или ru-central1-b>"
39
      }
40
    ],
41
    "backup": {
42
      "hour": <время начала резервного копирования — от 0 до 23>,
43
      "retainPeriodDays": <срок хранения резервных копий в днях>
44
    },
45
    "maintenanceWindow": {
46
      "weekly": {
47
        "days": [
48
          "<день для сервисного окна — например, MONDAY>"
49
        ],
50
        "hour": <время начала сервисного окна — от 0 до 23>
51
      }
52
    }
53
  }
54
}

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

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