Установка агентов с помощью пакета Helm Chart

03 марта 2026

ID 303393

До установки агентов требуется создать группу агентов.

Чтобы установить агентов с помощью пакета Helm Chart:

  1. С помощью Kaspersky Container Security OpenAPI скачайте конфигурационный файл values.yaml с помощью следующей команды:

    curl -X 'GET' \

    '{{kcs_domain}}/api/v1/integrations/agent-group/{{agentGroupId}}/values' \

    -H 'accept: application/x-yaml' \

    -H 'Tron-Token: {{token}}' -o values-agents.yaml

    где

    • {{agentGroupId}} – уникальный идентификатор (англ. UUID), который решение присваивает группе агентов при ее создании;
    • {{token}} – токен API, который можно посмотреть в профиле пользователя.

    После загрузки файла у вас будет 2 конфигурационных файла: values.yaml из комплекта поставки и values-agents.yaml, скачанный с помощью Kaspersky Container Security OpenAPI.

  2. При необходимости измените имя конфигурационного файла values.yaml в составе пакета Helm Chart из комплекта поставки на values-kcs.yaml. Такое имя файла указывает на то, что в нем содержатся данные для установки Kaspersky Container Security

    Мы не рекомендуем заменять конфигурационный файл values.yaml в составе пакета Helm Chart из комплекта поставки. Это может привести к потере данных для установки Kaspersky Container Security.

  3. Установите конфигурационный файл values-agents.yaml с помощью следующей команды:

    helm install kcs-agents . \

    --create-namespace \

    --namespace kcs-agents \

    --values values-agents.yaml \

    --set ...

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

  • Если агенты устанавливаются в кластер, в котором развернуто решение, то пространство имен агентов должно отличаться от пространства имен Kaspersky Container Security. По умолчанию пространство имен Kaspersky Container Security – kcs.
  • В конфигурационный файл для установки агентов (values-agents.yaml) не переносятся секреты, которые вы могли указать при создании группы агентов. Например, не переносятся значения следующих переменных:
    • объекты pullSecret для скачивания образов;
    • данные для авторизации в SIEM-системе в SIEM_CREDENTIALS;
    • данные прокси-сервера антивирусных баз в MALWARE_DB_PROXY_URL.

    Если значения таких переменных нужны, необходимо указать их еще раз вручную или задать с помощью команды --set при установке с помощью пакета Helm Chart из комплекта поставки.

Начиная с версии Kaspersky Container Security 2.3, при установке с помощью пакета Helm Chart компонент kube-agent не может создавать CRD на уровне кластера. Права на создание CRD должны быть у учетной записи пользователя, с которой устанавливаются агенты с помощью конфигурационного файла values-agents.yaml в пакете Helm Chart.

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

  • UPDATE_SOURCE – веб-адрес источника обновлений баз данных сетевой репутации. Значение этого параметра можно не указывать, если для актуализации баз данных используются сервера "Лаборатории Касперского".

    Если в качестве источника обновлений используется файл-сервер обновлений для закрытых контуров (kcs-updates), необходимо указать значение переменной UPDATE_SOURCE. Если этого не сделать, решение будет запрашивать обновления с серверов "Лаборатории Касперского".

  • UPDATE_PROXY – прокси-сервер внешних баз данных сетевой репутации или файл-сервера обновлений для закрытых контуров (kcs-updates).

Перед обновлением агентов Kaspersky Container Security до версии 2.3.х необходимо сначала удалить установленных агентов с помощью инструкции для установки агентов предыдущей версии или команды kubectl delete -f <файл> -n <пространство имен>. После этого требуется применить инструкцию для установки агентов для версии Kaspersky Container Security 2.3.х.

Вам помогла эта статья?
Что нам нужно улучшить?
Спасибо за ваш отзыв, вы помогаете нам становиться лучше!
Спасибо за ваш отзыв, вы помогаете нам становиться лучше!