Просмотр кода страницы Настройте ЕдиныйАгент в контейнерах для мониторинга только приложений

Если у вас нет доступа к базовым хостам, вы можете развернуть ЕдиныйАгент в контейнерах для мониторинга только приложений. Выполните следующие действия, чтобы интегрировать ЕдиныйАгент в образ приложения.

== Развернуть ЕдиныйАгент ==
Требуемые версии

<code>Docker версии 17.05+</code>

1. Войдите в Docker, используя свой идентификатор среды Ключ-АСТРОМ в качестве имени пользователя.
 docker login <ADDRESS> -u <environmentID>
2. Введите свой <PAAS_TOKEN> при появлении запроса.

3. Добавьте следующие строки кода в образ приложения после последней команды <code>FROM</code>:
 COPY --from=<ADDRESS>/linux/oneagent-codemodules:<TECHNOLOGY> / /
 ENV LD_PRELOAD /opt/astromkey/oneagent/agent/lib64/liboneagentproc.so
где:

<code><ADDRESS>:</code>

* Среда АктивногоШлюза: <<code>ActiveGateaddress:9999</code>>
* SaaS: <code>saas.ruscomtech.ru</code>
* Managed: {<code>ManagedAddress</code>}

<code><TECHNOLOGY></code> — это модуль кода ЕдиногоАгента, необходимый для вашего приложения. Допустимые варианты: <code>all</code>, <code>java</code>, <code>apache</code>, <code>nginx</code>, <code>nodejs</code>, <code>dotnet</code>, <code>php</code>, <code>go</code> и <code>sdk</code>. Чтобы указать несколько модулей кода, разделите их дефисами (например, используйте <code>java-go</code>, чтобы указать <code>java</code> и <code>go</code>). Включение определенных вариантов технической поддержки вместо поддержки всех технологических параметров приводит к меньшему размеру пакета ЕдиногоАгента.

=== Что, если мой образ Docker основан на Alpine Linux? ===
Ключ-АСТРОМ ЕдиныйАгент поддерживает среды на базе Alpine Linux.

Используйте этот синтаксис:
 COPY --from=<ACTIVEGATE-ADDRESS>/linux/oneagent-codemodules-musl:<TECHNOLOGY> / /
 ENV LD_PRELOAD /opt/astromkey/oneagent/agent/lib64/liboneagentproc.so
Допустимые варианты: <code>all</code>, <code>dotnet</code>, <code>php</code>, <code>java</code>, <code>apache</code>, <code>nginx</code>, <code>nodejs</code> и <code>go</code>.

3. Сделайте build образа вашего приложения.

Создайте образ Docker из своего Dockerfile, чтобы использовать его в своей среде Kubernetes.
 docker build -t yourapp .
Вы можете контролировать свои контейнеры приложений с помощью другой среды Ключ-АСТРОМ.

Для ЕдиногоАгента версии 1.139 или выше, если у вас есть существующий образ приложения, в который вы уже добавили модули кода ЕдиногоАгента для определенной среды Ключ-АСТРОМ, вы можете получить отчет ЕдиногоАгента для другой среды Ключ-АСТРОМ без перестроения образа приложения.

Для этого вам нужно позвонить в конечную точку REST вашей второй среды Ключ-АСТРОМ. Не забудьте адаптировать соответствующие заполнители <code><environmentID></code> и <code><token></code>.
 curl "<nowiki>https://saas.ruscomtech.ru/api/v1/deployment/installer/agent/connectioninfo?Api-Token=</nowiki><token>"
В ответ вы получаете объект JSON, содержащий необходимую информацию, которую необходимо передать в виде переменной среды в контейнер приложения.

Убедитесь, что вы установили переменные среды контейнера приложения, как описано ниже:

* <code>DT_TENANT</code>: равен <code>tenantUUID</code>
* <code>DT_TENANTTOKEN</code>: равно <code>tenantToken</code>
* <code>DT_CONNECTION_POINT</code>: список <code>communicationEndpoints</code>, разделенных точкой с запятой.

4. <code>необязательно</code> Настроить сетевые зоны

Вы можете настроить сетевые зоны как переменную среды:

<code>DT_NETWORK_ZONE</code>: соответствует вашей <code>.network.zone</code>

Дополнительные сведения см. в разделе «Сетевые зоны».

4. <code>опционально</code> Настроить прокси-адрес

Если вы запускаете среду с прокси-сервером, вам необходимо установить переменную среды DT_PROXY в контейнере приложения, чтобы передать учетные данные прокси-сервера в ЕдиныйАгент.

Примечание. Для контейнеров на основе Alpine Linux может потребоваться обновить wget, поставляемый с образом Alpine, чтобы разрешить аутентификацию прокси-сервера для загрузки ЕдиногоАгента.

== Обновление ЕдиногоАгента ==
Каждый раз, когда вы хотите использовать новую версию Ключ-АСТРОМ ЕдиныйАгент, вы должны перестраивать свои локальные модули кода ЕдиногоАгента и образ приложения. Все новые модули, запущенные из этого образа приложения, будут отслеживаться с помощью последней версии ЕдиногоАгента.

Если вы указали версию установки ЕдиногоАгента по умолчанию для новых хостов и приложений с помощью параметров обновления ЕдиногоАгента, ваши приложения Kubernetes будут автоматически отслеживаться с помощью определенной версии Ключ-АСТРОМ ЕдиныйАгент по умолчанию.

== Удалить ЕдиныйАгент ==
Чтобы удалить ЕдиныйАгент из мониторинга только приложений, просто удалите ссылки из своего приложения или образа Docker, а затем повторно разверните приложение.

=== Внедрение во время сборки контейнера ===

==== Многоэтапные сборки образов Docker ====
1. Удалите две строки кода из образа приложения.
 COPY --from=<ACTIVEGATE-ADDRESS>/linux/oneagent-codemodules:<TECHNOLOGY> / /
 ENV LD_PRELOAD /opt/astromkey/oneagent/agent/lib64/liboneagentproc.so
2. Восстановите образ приложения.
 docker build -t yourapp .

==== Классическая интеграция ====
1. Удалите следующие строки кода из вашего Dockerfile.
 ARG DT_API_URL="<nowiki>https://saas.ruscomtech.ru/api</nowiki>"
 ARG DT_API_TOKEN="<token>"
 ARG DT_ONEAGENT_OPTIONS="flavor=default&include=<technology1>&include=<technology2>"
 ENV DT_HOME="/opt/astromkey/oneagent"
 RUN mkdir -p "$DT_HOME" && \
     wget -O "$DT_HOME/oneagent.zip" "$DT_API_URL/v1/deployment/installer/agent/unix/paas/latest?Api-Token=$DT_API_TOKEN&$DT_ONEAGENT_OPTIONS" && \
     unzip -d "$DT_HOME" "$DT_HOME/oneagent.zip" && \
     rm "$DT_HOME/oneagent.zip"
 ENTRYPOINT [ "/opt/astromkey/oneagent/astromkey-agent64.sh" ]
 CMD [ "executable", "param1", "param2" ] # the command of your application, for example, Java