Yandex Cloud
Поиск
Связаться с намиПодключиться
  • Документация
  • Блог
  • Все сервисы
  • Статус работы сервисов
    • Популярные
    • Инфраструктура и сеть
    • Платформа данных
    • Контейнеры
    • Инструменты разработчика
    • Бессерверные вычисления
    • Безопасность
    • Мониторинг и управление ресурсами
    • Машинное обучение
    • Бизнес-инструменты
  • Все решения
    • По отраслям
    • По типу задач
    • Экономика платформы
    • Безопасность
    • Техническая поддержка
    • Каталог партнёров
    • Обучение и сертификация
    • Облако для стартапов
    • Облако для крупного бизнеса
    • Центр технологий для общества
    • Облако для интеграторов
    • Поддержка IT-бизнеса
    • Облако для фрилансеров
    • Обучение и сертификация
    • Блог
    • Документация
    • Контент-программа
    • Мероприятия и вебинары
    • Контакты, чаты и сообщества
    • Идеи
    • Истории успеха
    • Тарифы Yandex Cloud
    • Промоакции и free tier
    • Правила тарификации
  • Документация
  • Блог
Проект Яндекса
© 2025 ООО «Яндекс.Облако»
Yandex Managed Service for Kubernetes
  • Сопоставление с другими сервисами Yandex Cloud
  • Начало работы
    • Все инструкции
    • Подключение к узлу по SSH
    • Подключение к узлу через OS Login
    • Обновление Kubernetes
    • Настройка автомасштабирования
      • Получение информации о кластере Kubernetes
      • Посмотреть операции с кластером Kubernetes
      • Создание кластера Kubernetes
      • Изменение кластера Kubernetes
      • Создание пространства имен в кластере Kubernetes
      • Мониторинг состояния кластера Kubernetes
      • Удаление кластера Kubernetes
    • Подключение внешних узлов к кластеру
  • Управление доступом
  • Правила тарификации
  • Справочник Terraform
  • Метрики Monitoring
  • Аудитные логи Audit Trails
  • История изменений
  • Обучающие курсы

В этой статье:

  • Изменить кластер Managed Service for Kubernetes
  • Управлять облачными метками кластера Managed Service for Kubernetes
  • Добавить облачную метку
  • Изменить облачную метку
  • Удалить облачную метку
  • Изменить конфигурацию ресурсов мастера
  1. Пошаговые инструкции
  2. Управление кластером Kubernetes
  3. Изменение кластера Kubernetes

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

Статья создана
Yandex Cloud
Улучшена
mmerihsesh
Обновлена 21 апреля 2025 г.
  • Изменить кластер Managed Service for Kubernetes
  • Управлять облачными метками кластера Managed Service for Kubernetes
    • Добавить облачную метку
    • Изменить облачную метку
    • Удалить облачную метку
  • Изменить конфигурацию ресурсов мастера

Для обращения к кластеру Kubernetes используйте его имя или уникальный идентификатор, которые можно узнать с помощью команды:

yc managed-kubernetes cluster list

Результат:

+----------------------+----------+---------------------+---------+---------+-------------------------+-----------------------+
|          ID          |   NAME   |     CREATED AT      | HEALTH  | STATUS  |    EXTERNAL ENDPOINT    |   INTERNAL ENDPOINT   |
+----------------------+----------+---------------------+---------+---------+-------------------------+-----------------------+
| cati493bu7ia******** | k8s-demo | 2019-11-20 11:26:36 | HEALTHY | RUNNING | https://84.201.174.147/ | https://192.168.0.27/ |
+----------------------+----------+---------------------+---------+---------+-------------------------+-----------------------+

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

Вы можете изменить следующие параметры кластера Managed Service for Kubernetes:

  • Имя.

  • Описание.

  • Сервисные аккаунты.

  • Конфигурацию ресурсов для мастера.

  • Версию Kubernetes.

  • Политику обновлений.

  • Список групп безопасности.

  • Настройки отправки логов в Yandex Cloud Logging.

    Внимание

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

  • Маску подсети узлов Managed Service for Kubernetes.

    Важно

    Если изменить маску подсети для работающего кластера Managed Service for Kubernetes, его блоки CIDR могут быть израсходованы, тогда развертывание подов на новых группах узлов станет невозможным.

Инструкция по изменению зоны доступности кластера приведена в разделе Миграция ресурсов Kubernetes в другую зону доступности.

Консоль управления
CLI
Terraform
API

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

  1. Откройте раздел Managed Service for Kubernetes в каталоге, где требуется изменить кластер Managed Service for Kubernetes.
  2. Нажмите на имя нужного кластера Managed Service for Kubernetes.
  3. Нажмите кнопку Редактировать в правом верхнем углу.
  4. В открывшемся окне измените необходимые параметры.
  5. Нажмите кнопку Сохранить.

Если у вас еще нет интерфейса командной строки 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, воспользуйтесь методом update для ресурса Cluster.

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

Управлять облачными метками кластера Managed Service for KubernetesУправлять облачными метками кластера Managed Service for Kubernetes

Вы можете выполнять следующие действия с облачными метками кластера Managed Service for Kubernetes:

  • Добавить.
  • Изменить.
  • Удалить.

Добавить облачную меткуДобавить облачную метку

Консоль управления
CLI
  1. Откройте раздел Managed Service for Kubernetes в каталоге, где расположен кластер Managed Service for Kubernetes.
  2. Нажмите на имя нужного кластера Managed Service for Kubernetes.
  3. Нажмите кнопку Редактировать в правом верхнем углу.
  4. В поле Метки нажмите Добавить метку.
  5. Введите ключ и значение и нажмите Enter.
  6. Нажмите кнопку Сохранить.

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

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
...

Изменить облачную меткуИзменить облачную метку

Консоль управления
CLI

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

  1. Откройте раздел Managed Service for Kubernetes в каталоге, где расположен кластер Managed Service for Kubernetes.
  2. Нажмите на имя нужного кластера Managed Service for Kubernetes.
  3. Нажмите кнопку Редактировать в правом верхнем углу.
  4. В поле Метки нажмите на крестик рядом с нужной меткой, чтобы удалить ее.
  5. Нажмите Добавить метку и введите ключ и/или значение новой метки.
  6. Нажмите Enter, а затем — Сохранить.

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

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

Важно

Существующий набор меток (labels) полностью перезаписывается набором, переданным в запросе.

Результат:

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

Удалить облачную меткуУдалить облачную метку

Консоль управления
CLI
  1. Откройте раздел Managed Service for Kubernetes в каталоге, где расположен кластер Managed Service for Kubernetes.
  2. Нажмите на имя нужного кластера Managed Service for Kubernetes.
  3. Нажмите кнопку Редактировать в правом верхнем углу.
  4. В поле Метки нажмите на крестик рядом с нужной меткой.
  5. Нажмите кнопку Сохранить.

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

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
...

Изменить конфигурацию ресурсов мастераИзменить конфигурацию ресурсов мастера

Консоль управления
  1. Откройте раздел Managed Service for Kubernetes в каталоге, где требуется изменить кластер Managed Service for Kubernetes.

  2. Нажмите на имя нужного кластера Managed Service for Kubernetes.

  3. Нажмите кнопку Редактировать в правом верхнем углу.

  4. В блоке Конфигурация мастера раскройте секцию Вычислительные ресурсы и выберите конфигурацию ресурсов для мастера.

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

    • платформа — Intel Cascade Lake;
    • гарантированная доля vCPU — 100%;
    • количество vCPU — 2;
    • объем RAM — 8 ГБ.

    Примечание

    Функциональность выбора и изменения конфигурации мастера находится на стадии Preview.

  5. Нажмите кнопку Сохранить.

Была ли статья полезна?

Предыдущая
Создание кластера Kubernetes
Следующая
Создание пространства имен в кластере Kubernetes
Проект Яндекса
© 2025 ООО «Яндекс.Облако»