Миграция кластера с v1 на v2

Перед началом миграции рекомендуем ознакомиться с изменениями.

Чтобы выполнить миграцию кластера с ресурса v1 (yandex_mdb_clickhouse_cluster) на ресурс v2 (yandex_mdb_clickhouse_cluster_v2):

1. Обновите конфигурацию Terraform.
2. Сохраните идентификатор кластера.
3. Удалите старый ресурс из state.
4. Импортируйте существующий ресурс в новый.
5. (Опционально) Импортируйте базы данных и пользователей.
6. Проверьте планируемые изменения.
7. Примените изменения.

Обновите конфигурацию TerraformОбновите конфигурацию Terraform

1. Внесите все синтаксические изменения, которые указаны в таблице:

   v1 (блочный синтаксис)	v2 (синтаксис присваивания)
   clickhouse { }	clickhouse = { }
   zookeeper { }	zookeeper = { }
   access { }	access = { }
   cloud_storage { }	cloud_storage = { }
   backup_window_start { }	backup_window_start = { }
   clickhouse.config.kafka { }	kafka = { } (внутри config)
   clickhouse.config.rabbitmq { }	rabbitmq = { } (внутри config)
   clickhouse.config.compression { } (повторяющийся блок)	compression = [{ method = "LZ4", ... }]
   host { } (повторяющийся блок)	hosts = { "key" = { } }
   shard { } (повторяющийся блок)	shards = { "shard1" = { } }

2. Задайте ключи для хостов.

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

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

   terraform state show yandex_mdb_clickhouse_cluster.main
   

2. Скопируйте значение id из вывода, оно понадобится далее.

Удалите старый ресурс из stateУдалите старый ресурс из state

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

terraform state rm yandex_mdb_clickhouse_cluster.main

Импортируйте существующий ресурс в новыйИмпортируйте существующий ресурс в новый

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

terraform import yandex_mdb_clickhouse_cluster_v2.main <идентификатор_кластера>

В команде используйте значение id, которое вы получили ранее.

После импорта ключами хостов в state станут их FQDN, например "rc1a-abc.mdb.yandexcloud.net".

(Опционально) Импортируйте базы данных и пользователей(Опционально) Импортируйте базы данных и пользователей

Если database {} или user {} раньше были частью ресурса кластера, а теперь представлены отдельными ресурсами, импортируйте их:

terraform import 'yandex_mdb_clickhouse_database.mydb' "<идентификатор_кластера>:<имя_БД>"
terraform import 'yandex_mdb_clickhouse_user.myuser'   "<идентификатор_кластера>:<имя_пользователя>"

Проверьте планируемые измененияПроверьте планируемые изменения

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

terraform plan

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

В plan все хосты могут отображаться как + и -. Хотя это и выглядит настораживающе, применение изменений безопасно для совпадающих хостов.

Провайдер выполняет сопоставление хостов в три этапа:

1. Ключ совпадает в plan и state — хост сохраняется без изменений, никаких действий не требуется.
2. Полное соответствие по zone, subnet_id, type, shard_name, assign_public_ip — ключ в state переименовывается в ключ из plan, сам хост не затрагивается.
3. Частичное совпадение по zone, FQDN, shard_name, subnet_id — ключ в state переименовывается в ключ из plan, при этом может потребоваться обновление, например assign_public_ip.

Для ключей хостов в plan используются короткие ключи, например "c1", "k1". При совпадении zone, subnet, type и shard запустится второй этап сопоставления: ключи будут переименованы без фактических изменений хостов.

Примените измененияПримените изменения

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

   terraform apply
   

2. Подтвердите создание ресурсов: введите в терминал слово yes и нажмите Enter.

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

В случае возникновения ошибок ознакомьтесь с разделом Ошибки при миграции.

Полезные ссылкиПолезные ссылки

• Изменения в кластере v2