Изменение группы узлов Managed Service for Kubernetes

Получите подробную информацию о команде для изменения группы узлов Managed Service for Kubernetes:

yc managed-kubernetes node-group update --help

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

• --new-name — изменить имя.

• --description — изменить описание.

• --service-account-id, --service-account-name — изменить сервисный аккаунт для ресурсов.

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

• --version — изменить версию Kubernetes.

• --network-interface — настройки сети:

  • security-group-ids — идентификаторы групп безопасности.
  • subnets — имена подсетей, в которых будут размещаться узлы.
  • ipv4-address — способ назначения IPv4-адреса.
  • ipv6-address — способ назначения IPv6-адреса.

  Параметры ipv4-address и ipv6-address отвечают за способ назначения IP-адреса:

  • auto — узлу будет присвоен только внутренний IP-адрес.
  • nat — узлу будут присвоены публичный и внутренний IP-адреса.

• --network-acceleration-type — выбор типа ускорения сети:

  • standard — без ускорения.

  • software-accelerated — программно-ускоренная сеть.

    Важно

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

• --node-name — изменить шаблон имени узлов Managed Service for Kubernetes. Для уникальности имени шаблон должен содержать хотя бы одну переменную:

  • {instance_group.id} — идентификатор группы ВМ.
  • {instance.index} — уникальный номер ВМ в группе. Возможные значения: от 1 до N, где N — количество ВМ в группе.
  • {instance.index_in_zone} — номер ВМ в зоне. Уникален в рамках зоны для конкретной группы ВМ.
  • {instance.short_id} — идентификатор ВМ, уникальный в рамках группы. Состоит из четырех букв.
  • {instance.zone_id}— идентификатор зоны.

  Например, prod-{instance.short_id}-{instance_group.id}. Если имя не задано, используется значение по умолчанию: {instance_group.id}-{instance.short_id}.

• --template-labels — изменить облачные метки группы узлов в формате <имя_метки>=<значение_метки>. Можно указать несколько меток через запятую.

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

• Настройки масштабирования:

  • --fixed-size — изменить фиксированное количество узлов в группе узлов Managed Service for Kubernetes.

  • --auto-scale — изменить настройки автоматического масштабирования кластера Managed Service for Kubernetes:

    • min — минимальное количество узлов в группе.
    • max — максимальное количество узлов в группе.
    • initial — начальное количество узлов в группе.

  Тип масштабирования нельзя изменить.

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

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

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

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

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

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

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

   • Чтобы изменить настройки масштабирования, измените в блоке scale_policy:

     • Для фиксированного масштабирования — значение параметра fixed_scale.size.

     • Для автоматического масштабирования — параметры в блоке auto_scale:

       • min — минимальное количество узлов в группе.
       • max — максимальное количество узлов в группе.
       • initial — начальное количество узлов в группе.

     Тип масштабирования нельзя изменить.

   • Чтобы изменить облачные метки группы узлов, добавьте блок instance_template.labels:

     resource "yandex_kubernetes_node_group" "<имя_группы_узлов>" {
       ...
       instance_template {
         ...
         labels {
           "<имя_метки>"="<значение_метки>"
         }
       }
     }
     

   • Чтобы изменить шаблон имени узлов Managed Service for Kubernetes, измените параметр instance_template.name. Для уникальности имени шаблон должен содержать хотя бы одну переменную:

     • {instance_group.id} — идентификатор группы ВМ.
     • {instance.index} — уникальный номер ВМ в группе. Возможные значения: от 1 до N, где N — количество ВМ в группе.
     • {instance.index_in_zone} — номер ВМ в зоне. Уникален в рамках зоны для конкретной группы ВМ.
     • {instance.short_id} — идентификатор ВМ, уникальный в рамках группы. Состоит из четырех букв.
     • {instance.zone_id}— идентификатор зоны.

     Например, prod-{instance.short_id}-{instance_group.id}. Если имя не задано, используется значение по умолчанию: {instance_group.id}-{instance.short_id}.

   • Чтобы изменить DNS-записи:

     1. Создайте внутреннюю или публичную зону DNS.

     2. Добавьте блок instance_template.network_interface.ipv4_dns_records:

        resource "yandex_kubernetes_node_group" "<имя_группы_узлов>" {
          ...
          instance_template {
            network_interface {
              ipv4_dns_records {
                fqdn        = "<FQDN_записи_DNS>"
                dns_zone_id = "<идентификатор_зоны_DNS>"
                ttl         = "<TTL_записи_DNS_в_секундах>"
                ptr         = "<создание_PTR_записи>"
              }
            }
          }
        }
        

        Где ptr — создание PTR записи: true или false.

        В FQDN записи DNS можно использовать шаблон с переменными:

        • {instance_group.id} — идентификатор группы ВМ.
        • {instance.index} — уникальный номер ВМ в группе. Возможные значения: от 1 до N, где N — количество ВМ в группе.
        • {instance.index_in_zone} — номер ВМ в зоне. Уникален в рамках зоны для конкретной группы ВМ.
        • {instance.short_id} — идентификатор ВМ, уникальный в рамках группы. Состоит из четырех букв.
        • {instance.zone_id}— идентификатор зоны.

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

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

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

Чтобы изменить параметры группы узлов Managed Service for Kubernetes, воспользуйтесь методом update для ресурса NodeGroup.

Чтобы изменить облачные метки группы узлов, передайте значения меток в параметре nodeTemplate.labels.

Чтобы изменить шаблон имени узлов Managed Service for Kubernetes, передайте его в параметре nodeTemplate.name. Для уникальности имени шаблон должен содержать хотя бы одну переменную:

• {instance_group.id} — идентификатор группы ВМ.
• {instance.index} — уникальный номер ВМ в группе. Возможные значения: от 1 до N, где N — количество ВМ в группе.
• {instance.index_in_zone} — номер ВМ в зоне. Уникален в рамках зоны для конкретной группы ВМ.
• {instance.short_id} — идентификатор ВМ, уникальный в рамках группы. Состоит из четырех букв.
• {instance.zone_id}— идентификатор зоны.

Например, prod-{instance.short_id}-{instance_group.id}. Если имя не задано, используется значение по умолчанию: {instance_group.id}-{instance.short_id}.

Чтобы изменить DNS-записи, передайте их настройки в параметре nodeTemplate.v4AddressSpec.dnsRecordSpecs. В FQDN записи DNS можно использовать шаблон с переменными для имени узлов nodeTemplate.name.

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

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

Для включения доступа к узлам Managed Service for Kubernetes из интернета:

1. Получите подробную информацию о команде для изменения группы узлов Managed Service for Kubernetes:

   yc managed-kubernetes node-group update --help
   

2. Выполните команду изменения группы узлов, передав ей флаг --network-interface:

   yc managed-kubernetes node-group update <идентификатор_или_имя_группы_узлов> \
   ...
     --network-interface security-group-ids=[<идентификаторы_групп_безопасности>],ipv4-address=nat
   

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

Воспользуйтесь методом update для ресурса NodeGroup.

Чтобы назначить taint-политику на группу узлов, воспользуйтесь методом update для ресурса NodeGroup и передайте в запросе:

• Taint-политики в параметре nodeTaints.
• Обновляемый параметр nodeTaints в параметре updateMask.

Чтобы снять taint-политику с группы узлов, воспользуйтесь методом update для ресурса NodeGroup и передайте в запросе:

• Новый набор taint-политик в параметре nodeTaints. Если вы хотите снять все политики, передайте в запросе "nodeTaints": [].
• Обновляемый параметр nodeTaints в параметре updateMask.

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

Добавьте облачную метку группе узлов Managed Service for Kubernetes:

yc managed-kubernetes node-group add-labels my-node-group --labels new_label=test_label

Результат:

done (28s)
id: catpl8c44kii********
cluster_id: catcsqidoos7********
...

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

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

2. Добавьте в описание группы узлов Managed Service for Kubernetes параметр labels:

   resource "yandex_kubernetes_node_group" "<имя_группы_узлов>" {
     cluster_id = yandex_kubernetes_cluster.<имя_кластера>.id
     ...
     labels = {
       "<облачная_метка>" = "<значение>"
     }
     ...
   }
   

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

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

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

Измените облачную метку группы узлов Managed Service for Kubernetes:

yc managed-kubernetes node-group update my-node-group --labels test_label=my_ng_label

Результат:

done (3s)
id: catpl8c44kii********
cluster_id: catcsqidoos7********
...

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

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

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

   resource "yandex_kubernetes_node_group" "<имя_группы_узлов>" {
     cluster_id = yandex_kubernetes_cluster.<имя_кластера>.id
     ...
     labels = {
       "<облачная_метка>" = "<значение>"
       ...
     }
     ...
   }
   

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

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

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

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

yc managed-kubernetes node-group remove-labels my-node-group --labels test_label

Результат:

done (2s)
id: catpl8c44kii********
cluster_id: catcsqidoos7********
...

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

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

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

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

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

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

1. Чтобы включить или выключить доступ к узлам через OS Login, измените значение метаданных с ключом enable-oslogin:

   • true — доступ включен;
   • false — доступ выключен.

   Важно

   Если доступ через OS Login включен, то доступ по SSH-ключам будет невозможен.

   Настройка и использование OS Login подробно рассмотрены в разделе Подключение к узлу через OS Login.

2. Чтобы включить доступ к узлам с использованием SSH-ключей:

   1. Убедитесь, что доступ через OS Login выключен.
   2. Убедитесь, что в метаданных группы узлов есть хотя бы один SSH-ключ. При необходимости добавьте или удалите ключи, изменив метаданные с ключом ssh-keys.

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

3. Чтобы выключить доступ к узлам с использованием SSH-ключей, выполните одно из действий:

   • Включите доступ через OS Login.

   • Измените метаданные, удалив метаданные с ключом ssh-keys.

     После удаления этих метаданных вы не сможете подключиться к узлам кластера Managed Service for Kubernetes, пока не добавите один или несколько SSH-ключей.

1. Чтобы включить или выключить доступ к узлам через OS Login, измените значение метаданных с ключом enable-oslogin:

   • true — доступ включен;
   • false — доступ выключен.

   Важно

   Если доступ через OS Login включен, то доступ по SSH-ключам будет невозможен.

   Настройка и использование OS Login подробно рассмотрены в разделе Подключение к узлу через OS Login.

2. Чтобы включить доступ к узлам с использованием SSH-ключей:

   1. Убедитесь, что доступ через OS Login выключен.
   2. Убедитесь, что в метаданных группы узлов есть хотя бы один SSH-ключ. При необходимости добавьте или удалите ключи, изменив метаданные с ключом ssh-keys.

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

3. Чтобы выключить доступ к узлам с использованием SSH-ключей, выполните одно из действий:

   • Включите доступ через OS Login.

   • Измените метаданные, удалив метаданные с ключом ssh-keys.

     После удаления этих метаданных вы не сможете подключиться к узлам кластера Managed Service for Kubernetes, пока не добавите один или несколько SSH-ключей.

1. Чтобы включить или выключить доступ к узлам через OS Login, измените значение метаданных с ключом enable-oslogin:

   • true — доступ включен;
   • false — доступ выключен.

   Важно

   Если доступ через OS Login включен, то доступ по SSH-ключам будет невозможен.

   Настройка и использование OS Login подробно рассмотрены в разделе Подключение к узлу через OS Login.

2. Чтобы включить доступ к узлам с использованием SSH-ключей:

   1. Убедитесь, что доступ через OS Login выключен.
   2. Убедитесь, что в метаданных группы узлов есть хотя бы один SSH-ключ. При необходимости добавьте или удалите ключи, изменив метаданные с ключом ssh-keys.

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

3. Чтобы выключить доступ к узлам с использованием SSH-ключей, выполните одно из действий:

   • Включите доступ через OS Login.

   • Измените метаданные, удалив метаданные с ключом ssh-keys.

     После удаления этих метаданных вы не сможете подключиться к узлам кластера Managed Service for Kubernetes, пока не добавите один или несколько SSH-ключей.

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

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

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

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

      yc managed-kubernetes node-group add-metadata --help
      

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

      yc managed-kubernetes node-group add-metadata \
        --name <имя_группы_узлов> \
        --metadata <ключ>=<значение>
      

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

      Перечень существующих метаданных можно запросить вместе с подробной информацией о группе узлов.

      Совет

      Используйте параметр --metadata-from-file вместо --metadata, если нужно получить значение из файла:

      --metadata-from-file <ключ>=<путь_к_файлу_со_значением>
      

      Значение ключа будет считано из файла. Это может быть полезно, если значение слишком длинное, чтобы передавать его в явном виде, или содержит переносы строк и другие спецсимволы.

2. Чтобы удалить метаданные с определенным ключом:

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

      yc managed-kubernetes node-group remove-metadata --help
      

   2. Удалите существующие метаданные:

      yc managed-kubernetes node-group remove-metadata \
        --name <имя_группы_узлов> \
        --keys <ключ>
      

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

      Перечень существующих метаданных можно запросить вместе с подробной информацией о группе узлов.

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

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

2. Чтобы добавить, изменить или удалить метаданные с определенным ключом, измените перечень ключей и значений в параметре instance_template.metadata. Если такого параметра нет — добавьте его.

   resource "yandex_kubernetes_node_group" "<имя_группы_узлов>" {
     cluster_id = yandex_kubernetes_cluster.<имя_кластера>.id
     ...
     instance_template {
       metadata = {
         "<ключ>" = "<значение>"
         ...
       }
       ...
     }
     ...
   }
   

   Совет

   Используйте функцию file(), если нужно получить значение из файла:

   "<ключ>" = file("<путь_к_файлу_со_значением>")
   

   Значение ключа будет считано из файла. Это может быть полезно, если значение слишком длинное, чтобы передавать его в явном виде, или содержит переносы строк и другие спецсимволы.

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

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

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

1. Получите все существующие метаданные для группы узлов, воспользовавшись методом REST API get для ресурса NodeGroup, и передайте в запросе идентификатор группы узлов в параметре nodeGroupId.

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

   Метаданные будут перечислены в виде пар ключ=значение в поле nodeTemplate.metadata ответа.

2. Воспользуйтесь методом REST API update для ресурса NodeGroup и передайте в запросе:

   • Идентификатор группы узлов в параметре nodeGroupId.

   • Параметр updateMask со значением nodeTemplate.metadata.

     Важно

     Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре updateMask (одной строкой через запятую).

   • Параметр nodeTemplate.metadata, в котором перечислены метаданные группы узлов.

     Внесите нужные изменения в перечень метаданных, который был получен на предыдущем шаге: добавьте, измените или удалите пары ключ=значение. Затем передайте обновленный перечень в параметре nodeTemplate.metadata.

     Внимание

     Метаданные, не перечисленные в параметре nodeTemplate.metadata, будут удалены.