Обновление Kubernetes

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

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

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

yc managed-kubernetes list-versions

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

Укажите параметры автоматического обновления при создании или изменении кластера Managed Service for Kubernetes:

yc managed-kubernetes cluster <create_или_update> <имя_или_идентификатор_кластера> \
...
  --auto-upgrade <режим_автоматического_обновления> \
  --anytime-maintenance-window \
  --daily-maintenance-window <значение> \
  --weekly-maintenance-window <значение>

Где:

• --auto-upgrade — выбор режима автоматического обновления кластера Managed Service for Kubernetes. Значение по умолчанию — true (автоматическое обновление включено).

• --anytime-maintenance-window — выбор произвольного времени обновления кластера Managed Service for Kubernetes.

• --daily-maintenance-window — режим обновления Ежедневно.

  Пример ежедневного обновления кластера Managed Service for Kubernetes в 22:00 UTC длительностью не более 10 часов:

  --daily-maintenance-window 'start=22:00,duration=10h'
  

• --weekly-maintenance-window — автоматическое обновление в указанные дни.

  Пример обновления кластера Managed Service for Kubernetes по понедельникам и вторникам с 22:00 UTC, длительностью не более 10 часов:

  --weekly-maintenance-window 'days=[monday,tuesday],start=22:00,duration=10h'
  

  Чтобы указать несколько периодов обслуживания, передайте настройки каждого из них в отдельном аргументе --weekly-maintenance-window.

  Примечание

  Аргументы --daily-maintenance-window и --weekly-maintenance-window требуют аргумента --auto-upgrade со значением true. Расписание обновления не будет создано, если установить --auto-upgrade=false.

Идентификатор и имя кластера Managed Service for Kubernetes можно получить со списком кластеров в каталоге.

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

   Как создать такой файл, см. в разделе Создание кластера Managed Service for Kubernetes.

2. Измените параметры автоматического обновления в описании кластера Managed Service for Kubernetes.

   Примечание

   Вы можете выбрать только один из режимов обновления — ежедневный или в выбранные дни. Одновременное использование режимов не допускается.

   • Чтобы включить режим ежедневного обновления:

     resource "yandex_kubernetes_cluster" "<имя_кластера>" {
       name = <имя_кластера>
       ...
       maintenance_policy {
         auto_upgrade = true
         maintenance_window {
           start_time = "<время_начала_обновления>"
           duration   = "<длительность_обновления>"
         }
       }
     }
     

     Где:

     • start_time — время начала обновления в формате UTC.
     • duration — длительность обновления (например 4h30m).

   • Чтобы включить режим обновления в выбранные дни (можно указать несколько периодов):

     resource "yandex_kubernetes_cluster" "<имя_кластера>" {
       name = <имя_кластера>
       ...
       maintenance_policy {
         auto_upgrade = true
         maintenance_window {
           day        = "<день_начала_обновления>"
           start_time = "<время_начала_обновления>"
           duration   = "<длительность_обновления>"
         }
         maintenance_window {
           day        = "<день_начала_обновления>"
           start_time = "<время_начала_обновления>"
           duration   = "<длительность_обновления>"
         }
       }
     }
     

     Где:

     • day — день недели (например monday).
     • start_time — время начала обновления в формате UTC.
     • duration — длительность обновления (например 4h30m).

   • Чтобы включить режим произвольного времени обновления, не добавляйте блок параметров maintenance_policy в описание кластера Managed Service for Kubernetes. Если в описании кластера Managed Service for Kubernetes не указаны настройки автоматического обновления, оно будет производиться в произвольное время.

   • Чтобы отключить автоматическое обновление:

     resource "yandex_kubernetes_cluster" "<имя_кластера>" {
       name = "<имя_кластера>"
       ...
       maintenance_policy {
         auto_upgrade = false
       }
     }
     

3. Проверьте корректность конфигурационных файлов.

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

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

Настройки автоматического обновления задаются в блоке masterSpec.maintenancePolicy при создании кластера Managed Service for Kubernetes или изменении его настроек.

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

• Идентификатор кластера Managed Service for Kubernetes в параметре clusterId. Чтобы узнать идентификатор кластера Managed Service for Kubernetes, получите список кластеров в каталоге.
• Настройки автоматического обновления в параметре masterSpec.maintenancePolicy.
• Список изменяемых настроек в параметре updateMask.

Чтобы отключить автоматическое обновление, передайте значение false в параметре masterSpec.maintenancePolicy.autoUpgrade.

Для включения и настройки окна обновлений передайте одно из допустимых значений параметра maintenanceWindow:

• Чтобы кластер Managed Service for Kubernetes обновлялся в произвольное время, передайте значение "anytime": {}.

• Чтобы настроить ежедневные обновления, добавьте блок dailyMaintenanceWindow:

  "dailyMaintenanceWindow": {
    "startTime": {
      "hours": "<час_начала_обновления>",
      "minutes": "<минута_начала_обновления>",
      "seconds": "<секунда_начала_обновления>",
      "nanos": "<доля_секунды_начала_обновления>"
    },
    "duration": "<длительность_периода_обновления>"
  }
  

  Где:

  • hours — час начала обновления в формате UTC.
  • nanos — доля секунды начала обновления, в наносекундах.
  • duration — длительность периода обновления, в часах.

• Чтобы настроить обновление в выбранные дни, добавьте блок weeklyMaintenanceWindow:

  "weeklyMaintenanceWindow": {
    "daysOfWeek": [
      {
        "days": [
          "<список_дней>"
        ],
        "startTime": {
          "hours": "<час_начала_обновления>",
          "minutes": "<минута_начала_обновления>",
          "seconds": "<секунда_начала_обновления>",
          "nanos": "<доля_секунды_начала_обновления>"
        },
        "duration": "<длительность_периода_обновления>"
      }
    ]
  }
  

  Где:

  • days — список дней, например: monday, tuesday.
  • hours — час начала обновления в формате UTC.
  • nanos — доля секунды начала обновления, в наносекундах.
  • duration — длительность периода обновления, в часах.

Укажите новую версию Kubernetes в значении аргумента --version:

yc managed-kubernetes cluster update <имя_или_идентификатор_кластера> \
  --version <новая_версия>

Идентификатор и имя кластера Managed Service for Kubernetes можно получить со списком кластеров в каталоге.

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

   О том, как создать такой файл, см. в разделе Создание кластера Managed Service for Kubernetes.

2. Измените версию в описании кластера Managed Service for Kubernetes:

   resource "yandex_kubernetes_cluster" "<имя_кластера>" {
     name = <имя_кластера>
     ...
     version = "<новая_версия>"
   }
   

3. Проверьте корректность конфигурационных файлов.

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

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

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

• Идентификатор кластера Managed Service for Kubernetes в параметре clusterId. Чтобы узнать идентификатор кластера Managed Service for Kubernetes, получите список кластеров в каталоге.
• Нужную версию Kubernetes в параметре masterSpec.version.version.
• Список изменяемых настроек в параметре updateMask.

Укажите параметры автоматического обновления при создании или изменении группы узлов Managed Service for Kubernetes:

yc managed-kubernetes node-group <create_или_update> <имя_или_идентификатор_группы_узлов> \
...
  --max-expansion <расширение_размера_группы_при_обновлении> \
  --max-unavailable <количество_недоступных_узлов_при_обновлении> \
  --auto-upgrade <режим_автоматического_обновления> \
  --auto-repair <режим_пересоздания> \
  --anytime-maintenance-window \
  --daily-maintenance-window <значение> \
  --weekly-maintenance-window <значение>

Где:

• --max-expansion — максимальное количество узлов, на которое можно увеличить размер группы при ее обновлении.

  Важно

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

• --max-unavailable — максимальное количество недоступных узлов группы при ее обновлении.

  Примечание

  Параметры --max-expansion и --max-unavailable следует использовать совместно.

• --auto-upgrade — выбор режима автоматического обновления группы узлов Managed Service for Kubernetes. Значение по умолчанию — true (автоматическое обновление включено). Возможные значения: true или false.

• --auto-repair — выбор режима пересоздания сбойных узлов. Возможные значения: true или false.

  Режим --auto-repair находится на стадии Preview.

• --anytime-maintenance-window — выбор произвольного времени обновления группы узлов Managed Service for Kubernetes.

• --daily-maintenance-window — режим обновления Ежедневно.

  Пример ежедневного обновления группы узлов Managed Service for Kubernetes в 22:00 UTC длительностью не более 10 часов:

  --daily-maintenance-window 'start=22:00,duration=10h'
  

• --weekly-maintenance-window — автоматическое обновление в указанные дни.

  Пример обновления группы узлов Managed Service for Kubernetes по понедельникам и вторникам с 22:00 UTC, длительностью 10 часов:

  --weekly-maintenance-window 'days=[monday,tuesday],start=22:00,duration=10h'
  

  Чтобы указать несколько периодов обслуживания, передайте настройки каждого из них в отдельном аргументе --weekly-maintenance-window.

  Примечание

  Аргументы --daily-maintenance-window и --weekly-maintenance-window требуют аргумента --auto-upgrade со значением true.

  Расписание обновления не будет создано, если установить --auto-upgrade=false.

Идентификатор и имя группы узлов Managed Service for Kubernetes можно получить со списком групп в кластере.

1. Откройте актуальный конфигурационный файл с описанием группы узлов Managed Service for Kubernetes.

   О том, как создать такой файл, см. в разделе Создание группы узлов.

2. Измените параметры автоматического обновления в описании группы узлов Managed Service for Kubernetes.

   Примечание

   Вы можете выбрать только один из режимов обновления — ежедневный или в выбранные дни. Одновременное использование режимов не допускается.

   • Чтобы включить режим ежедневного обновления:

     resource "yandex_kubernetes_node_group" "<имя_группы_узлов>" {
       name = <имя_группы_узлов>
       ...
       maintenance_policy {
         auto_upgrade = true
         maintenance_window {
           start_time = "<время_начала_обновления>"
           duration   = "<длительность_обновления>"
         }
       }
     }
     

     Где:

     • start_time — время начала обновления в формате UTC.
     • duration — длительность обновления (например 4h30m).

   • Чтобы включить режим обновления в выбранные дни (можно указать несколько периодов):

     resource "yandex_kubernetes_node_group" "<имя_группы_узлов>" {
       name = <имя_группы_узлов>
       ...
       maintenance_policy {
         auto_upgrade = true
         maintenance_window {
           day        = "<день_начала_обновления>"
           start_time = "<время_начала_обновления>"
           duration   = "<длительность_обновления>"
         }
         maintenance_window {
           day        = "<день_начала_обновления>"
           start_time = "<время_начала_обновления>"
           duration   = "<длительность_обновления>"
         }
       }
     }
     

     Где:

     • day — день недели (например monday).
     • start_time — время начала обновления в формате UTC.
     • duration — длительность обновления (например 4h30m).

   • Чтобы включить режим произвольного времени обновления, не добавляйте блок параметров maintenance_policy в описание группы узлов Managed Service for Kubernetes. Если в описании группы узлов Managed Service for Kubernetes не указаны настройки автоматического обновления, оно будет производиться в произвольное время.

   • Чтобы задать настройки развертывания группы узлов Managed Service for Kubernetes при обновлении:

     resource "yandex_kubernetes_node_group" "<имя_группы_узлов>" {
       name = <имя_группы_узлов>
       ...
       deploy_policy {
         max_expansion   = <расширение_размера_группы_при_обновлении>
         max_unavailable = <количество_недоступных_узлов_при_обновлении>
       }
     }
     

     Где:

     • max_expansion — максимальное количество узлов, на которое можно увеличить размер группы при ее обновлении.

       Важно

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

     • max_unavailable — максимальное количество недоступных узлов группы при ее обновлении.

     Примечание

     Параметры max_expansion и max_unavailable следует использовать совместно.

   • Чтобы отключить автоматическое обновление:

     resource "yandex_kubernetes_node_group" "<имя_группы_узлов>" {
       name = "<имя_группы_узлов>"
       ...
       maintenance_policy {
         auto_upgrade = false
       }
     }
     

3. Проверьте корректность конфигурационных файлов.

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

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

Настройки автоматического обновления задаются в блоке maintenancePolicy при создании группы узлов Managed Service for Kubernetes или изменении ее настроек.

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

• Идентификатор группы узлов Managed Service for Kubernetes в параметре nodeGroupId. Чтобы узнать идентификатор группы узлов Managed Service for Kubernetes, получите список групп в кластере.
• Настройки автоматического обновления в параметре maintenancePolicy.
• Список изменяемых настроек в параметре updateMask.

Чтобы отключить автоматическое обновление, передайте значение false в параметре maintenancePolicy.autoUpgrade.

Для включения и настройки окна обновлений передайте одно из допустимых значений параметра maintenanceWindow:

• Чтобы группа узлов Managed Service for Kubernetes обновлялась в произвольное время, передайте значение "anytime": {}.

• Чтобы настроить ежедневные обновления, добавьте блок dailyMaintenanceWindow:

  "dailyMaintenanceWindow": {
    "startTime": {
      "hours": "<час_начала_обновления>",
      "minutes": "<минута_начала_обновления>",
      "seconds": "<секунда_начала_обновления>",
      "nanos": "<доля_секунды_начала_обновления>"
    },
    "duration": "<длительность_периода_обновления>"
  }
  

  Где:

  • hours — час начала обновления в формате UTC.
  • nanos — доля секунды начала обновления, в наносекундах.
  • duration — длительность периода обновления, в часах.

• Чтобы настроить обновление в выбранные дни, добавьте блок weeklyMaintenanceWindow:

  "weeklyMaintenanceWindow": {
    "daysOfWeek": [
      {
        "days": [
          "<список_дней>"
        ],
        "startTime": {
          "hours": "<час_начала_обновления>",
          "minutes": "<минута_начала_обновления>",
          "seconds": "<секунда_начала_обновления>",
          "nanos": "<доля_секунды_начала_обновления>"
        },
        "duration": "<длительность_периода_обновления>"
      }
    ]
  }
  

  Где:

  • days — список дней, например: monday, tuesday.
  • hours — час начала обновления в формате UTC.
  • nanos — доля секунды начала обновления, в наносекундах.
  • duration — длительность периода обновления, в часах.

Для настройки развертывания группы узлов Managed Service for Kubernetes при ее обновлении добавьте блок deployPolicy:

"deployPolicy": {
  "maxUnavailable": "<количество_недоступных_узлов_при_обновлении>",
  "maxExpansion": "<расширение_размера_группы_при_обновлении>"
}

Где:

• maxUnavailable — максимальное количество недоступных узлов группы при ее обновлении.

• maxExpansion — максимальное количество узлов, на которое можно увеличить размер группы при ее обновлении.

  Важно

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

Укажите параметры автоматического обновления:

yc managed-kubernetes node-group update <идентификатор_или_имя_группы_узлов> \
...
  --version <новая_версия>

Идентификатор и имя группы узлов Managed Service for Kubernetes можно получить со списком групп в кластере.

1. Откройте актуальный конфигурационный файл с описанием группы узлов Managed Service for Kubernetes.

   О том, как создать такой файл, см. в разделе Создание группы узлов.

2. Измените версию в описании группы узлов Managed Service for Kubernetes:

   resource "yandex_kubernetes_node_group" "<имя_группы_узлов>" {
     name = <имя_группы_узлов>
     ...
     version = "<новая_версия>"
   }
   

3. Проверьте корректность конфигурационных файлов.

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

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

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

• Идентификатор группы узлов Managed Service for Kubernetes в параметре nodeGroupId. Чтобы узнать идентификатор группы узлов Managed Service for Kubernetes, получите список групп в кластере.
• Нужную версию Kubernetes в параметре version.version.
• Список изменяемых настроек в параметре updateMask.

Выполните обновление кластера Managed Service for Kubernetes:

yc managed-kubernetes cluster update <имя_или_идентификатор_кластера> \
  --latest-revision

Идентификатор и имя кластера Managed Service for Kubernetes можно получить со списком кластеров в каталоге.

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

• Идентификатор кластера Managed Service for Kubernetes в параметре clusterId. Чтобы узнать идентификатор кластера Managed Service for Kubernetes, получите список кластеров в каталоге.
• Значение true в параметре masterSpec.version.version.
• Список изменяемых настроек в параметре updateMask.

Выполните обновление группы узлов Managed Service for Kubernetes:

yc managed-kubernetes node-group update <идентификатор_или_имя_группы_узлов> \
  --latest-revision

Идентификатор и имя группы узлов Managed Service for Kubernetes можно получить со списком групп в кластере.

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

• Идентификатор группы узлов Managed Service for Kubernetes в параметре nodeGroupId. Чтобы узнать идентификатор группы узлов Managed Service for Kubernetes, получите список групп в кластере.
• Значение true в параметре version.latestRevision.
• Список изменяемых настроек в параметре updateMask.