Установка агентов с помощью пакета Helm Chart
03 марта 2026
ID 303393
До установки агентов требуется создать группу агентов.
Чтобы установить агентов с помощью пакета Helm Chart:
- С помощью 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.
- При необходимости измените имя конфигурационного файла values.yaml в составе пакета Helm Chart из комплекта поставки на values-kcs.yaml. Такое имя файла указывает на то, что в нем содержатся данные для установки Kaspersky Container Security
Мы не рекомендуем заменять конфигурационный файл values.yaml в составе пакета Helm Chart из комплекта поставки. Это может привести к потере данных для установки Kaspersky Container Security.
- Установите конфигурационный файл 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.х.