Управление хостами MySQL-кластера

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

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

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

yc managed-mysql host list \
   --cluster-name=<имя кластера>

Результат:

+-----------------------+--------------+---------+--------+-------------------+
|         NAME          |  CLUSTER ID  |  ROLE   | HEALTH |      ZONE ID      |
+-----------------------+--------------+---------+--------+-------------------+
| rc1b...mdb.yandexcloud.net | c9q5k4ve7... | MASTER  | ALIVE  | ru-central1-b |
| rc1a...mdb.yandexcloud.net | c9q5k4ve7... | REPLICA | ALIVE  | ru-central1-a |
+-----------------------+--------------+---------+--------+-------------------+

Имя кластера можно запросить со списком кластеров в каталоге.

Воспользуйтесь методом API listHosts и передайте в запросе идентификатор кластера в параметре clusterId.

Чтобы узнать идентификатор кластера, получите список кластеров в каталоге.

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

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

Чтобы добавить хост в кластер:

1. Запросите список подсетей кластера, чтобы выбрать подсеть для нового хоста:

   yc vpc subnet list
   

   Результат:

   +-----------+-----------+------------+-------------------+------------------+
   |     ID    |   NAME    | NETWORK ID |       ZONE        |      RANGE       |
   +-----------+-----------+------------+-------------------+------------------+
   | b0cl69... | default-c | enp6rq7... | ru-central1-c | [172.16.0.0/20]  |
   | e2lkj9... | default-b | enp6rq7... | ru-central1-b | [10.10.0.0/16]   |
   | e9b0ph... | a-2       | enp6rq7... | ru-central1-a | [172.16.32.0/20] |
   | e9b9v2... | default-a | enp6rq7... | ru-central1-a | [172.16.16.0/20] |
   +-----------+-----------+------------+-------------------+------------------+
   

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

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

   yc managed-mysql host add --help
   

3. Выполните команду добавления хоста (в примере приведены не все доступные параметры):

   yc managed-mysql host add \
     --cluster-name=<имя кластера> \
     --host zone-id=<идентификатор зоны доступности>,`
       `subnet-id=<идентификатор подсети>,`
       `assign-public-ip=<публичный доступ к хосту подкластера: true или false>,`
       `replication-source=<имя хоста-источника>,`
       `backup-priority=<приоритет хоста при резервном копировании>,`
       `priority=<приоритет назначения хоста мастером: от 0 до 100>
   

   Где:

   • --cluster-name — имя кластера Managed Service for MySQL.
   • --host — параметры хоста:
     • zone-id — зона доступности.
     • subnet-id — идентификатор подсети. Необходимо указывать, если в выбранной зоне доступности создано две или больше подсетей.
     • assign-public-ip — доступность хоста из интернета по публичному IP-адресу.
     • replication-source — источник репликации для хоста.
     • backup-priority — приоритет хоста при резервном копировании.
     • priority — приоритет назначения хоста мастером при выходе из строя основного мастера.

   Имя кластера можно запросить со списком кластеров в каталоге.

1. Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

   О том, как создать такой файл, см. в разделе Создание MySQL-кластера.

2. Добавьте к описанию кластера Managed Service for MySQL блок host:

   resource "yandex_mdb_mysql_cluster" "<имя кластера>" {
     ...
     host {
       zone             = "<зона доступности>"
       subnet_id        = <идентификатор подсети>
       assign_public_ip = <публичный доступ к хосту: true или false>
       priority         = <приоритет назначения хоста мастером: от 0 до 100>
       ...
     }
   }
   

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

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

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

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

Воспользуйтесь методом API addHosts и передайте в запросе:

• Идентификатор кластера в параметре clusterId. Чтобы узнать идентификатор, получите список кластеров в каталоге.
• Настройки нового хоста в одном или нескольких параметрах hostSpecs.

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

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

Чтобы изменить параметры хоста, выполните команду (в примере приведены не все доступные параметры):

yc managed-mysql host update <имя хоста> \
  --cluster-name=<имя кластера> \
  --replication-source=<имя хоста-источника> \
  --assign-public-ip=<публичный доступ к хосту: true или false> \
  --backup-priority=<приоритет хоста при резервном копировании: от 0 до 100> \
  --priority=<приоритет назначения хоста мастером: от 0 до 100>

Где:

• --cluster-name — имя кластера Managed Service for MySQL.
• --replication-source — источник репликации для хоста.
• --assign-public-ip — доступность хоста из интернета по публичному IP-адресу.
• --backup-priority — приоритет хоста при резервном копировании.
• --priority — приоритет назначения хоста мастером при выходе из строя основного мастера.

Имя хоста можно запросить со списком хостов в кластере, имя кластера — со списком кластеров в каталоге.

Чтобы изменить параметры хоста в кластере:

1. Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

   О том, как создать такой файл, см. в разделе Создание MySQL-кластера.

2. Измените в описании кластера Managed Service for MySQL атрибуты блока host, соответствующего изменяемому хосту.

   resource "yandex_mdb_mysql_cluster" "<имя кластера>" {
     ...
     host {
       replication_source_name = "<источник репликации>"
       assign_public_ip        = <публичный доступ к хосту: true или false>
       priority                = <приоритет назначения хоста мастером: от 0 до 100>
     }
   }
   

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

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

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

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

Чтобы изменить параметры хоста, воспользуйтесь методом API updateHosts и передайте в запросе:

• Идентификатор кластера в параметре clusterId. Чтобы узнать идентификатор, получите список кластеров в каталоге.

• Массив настроек изменяемых хостов в параметре updateHostSpecs.

  Для каждого хоста укажите:

  • Имя в поле hostName.
  • Список настроек, которые необходимо изменить, в параметре updateMask.

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

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

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

yc managed-mysql host delete <имя хоста> \
   --cluster-name=<имя кластера>

Имя хоста можно запросить со списком хостов в кластере, имя кластера — со списком кластеров в каталоге.

1. Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

   О том, как создать такой файл, см. в разделе Создание MySQL-кластера.

2. Удалите из описания кластера Managed Service for MySQL блок host.

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

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

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

      terraform validate
      

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

4. Введите слово yes и нажмите Enter.

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

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

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

Воспользуйтесь методом API deleteHosts и передайте в запросе:

• Идентификатор кластера в параметре clusterId. Чтобы узнать идентификатор, получите список кластеров в каталоге.
• Имя или массив имен удаляемых хостов в параметре hostNames.