Изменение версии ClickHouse

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

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

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

yc managed-clickhouse version list

Посмотреть список доступных версий можно с помощью метода API list.

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

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

1. Получите список ваших кластеров ClickHouse:

   yc managed-clickhouse cluster list
   
   +----------------------+---------------+---------------------+--------+---------+
   |          ID          |     NAME      |     CREATED AT      | HEALTH | STATUS  |
   +----------------------+---------------+---------------------+--------+---------+
   | c9q8p8j2gaih8iti42mh | clickhouse691 | 2019-04-23 12:44:17 | ALIVE  | RUNNING |
   +----------------------+---------------+---------------------+--------+---------+
   

2. Получите информацию о нужном кластере и проверьте версию ClickHouse в вашем кластере, указанную в свойстве config.version:

   yc managed-clickhouse cluster get c9q8p8j2gaih8iti42mh
   id: c9q8p8j2gaih8iti42mh
   folder_id: b1gqs1teo2q2a4vnmi2t
   created_at: "2019-04-23T12:44:17.929853Z"
   name: clickhouse691
   environment: PRODUCTION
   monitoring:
   - name: Console
       description: Console charts
       link: https://console.cloud.yandex.ru/folders/b1gqs1teo2q2a4vnmi2t/managed-clickhouse/cluster/c9q8p8j2gaih8iti42mh?section=monitoring
   config:
       version: "19.1"
       ...
   

3. Запустите изменение версии ClickHouse:

   yc managed-clickhouse cluster update --id c9q8p8j2gaih8iti42mh --version 19.4
   

После того, как изменение версии запущено, кластер переходит в статус UPDATING. Дождитесь окончания операции и проверьте версию кластера.

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

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

2. Добавьте к описанию кластера Managed Service for ClickHouse поле version или измените его значение, если оно уже существует:

   resource "yandex_mdb_clickhouse_cluster" "<имя кластера>" {
     ...
     version = "<версия ClickHouse>"
   }
   

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

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

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

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

Воспользуйтесь методом API update и передайте в запросе нужное значение в параметре configSpec.clickhouse.config.version.