Изменение кластера Managed Service for Kubernetes

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

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

Чтобы изменить кластер Managed Service for Kubernetes:

1. Посмотрите описание команды CLI для изменения кластера Managed Service for Kubernetes:

   yc managed-kubernetes cluster update --help
   

2. Выполните команду, передав список изменяемых настроек (в примере приведены не все настройки):

   yc managed-kubernetes cluster update <имя_кластера_Managed_Service_for_Kubernetes> \
     --new-name <новое_имя_кластера_Managed_Service_for_Kubernetes> \
     --description <описание_кластера_Managed_Service_for_Kubernetes> \
     --service-account-id <идентификатор_сервисного_аккаунта_для_ресурсов> \
     --service-account-name <имя_сервисного_аккаунта_для_ресурсов> \
     --node-service-account-id <идентификатор_сервисного_аккаунта_для_узлов_Kubernetes> \
     --security-group-ids <список_идентификаторов_групп_безопасности> \
     --master-logging enabled=<отправка_логов>,`
         `log-group-id=<идентификатор_лог-группы>,`
         `folder-id=<идентификатор_каталога>,`
         `kube-apiserver-enabled=<отправка_логов_kube-apiserver>,`
         `cluster-autoscaler-enabled=<отправка_логов_cluster-autoscaler>,`
         `events-enabled=<отправка_событий_Kubernetes>`
         `audit-enabled=<отправка_событий_аудита>
   

   Где:

   • --new-name — имя кластера Managed Service for Kubernetes.

   • --description — описание кластера Managed Service for Kubernetes.

   • --service-account-id, --service-account-name — сервисный аккаунт для управления кластером Managed Service for Kubernetes.

   • --node-service-account-id, --node-service-account-name — сервисный аккаунт для управления узлами Managed Service for Kubernetes.

   • --security-group-ids — группы безопасности кластера Managed Service for Kubernetes.

     Важно

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

   • --master-logging — отправка логов в Cloud Logging:

     • enabled — флаг отправки логов: true или false.
     • log-group-id — идентификатор лог-группы, в которую нужно отправлять логи.
     • folder-id — идентификатор каталога, в который нужно отправлять логи. Логи будут отправляться в лог-группу каталога по умолчанию.
     • kube-apiserver-enabled — флаг отправки логов kube-apiserver: true или false.
     • cluster-autoscaler-enabled — флаг отправки логов cluster-autoscaler: true или false.
     • events-enabled — флаг отправки событий Kubernetes: true или false.
     • audit-enabled — флаг отправки событий аудита: true или false.

     Если отправка логов включена, но не указаны ни log-group-id, ни folder-id, логи будут отправляться в каталог, где находится кластер Managed Service for Kubernetes, в лог-группу по умолчанию. Указывать одновременно log-group-id и folder-id нельзя.

   • --version — версию Kubernetes.

   • --latest-revision — получить все доступные обновления для текущей версии мастера Managed Service for Kubernetes.

   • --auto-upgrade — управлять автоматическими обновлениями кластера Managed Service for Kubernetes.

   • Управление окном обновлений:

     • --anytime-maintenance-window — обновлять в любое время.

     • --daily-maintenance-window — обновлять ежедневно в выбранное время.

     • --weekly-maintenance-window — обновлять в выбранные дни.

       Примечание

       Если вы включили обновление ежедневно или в отдельные дни, оно может начаться позже указанного времени.

Чтобы изменить кластер Managed Service for Kubernetes:

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

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

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

   Чтобы изменить настройки отправки логов в Cloud Logging, измените значения параметров в блоке master_logging. Если такого блока нет — создайте его.

   resource "yandex_kubernetes_cluster" "<имя_кластера>" {
    ...
    master {
      ...
      master_logging {
        enabled                    = <отправка_логов>
        log_group_id               = "<идентификатор_лог-группы>"
        folder_id                  = "<идентификатор_каталога>"
        kube_apiserver_enabled     = <отправка_логов_kube-apiserver>
        cluster_autoscaler_enabled = <отправка_логов_cluster-autoscaler>
        events_enabled             = <отправка_событий_Kubernetes>
        audit_enabled              = <отправка_событий_аудита>
      }
    }
   }
   

   Где:

   • enabled — флаг отправки логов: true или false.
   • log_group_id — идентификатор лог-группы, в которую нужно отправлять логи.
   • folder_id — идентификатор каталога, в который нужно отправлять логи. Логи будут отправляться в лог-группу каталога по умолчанию.
   • kube_apiserver_enabled — флаг отправки логов kube-apiserver: true или false.
   • cluster_autoscaler_enabled — флаг отправки логов cluster-autoscaler: true или false.
   • events_enabled — флаг отправки событий Kubernetes: true или false.
   • audit_enabled — флаг отправки событий аудита: true или false.

   Если отправка логов включена, но не указаны ни log_group_id, ни folder_id, логи будут отправляться в каталог, где находится кластер Managed Service for Kubernetes, в лог-группу по умолчанию. Указывать одновременно log_group_id и folder_id нельзя.

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

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

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

   Провайдер Terraform ограничивает время на создание и изменение кластера Managed Service for Kubernetes 30 минутами.

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

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

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

   resource "yandex_kubernetes_cluster" "<имя_кластера>" {
     ...
     timeouts {
       create = "60m"
       update = "60m"
     }
   }
   

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

Чтобы изменить параметры кластера Managed Service for Kubernetes, воспользуйтесь методом REST API update для ресурса Cluster или вызовом gRPC API ClusterService/Update.

Чтобы изменить настройки отправки логов в Cloud Logging, измените их значения в параметре masterSpec.masterLogging для REST API или master_spec.master_logging для gRPC API.

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

yc managed-kubernetes cluster add-labels k8s-demo --labels new_label=test_label

Результат:

done (1s)
id: abcd123ef4gh********
folder_id: l1m01nopqr1s********
...
description: My test Kubernetes cluster
labels:
  new_label: test_label
...

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

yc managed-kubernetes cluster update k8s-demo --labels test_label=my_k8s_label

Результат:

done (1s)
id: abcd123ef4gh********
folder_id: l1m01nopqr1s********
...
description: My test Kubernetes cluster
labels:
  test_label: my_k8s_label
...

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

yc managed-kubernetes cluster remove-labels k8s-demo --labels test_label

Результат:

done (1s)
id: cati493bu7ia********
folder_id: b1g88tflru0e********
created_at: "2019-11-20T11:26:36Z"
name: k8s-demo
...

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

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

Укажите нужную конфигурацию ресурсов мастера в команде изменения кластера:

yc managed-kubernetes cluster update <имя_кластера_Managed_Service_for_Kubernetes> \
  --master-scale-policy policy=auto,min-resource-preset-id=<класс_хостов_мастера>

Выбранная конфигурация задает минимальные значения ресурсов для мастера. В зависимости от нагрузки объем RAM и количество vCPU мастера будут автоматически увеличиваться.

Результат:

done (1s)
id: abcd123ef4gh********
folder_id: l1m01nopqr1s********
...
description: My test Kubernetes cluster
master:
  scale_policy:
    auto_scale:
      min_resource_preset_id: <класс_хостов_мастера>
...

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

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

2. Добавьте или измените в описании кластера Managed Service for Kubernetes конфигурацию вычислительных ресурсов мастера в блоке scale_policy:

   resource "yandex_kubernetes_cluster" "<имя_кластера>" {
    ...
    master {
      ...
      scale_policy {
        auto_scale  {
          min_resource_preset_id = "<класс_хостов_мастера>"
        }
      }
    }
   }
   

   Выбранная конфигурация задает минимальные значения ресурсов для мастера. В зависимости от нагрузки объем RAM и количество vCPU мастера будут автоматически увеличиваться.

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

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

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

   Провайдер Terraform ограничивает время на создание и изменение кластера Managed Service for Kubernetes 30 минутами.

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

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

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

   resource "yandex_kubernetes_cluster" "<имя_кластера>" {
     ...
     timeouts {
       create = "60m"
       update = "60m"
     }
   }
   

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

Чтобы изменить конфигурацию ресурсов мастера, воспользуйтесь методом REST API update для ресурса Cluster или вызовом gRPC API ClusterService/Update и передайте в запросе параметр:

• masterSpec.scalePolicy.autoScale.minResourcePresetId — для REST API.
• master_spec.scale_policy.auto_scale.min_resource_preset_id — для gRPC API.

Выбранная конфигурация задает минимальные значения ресурсов для мастера. В зависимости от нагрузки объем RAM и количество vCPU мастера будут автоматически увеличиваться.