Изменение группы узлов 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-адреса.

  Публичные IP-адреса необходимы для подключения к узлам из интернета и для подключения узлов к внешним ресурсам, например реестрам Docker-образов (Container Registry, Cloud Registry или Docker Hub), а также бакетам Object Storage.

  Чтобы обеспечить узлам доступ в интернет, назначьте им публичный IP-адрес и настройте группу безопасности. Также в качестве альтернативы публичным IP-адресам можно создать и настроить в подсети узлов NAT-шлюз или NAT-инстанс.

  Если вы назначили узлам кластера публичные IP-адреса и затем настроили NAT-шлюз или NAT-инстанс, доступ в интернет через публичные адреса пропадет. Подробнее читайте в документации Yandex Virtual Private Cloud.

• --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:

   • создание и изменение — 60 минут;
   • удаление — 20 минут.

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

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

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

   resource "yandex_kubernetes_node_group" "<имя_группы_узлов>" {
     ...
     timeouts {
       create = "1h30m"
       update = "1h30m"
       delete = "60m"
     }
   }
   

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

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

Чтобы изменить облачные метки группы узлов, передайте значения меток в параметре 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. Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

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

   yc managed-kubernetes node-group update --help
   

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

   yc managed-kubernetes node-group update \
     --name <имя_группы_узлов> \
     --max-expansion <предел_расширения_группы_узлов> \
     --max-unavailable <предел_недоступных_узлов>
   

   Где:

   • --max-expansion — максимальное количество узлов, на которое можно расширить группу при ее изменении или обновлении. Значение по умолчанию — 3.
   • --max-unavailable — максимальное количество узлов, которые могут быть недоступны в ходе изменения или обновления группы. Значение по умолчанию — 0.

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

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

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

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

2. Укажите значения параметров в блоке deploy_policy. Если такого блока нет — добавьте его.

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

   Где:

   • max_expansion — максимальное количество узлов, на которое можно расширить группу при ее изменении или обновлении. Значение по умолчанию — 3.
   • max_unavailable — максимальное количество узлов, которые могут быть недоступны в ходе изменения или обновления группы. Значение по умолчанию — 0.

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

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

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

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

Воспользуйтесь методом REST API update для ресурса NodeGroup или вызовом gRPC API NodeGroupService/Update.

Передайте в запросе:

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

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

• Параметр updateMask со значением deployPolicy.maxExpansion,deployPolicy.maxUnavailable.

  Важно

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

• Параметр deployPolicy.maxExpansion — максимальное количество узлов, на которое можно расширить группу при ее изменении или обновлении. Значение по умолчанию — 3.
• Параметр deployPolicy.maxUnavailable — максимальное количество узлов, которые могут быть недоступны в ходе изменения или обновления группы. Значение по умолчанию — 0.

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

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

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

Для назначения узлам Managed Service for Kubernetes случайных публичных IP-адресов из пула адресов Yandex Cloud:

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 можно получить со списком групп узлов в каталоге.

Чтобы назначить узлам случайные публичные IP-адреса из пула адресов Yandex Cloud:

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

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

2. В описание группы узлов добавьте параметр instance_template.network_interface.nat со значением true:

   resource "yandex_kubernetes_node_group" "<имя_группы_узлов>" {
     ...
     instance_template {
       ...
       network_interface {
         nat = true
       }
     }
   }
   

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

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

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

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

   • создание и изменение — 60 минут;
   • удаление — 20 минут.

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

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

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

   resource "yandex_kubernetes_node_group" "<имя_группы_узлов>" {
     ...
     timeouts {
       create = "1h30m"
       update = "1h30m"
       delete = "60m"
     }
   }
   

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

Воспользуйтесь методом REST API update для ресурса NodeGroup или вызовом gRPC API NodeGroupService/Update и передайте в запросе:

• Значение nodeTemplate.networkInterfaceSpecs.primaryV4AddressSpec.oneToOneNatSpec.ipVersion в параметре updateMask.

  Важно

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

• Значение IPV4 в параметре nodeTemplate.networkInterfaceSpecs.primaryV4AddressSpec.oneToOneNatSpec.ipVersion.

Если у вас еще нет интерфейса командной строки 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:

   • создание и изменение — 60 минут;
   • удаление — 20 минут.

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

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

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

   resource "yandex_kubernetes_node_group" "<имя_группы_узлов>" {
     ...
     timeouts {
       create = "1h30m"
       update = "1h30m"
       delete = "60m"
     }
   }
   

Подробнее в документации провайдера 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:

   • создание и изменение — 60 минут;
   • удаление — 20 минут.

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

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

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

   resource "yandex_kubernetes_node_group" "<имя_группы_узлов>" {
     ...
     timeouts {
       create = "1h30m"
       update = "1h30m"
       delete = "60m"
     }
   }
   

Подробнее в документации провайдера 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 ограничивает время на выполнение операций с группами узлов кластера Managed Service for Kubernetes:

   • создание и изменение — 60 минут;
   • удаление — 20 минут.

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

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

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

   resource "yandex_kubernetes_node_group" "<имя_группы_узлов>" {
     ...
     timeouts {
       create = "1h30m"
       update = "1h30m"
       delete = "60m"
     }
   }
   

Подробнее в документации провайдера 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 ограничивает время на выполнение операций с группами узлов кластера Managed Service for Kubernetes:

   • создание и изменение — 60 минут;
   • удаление — 20 минут.

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

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

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

   resource "yandex_kubernetes_node_group" "<имя_группы_узлов>" {
     ...
     timeouts {
       create = "1h30m"
       update = "1h30m"
       delete = "60m"
     }
   }
   

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

1. Получите все существующие метаданные для группы узлов одним из способов:

   • Воспользуйтесь методом REST API get для ресурса NodeGroup.
   • Используйте вызов gRPC API NodeGroupService/Get.

   Передайте в запросе идентификатор группы узлов в параметре nodeGroupId. Идентификатор можно запросить со списком групп узлов в каталоге.

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

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

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

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

     Важно

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

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

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

     Внимание

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