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

Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

Чтобы создать кластер Managed Service for Redis:

1. Проверьте, есть ли в каталоге подсети для хостов кластера:

   yc vpc subnet list
   

   Если ни одной подсети в каталоге нет, создайте нужные подсети в сервисе VPC.

2. Посмотрите описание команды CLI для создания кластера:

   yc managed-redis cluster create --help
   

3. При создании кластера с помощью CLI нельзя напрямую указать тип хоста и объем оперативной памяти. Вместо этого выберите подходящий класс хостов. Чтобы просмотреть доступные классы хостов, выполните команду:

   yc managed-redis resource-preset list
   

4. Укажите параметры кластера в команде создания (в примере приведены не все флаги):

   yc managed-redis cluster create \
     --name <имя_кластера> \
     --environment <окружение> \
     --network-name <имя_сети> \
     --host zone-id=<зона_доступности>,`
           `subnet-id=<идентификатор_подсети>,`
           `assign-public-ip=<публичный_доступ>,`
           `replica-priority=<приоритет_хоста> \
     --security-group-ids <список_идентификаторов_групп_безопасности> \
     --enable-tls \
     --resource-preset <класс_хоста> \
     --disk-size <размер_хранилища_ГБ> \
     --disk-type-id <network-ssd|network-ssd-nonreplicated|local-ssd> \
     --password=<пароль_пользователя> \
     --backup-window-start <время> \
     --deletion-protection \
     --announce-hostnames <использование_FQDN_вместо_IP-адресов>
   

   Где:

   • --environment — окружение: prestable или production.

   • --host — параметры хоста:

     • zone-id — зона доступности.
     • subnet-id — идентификатор подсети. Необходимо указывать, если в выбранной зоне доступности создано две или больше подсетей.
     • assign-public-ip — доступность хоста из интернета по публичному IP-адресу: true или false.
     • replica-priority — приоритет назначения хоста мастером при выходе из строя основного мастера.

   • --disk-type-id — тип диска.

     Важно

     Тип диска нельзя изменить после создания кластера.

   • websql-access — разрешает выполнять SQL-запросы к базам данных кластера из консоли управления Yandex Cloud с помощью сервиса Yandex WebSQL. Значение по умолчанию — false.

   • --backup-window-start — время начала резервного копирования в формате ЧЧ:ММ:СС.

   • --deletion-protection — защита от удаления кластера.

   • --announce-hostnames — настройка, определяющая, использовать ли FQDN вместо IP-адресов: true или false.

     Примечание

     Некоторые клиенты несовместимы с этой настройкой и не смогут подключиться к хостам кластера. Такие клиенты ожидают именно IP-адрес и некорректно обрабатывают ситуацию, когда IP-адрес подменяется на FQDN.

   Идентификатор подсети subnet-id необходимо указывать, если в выбранной зоне доступности создано 2 и больше подсетей.

   Допустимая длина пароля — от 8 до 128 символов. Пароль должен удовлетворять регулярному выражению [a-zA-Z0-9@=+?*.,!&#$^<>_-]*.

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

   Если вы создаёте шардированный кластер с типом диска local-ssd, укажите в команде не менее двух хостов на шард.

   Примечание

   По умолчанию при создании кластера устанавливается режим технического обслуживания anytime — в любое время. Вы можете установить конкретное время обслуживания при изменении настроек кластера.

Terraform позволяет быстро создать облачную инфраструктуру в Yandex Cloud и управлять ею с помощью файлов конфигураций. В файлах конфигураций хранится описание инфраструктуры на языке HCL (HashiCorp Configuration Language). При изменении файлов конфигураций Terraform автоматически определяет, какая часть вашей конфигурации уже развернута, что следует добавить или удалить.

Terraform распространяется под лицензией Business Source License, а провайдер Yandex Cloud для Terraform — под лицензией MPL-2.0.

Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform или в зеркале.

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

Чтобы создать кластер Managed Service for Redis:

1. Опишите в конфигурационном файле параметры ресурсов, которые необходимо создать:

   • Кластер базы данных — описание кластера и его хостов. При необходимости здесь же можно задать настройки СУБД.

   • Сеть — описание облачной сети, в которой будет расположен кластер. Если подходящая сеть у вас уже есть, описывать ее повторно не нужно.

   • Подсети — описание подсетей, к которым будут подключены хосты кластера. Если подходящие подсети у вас уже есть, описывать их повторно не нужно.

   Пример структуры конфигурационного файла для создания нешардированного кластера с поддержкой SSL:

   resource "yandex_mdb_redis_cluster" "<имя_кластера>" {
     name                = "<имя_кластера>"
     environment         = "<окружение>"
     network_id          = "<идентификатор_сети>"
     security_group_ids  = [ "<список_идентификаторов_групп_безопасности>" ]
     tls_enabled         = true
     deletion_protection = <защита_от_удаления>
     announce_hostnames  = <использование_FQDN_вместо_IP-адресов>
   
     config {
       password = "<пароль>"
       version  = "<версия_Redis>"
     }
   
     resources {
       resource_preset_id = "<класс_хоста>"
       disk_type_id       = "<тип_диска>"
       disk_size          = <размер_хранилища_ГБ>
     }
   
     host {
       zone             = "<зона_доступности>"
       subnet_id        = "<идентификатор_подсети>"
       assign_public_ip = <публичный_доступ>
       replica_priority = <приоритет_хоста>
     }
   }
   
   resource "yandex_vpc_network" "<имя_сети>" { name = "<имя_сети>" }
   
   resource "yandex_vpc_subnet" "<имя_подсети>" {
     name           = "<имя_подсети>"
     zone           = "<зона_доступности>"
     network_id     = "<идентификатор_сети>"
     v4_cidr_blocks = ["<диапазон>"]
   }
   

   Где:

   • environment — окружение: PRESTABLE или PRODUCTION.

   • deletion_protection — защита от удаления кластера: true или false.

   • announce_hostnames — настройка, определяющая, использовать ли FQDN вместо IP-адресов: true или false.

     Примечание

     Некоторые клиенты несовместимы с этой настройкой и не смогут подключиться к хостам кластера. Такие клиенты ожидают именно IP-адрес и некорректно обрабатывают ситуацию, когда IP-адрес подменяется на FQDN.

   • version — версия Redis: 7.2.

   • host — параметры хоста:

     • zone_id — зона доступности.
     • subnet_id — идентификатор подсети в выбранной зоне доступности.
     • assign_public_ip — публичный доступ к хосту: true или false.
     • replica_priority — приоритет назначения хоста мастером при выходе из строя основного мастера.

   Допустимая длина пароля — от 8 до 128 символов. Пароль должен удовлетворять регулярному выражению [a-zA-Z0-9@=+?*.,!&#$^<>_-]*.

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

   Если вы создаёте шардированный кластер с типом диска local-ssd, укажите в конфигурационном файле не менее двух хостов на шард.

   Чтобы настроить время технического обслуживания (в т. ч. для выключенных кластеров), добавьте к описанию кластера блок maintenance_window:

   resource "yandex_mdb_redis_cluster" "<имя_кластера>" {
     ...
     maintenance_window {
       type = <тип_технического_обслуживания>
       day  = <день_недели>
       hour = <час_дня>
     }
     ...
   }
   

   Где:

   • type — тип технического обслуживания. Принимает значения:
     • ANYTIME — в любое время.
     • WEEKLY — по расписанию.
   • day — день недели для типа WEEKLY в формате DDD. Например, MON.
   • hour — час дня по UTC для типа WEEKLY в формате HH. Например, 21.

   Более подробную информацию о ресурсах, которые вы можете создать с помощью Terraform, см. в документации провайдера.

2. Проверьте корректность настроек.

   1. В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.

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

      terraform validate
      

      Если в файлах конфигурации есть ошибки, Terraform на них укажет.

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

   1. Выполните команду для просмотра планируемых изменений:

      terraform plan
      

      Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.

   2. Если вас устраивают планируемые изменения, внесите их:

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

         terraform apply
         

      2. Подтвердите изменение ресурсов.

      3. Дождитесь завершения операции.

   После этого в указанном каталоге будут созданы все требуемые ресурсы, а в терминале отобразятся FQDN хостов кластера. Проверить появление ресурсов и их настройки можно в консоли управления.

   Ограничения по времени

   Провайдер Terraform ограничивает время на выполнение операций с кластером Managed Service for Redis:

   • создание, в т. ч. путем восстановления из резервной копии, — 15 минут;
   • изменение — 60 минут;
   • удаление — 15 минут.

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

   Как изменить эти ограничения?

   Добавьте к описанию кластера блок timeouts, например:

   resource "yandex_mdb_redis_cluster" "<имя_кластера>" {
     ...
     timeouts {
       create = "1h30m" # Полтора часа
       update = "2h"    # 2 часа
       delete = "30m"   # 30 минут
     }
   }
   

Чтобы создать кластер Redis, воспользуйтесь методом REST API create для ресурса Cluster или вызовом gRPC API ClusterService/Create и передайте в запросе:

• Идентификатор каталога, в котором должен быть размещен кластер, в параметре folderId.

• Имя кластера в параметре name.

• Идентификаторы групп безопасности в параметре securityGroupIds.

• Флаг tlsEnabled=true для создания кластера с поддержкой шифрованных SSL-соединений.

• Флаг announceHostnames, который определяет, использовать ли FQDN вместо IP-адресов — true или false.

  Примечание

  Некоторые клиенты несовместимы с этой настройкой и не смогут подключиться к хостам кластера. Такие клиенты ожидают именно IP-адрес и некорректно обрабатывают ситуацию, когда IP-адрес подменяется на FQDN.

• Настройки публичного доступа к хостам в параметре hostSpecs[].assignPublicIp.

• Настройки доступа из Yandex Data Transfer в параметре configSpec.access.dataTransfer.

Если вы создаёте шардированный кластер с типом диска local-ssd, укажите в теле запроса не менее двух хостов на шард.

Создайте кластер Managed Service for Redis и сеть для него с тестовыми характеристиками:

• Имя myredis.
• Версия 7.2.
• Окружение — PRODUCTION.
• Облако с идентификатором b1gq90dgh25********.
• Каталог с идентификатором b1gia87mbaom********.
• Новая сеть mynet.
• Один хост класса hm2.nano в новой подсети mysubnet, в зоне доступности ru-central1-a, с публичным доступом и приоритетом хоста 50. Подсеть mysubnet будет иметь диапазон 10.5.0.0/24.
• Новая группа безопасности redis-sg, разрешающая подключения через порт 6380 с любых адресов подсети mysubnet.
• С поддержкой SSL-соединений.
• Хранилище на сетевых SSD-дисках (network-ssd) размером 16 ГБ.
• Пароль user1user1.
• С защитой от случайного удаления кластера.

Конфигурационный файл для такого кластера выглядит так:

resource "yandex_mdb_redis_cluster" "myredis" {
  name                = "myredis"
  environment         = "PRODUCTION"
  network_id          = yandex_vpc_network.mynet.id
  security_group_ids  = [ yandex_vpc_security_group.redis-sg.id ]
  tls_enabled         = true
  deletion_protection = true

  config {
    password = "user1user1"
    version  = "7.2"
  }

  resources {
    resource_preset_id = "hm2.nano"
    disk_type_id       = "network-ssd"
    disk_size          = 16
  }

  host {
    zone             = "ru-central1-a"
    subnet_id        = yandex_vpc_subnet.mysubnet.id
    assign_public_ip = true
    replica_priority = 50
  }
}

resource "yandex_vpc_network" "mynet" { name = "mynet" }

resource "yandex_vpc_security_group" "redis-sg" {
  name       = "redis-sg"
  network_id = yandex_vpc_network.mynet.id

  ingress {
    description    = "Redis"
    port           = 6380
    protocol       = "TCP"
    v4_cidr_blocks = ["10.5.0.0/24"]
  }
}

resource "yandex_vpc_subnet" "mysubnet" {
  name           = "mysubnet"
  zone           = "ru-central1-a"
  network_id     = yandex_vpc_network.mynet.id
  v4_cidr_blocks = ["10.5.0.0/24"]
}

Создайте шардированный кластер Managed Service for Redis и сеть для него с тестовыми характеристиками:

• Имя myredis.
• Версия 7.2.
• Окружение PRODUCTION.
• С включенным шардированием.
• С поддержкой SSL-соединений.
• С защитой от случайного удаления кластера.
• Новая сеть mynet, которая будет состоять из одной подсети. Эта новая подсеть mysubnet будет иметь диапазон 10.5.0.0/24.
• Новая группа безопасности redis-sg, разрешающая подключения через порт 6380 с любых адресов подсети mysubnet.
• Класс хостов hm2.nano.
• Один хост в шарде shard1, в подсети mysubnet, в зоне доступности ru-central1-a, с публичным доступом и приоритетом хоста 50.
• Хранилище на сетевых SSD-дисках (network-ssd) размером 16 ГБ.
• Пароль user1user1.

Конфигурационный файл для такого кластера выглядит так:

resource "yandex_mdb_redis_cluster" "myredis" {
  name                = "myredis"
  environment         = "PRODUCTION"
  sharded             = true
  tls_enabled         = true
  deletion_protection = true
  network_id          = yandex_vpc_network.mynet.id
  security_group_ids  = [yandex_vpc_security_group.redis-sg.id]

  config {
    version  = "7.2"
    password = "user1user1"
  }

  resources {
    resource_preset_id = "hm2.nano"
    disk_type_id       = "network-ssd"
    disk_size          = 16
  }

  host {
    shard_name = "shard1"
    subnet_id  = yandex_vpc_subnet.mysubnet.id
    zone       = "ru-central1-a"
    assign_public_ip = true
    replica_priority = 50
  }
}

resource "yandex_vpc_network" "mynet" { name = "mynet" }

resource "yandex_vpc_subnet" "mysubnet" {
  name           = "mysubnet"
  zone           = "ru-central1-a"
  network_id     = yandex_vpc_network.mynet.id
  v4_cidr_blocks = ["10.5.0.0/24"]
}

resource "yandex_vpc_security_group" "redis-sg" {
  name       = "redis-sg"
  network_id = yandex_vpc_network.mynet.id

  ingress {
    description    = "Redis"
    port           = 6380
    protocol       = "TCP"
    v4_cidr_blocks = ["10.5.0.0/24"]
  }
}