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

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

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

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

Укажите зону доступности, где будет размещен кластер.

Выберите тип ВМ для конфигурации узла. Позже выбрать тип ВМ с меньшим размером вычислительных ресурсов будет нельзя.

Укажите размер диска. Позже его нельзя будет уменьшить.

(опционально) Укажите максимальное количество операций ввода-вывода в секунду. Допустимо значение от 1 000 до 10 000, кратное 100. Если значение не задано, применится значение по умолчанию.

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

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

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

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

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

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

   При необходимости зарезервируйте внутренний IP-адрес.

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

Введите пароль системного пользователя вручную или сгенерируйте его.

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

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

Сохраните пароль системного пользователя локально или в секрете Secret Manager: позже доступа к паролю не будет. За использование сервиса Secret Manager взимается плата.

Чтобы сохранить пароль в Secret Manager:

1. В блоке Дополнительные настройки нажмите кнопку Сохранить в Secret Manager.

   В новой вкладке браузера откроется страница создания секрета.

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

3. (опционально) Чтобы использовать для шифрования ключ KMS, выберите Пользовательский ключ, затем выберите нужный ключ KMS или создайте новый. По умолчанию используется Системный ключ, которым управляет MWS Cloud Platform.

4. (опционально) Измените автоматически сгенерированное описание секрета.

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

   Учетные данные администратора будут сохранены в первой версии секрета.

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

Если у вас нет утилиты MWS CLI:

1. Установите утилиту.

2. Инициализируйте профиль.

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

Определите тип внутреннего IP-адреса: временный, который выбирается автоматически из диапазона подсети, или зарезервированный.

1. Если вы будете использовать зарезервированный IP-адрес:

   1. Узнайте имя IP-адреса:

      1
      mws vpc address list --network <имя сети>

   2. Узнайте идентификатор IP-адреса:

      1
      mws vpc address get <имя IP-адреса> \
      2
        --network <имя сети>

При необходимости зарезервируйте внутренний IP-адрес.

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

Выполните команду:

1
mws mvalkey cluster create <имя кластера> \
2
  --version "версия Valkey — например, 9.1" \
3
  --endpoints '
4
    name: <имя эндпоинта>
5
    network: projects/<имя проекта>/networks/<имя сети>
6
    addresses:
7
      - ref: <(опционально) идентификатор внутреннего зарезервированного IP-адреса>
8
        spec:
9
          subnet: projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>
10
  ' \
11
  --instances-vm-type <тип ВМ — например, vmTypes/gen-2-8> \
12
  --instances-disk-type <тип диска — сетевой NETWORK_STANDARD_SSD> \
13
  --instances-disk-size <размер диска в гигабайтах — например, 10GB> \
14
  --instances-disk-iops <количество IOPS — например, 1000> \
15
  --instances-allocation '
16
    count: <количество узлов — 1>
17
    zone: <зона доступности — ru-central1-a или ru-central1-b>
18
  ' \
19
  --config-databases <количество баз данных> \
20
  --config-default-user-password '<пароль системного пользователя>' \
21
  --maintenance-window-weekly-days <день для сервисного окна — например, MONDAY> \
22
  --maintenance-window-weekly-hour <время начала сервисного окна — от 0 до 23>

Параметры спецификации кластера:

• Размер диска нельзя будет уменьшить после создания кластера.

• Позже выбрать тип ВМ с меньшим размером вычислительных ресурсов будет нельзя.

• --endpoints:

  • addresses.ref — назначить внутренний зарезервированный IP-адрес. Если зарезервированный IP-адрес не указан, будет использоваться временный.

• --config-* — настройки Valkey. Подробнее о настройках Valkey.

  Пример описания настроек Valkey

  1
  mws mvalkey cluster update <имя кластера> \
  2
    --config-databases <количество баз данных> \
  3
    --config-maxmemory-policy <политика вытеснения ключей> \
  4
    --config-maxmemory-percent <процент памяти, доступный кластеру> \
  5
    --config-timeout <таймаут простоя> \
  6
    --config-activedefrag <true или false> \
  7
    --config-io-threads-allowed <true или false> \
  8
    --config-lfu-decay-time <время в минутах> \
  9
    --config-lfu-log-factor <множитель LFU> \
  10
    --config-lua-time-limit <лимит времени Lua в миллисекундах> \
  11
    --config-notify-keyspace-events "<флаги событий>" \
  12
    --config-repl-backlog-size-percent <размер лога в процентах> \
  13
    --config-slowlog-log-slower-than <порог slow log микросекундах> \
  14
    --config-slowlog-max-len <максимум записей slow log> \
  15
    --config-zset-max-listpack-entries <максимум элементов в zset> \
  16
    --config-client-output-buffer-limit-pubsub-hard-limit <жесткий лимит Pub/Sub> \
  17
    --config-client-output-buffer-limit-pubsub-soft-limit <мягкий лимит Pub/Sub> \
  18
    --config-client-output-buffer-limit-pubsub-soft-seconds <секунды мягкого лимита Pub/Sub> \
  19
    --config-client-output-buffer-limit-normal-hard-limit <жесткий лимит обычных соединений> \
  20
    --config-client-output-buffer-limit-normal-soft-limit <мягкий лимит обычных соединений> \
  21
    --config-client-output-buffer-limit-normal-soft-seconds <секунды мягкого лимита обычных соединений> \

Допустимое значение IOPS: от 1 000 до 10 000, кратное 100. Если значение не задано, применится значение по умолчанию.

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

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

Определите тип внутреннего IP-адреса: временный, который выбирается автоматически из диапазона подсети, или зарезервированный.

1. Если вы будете использовать зарезервированный IP-адрес:

   1. Узнайте имя IP-адреса:

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

   2. Узнайте идентификатор IP-адреса:

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

При необходимости зарезервируйте внутренний IP-адрес.

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

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

1
{
2
  "metadata": {
3
    "displayName": "<имя кластера>"
4
  },
5
  "spec": {
6
    "version": "<версия Valkey — например, 9.1>",
7
    "endpoints": [
8
      {
9
        "name": "<имя эндпоинта>",
10
        "network": "projects/<имя проекта>/networks/<имя сети>",
11
        "addresses": [
12
          {
13
            "ref": "<(опционально) идентификатор внутреннего зарезервированного IP-адреса>",
14
            "spec": {
15
              "subnet": "projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>"
16
            }
17
          }
18
        ]
19
      }
20
    ],
21
    "instances": {
22
      "vmType": "<тип ВМ — например, vmTypes/gen-2-8>",
23
      "disk": {
24
        "type": "<тип диска — сетевой NETWORK_STANDARD_SSD>",
25
        "size": "<размер диска в гигабайтах — например, 10GB>",
26
        "iops": <количество IOPS — например, 1000>
27
      },
28
      "allocation": [
29
        {
30
          "count": <количество узлов — 1>,
31
          "zone": "<зона доступности — ru-central1-a или ru-central1-b>"
32
        }
33
      ]
34
    },
35
    "config": {
36
      "databases": <количество баз данных>,
37
      "defaultUserPassword": "<пароль системного пользователя>"
38
    },
39
    "maintenanceWindow": {
40
      "weekly": {
41
        "days": [
42
          "<день для сервисного окна — например, MONDAY>"
43
        ],
44
        "hour": <время начала сервисного окна — от 0 до 23>
45
      }
46
    }
47
  }
48
}

Параметры спецификации кластера:

• Размер диска нельзя будет уменьшить после создания кластера.

• Позже выбрать тип ВМ с меньшим размером вычислительных ресурсов будет нельзя.

• spec.endpoints.addresses.ref — назначить внутренний зарезервированный IP-адрес. Если зарезервированный IP-адрес не указан, будет использоваться временный.

• spec.config — настройки Valkey. Подробнее о настройках Valkey.

  Пример описания настроек Valkey

  1
  {
  2
    "spec": {
  3
      "config": {
  4
        "databases": "<количество баз данных>",
  5
        "maxmemoryPolicy": "<политика вытеснения ключей>",
  6
        "maxmemoryPercent": "<процент памяти, доступный кластеру>",
  7
        "timeout": "<таймаут простоя>",
  8
        "activedefrag": "<true или false>",
  9
        "ioThreadsAllowed": "<true или false>",
  10
        "lfuDecayTime": "<время в минутах>",
  11
        "lfuLogFactor": "<множитель LFU>",
  12
        "luaTimeLimit": "<лимит времени Lua в миллисекундах>",
  13
        "notifyKeyspaceEvents": "<флаги событий>",
  14
        "replBacklogSizePercent": "<размер лога в процентах>",
  15
        "slowlogLogSlowerThan": "<порог slow log микросекундах>",
  16
        "slowlogMaxLen": "<максимум записей slow log>",
  17
        "zsetMaxListpackEntries": "<максимум элементов в zset>",
  18
        "clientOutputBufferLimitPubsub": {
  19
          "hardLimit": "<жесткий лимит Pub/Sub>",
  20
          "softLimit": "<мягкий лимит Pub/Sub>",
  21
          "softSeconds": "<секунды мягкого лимита Pub/Sub>"
  22
        },
  23
        "clientOutputBufferLimitNormal": {
  24
          "hardLimit": "<жесткий лимит обычных соединений>",
  25
          "softLimit": "<мягкий лимит обычных соединений>",
  26
          "softSeconds": "<секунды мягкого лимита обычных соединений>"
  27
        }
  28
      }
  29
    }
  30
  }

Допустимое значение IOPS: от 1 000 до 10 000, кратное 100. Если значение не задано, применится значение по умолчанию.

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

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

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