IKuznetsov: Новая страница: «На этой странице представлены инструкции по развертыванию Ключ-АСТРОМ '''Operator''' в конфиг...»

2025-11-04T12:35:37Z

Новая страница: «На этой странице представлены инструкции по развертыванию Ключ-АСТРОМ '''Operator''' в конфиг...»

Новая страница

На этой странице представлены инструкции по развертыванию Ключ-АСТРОМ '''Operator''' в конфигурации мониторинга приложений в кластере '''Kubernetes'''.

=== Прежде чем начать ===
Перед установкой Ключ-АСТРОМ в кластер '''Kubernetes''' убедитесь, что выполнены следующие требования:

* Ваш '''CLI''' <code>kubectl</code> подключен к кластеру '''Kubernetes''', который вы хотите отслеживать.
* У вас достаточно прав на контролируемом кластере для запуска команд <code>kubectl</code> или <code>oc</code>.

=== Настройка и конфигурирование кластера ===

* Необходимо разрешить выход для модулей Ключ-АСТРОМ (по умолчанию: пространство имен Ключ-АСТРОМ) на '''URL-адрес''' вашей среды Ключ-АСТРОМ.
** Для Ключ-АСТРОМ Managed вы можете дополнительно использовать '''URL-адрес''' кластера АктивногоШлюза.
* Для '''OpenShift''' '''Dedicated''' вам потребуется [https://docs.openshift.com/dedicated/osd_cluster_admin/osd-admin-roles.html роль администратора кластера].
* <code>Установка Helm</code> Используйте [https://helm.sh/docs/intro/install/ '''Helm''' версии 3].

=== Поддерживаемые версии ===
Ознакомьтесь с поддерживаемыми версиями и дистрибутивами платформы '''Kubernetes/OpenShift'''.

{| class="wikitable"
|Настройка '''SCC''' необходима для '''OpenShift''' <code>cloudNativeFullStack</code> и <code>applicationMonitoring</code> с развертываниями драйверов '''CSI'''.
|}
{| class="wikitable"
|Сочетание <code>hostMonitoring</code> и <code>applicationMonitoring</code> в кластере '''Kubernetes''' в одной среде не поддерживается.
|}

== Helm ==
<code>Ключ-АСТРОМ Operator версии 0.8.0+</code>
{| class="wikitable"
|Новые инструкции по установке и обновлению '''Helm''' используют нашу таблицу '''Helm''', доступную в реестре '''OCI'''. Поэтому, если репозиторий Ключ-АСТРОМ уже добавлен в ваши локальные репозитории '''Helm''', его можно безопасно удалить.
{| class="wikitable"
|helm repo remove astromkey
|}
|}

Процесс установки не зависит от того, используете ли вы '''Kubernetes''' или '''OpenShift'''. Платформа определяется автоматически во время установки.

1. Установка Ключ-АСТРОМ Operator

'''У вас есть два варианта:'''

''1.1. Установка по умолчанию / установка реестра '''OCI'''''

Следующая команда работает как для установок по умолчанию, так и для установок с использованием реестра '''OCI'''.
{| class="wikitable"
|helm install astromkey-operator oci://public.ecr.aws/astromkey/astromkey-operator \

--create-namespace \

--namespace astromkey \

--atomic \
|}
''1.2. Установка с дополнительной настройкой '''Helm chart'''''

Отредактируйте пример из '''GitHub''', а затем запустите команду установки, передав файл '''YAML''' в качестве аргумента: <code>[https://github.com/Dynatrace/dynatrace-operator/blob/v1.3.2/config/helm/chart/default/values.yaml values.yaml]</code>
{| class="wikitable"
|helm install astromkey-operator oci://public.ecr.aws/astromkey/astromkey-operator \

--create-namespace \

--namespace astromkey \

--atomic \

-f values.yaml
|}
Если для <code>installCRD</code> установлено значение <code>false</code>, вам необходимо вручную создать определение пользовательского ресурса перед началом установки '''Helm''':
{| class="wikitable"
|kubectl apply -f <nowiki>https://github.com/astromkey/astromkey-operator/releases/download/v1.7.0/astromkey-operator-crd.yaml</nowiki>
|}
2. Создание секрета для токенов доступа

Создайте секрет, с названием <code>dynakube</code> для токена Ключ-АСТРОМ '''Operator''', и токен сбора данных, полученный в разделе [[Токен доступа|Требуемые токены и разрешения]].
{| class="wikitable"
|kubectl -n astromkey create secret generic dynakube --from-literal="apiToken=<OPERATOR_TOKEN>" --from-literal="dataIngestToken=<DATA_INGEST_TOKEN>"
|}
3. Применение пользовательского ресурса DynaKube

Загрузите пример пользовательского ресурса '''DynaKube''' для мониторинга приложений с '''[https://github.com/Dynatrace/dynatrace-operator/blob/v1.3.2/assets/samples/dynakube/v1beta2/applicationMonitoring.yaml GitHub]'''. Кроме того, вы можете ознакомиться с доступными параметрами или руководствами и адаптировать пользовательский ресурс '''DynaKube''' в соответствии со своими требованиями.

Выполните команду ниже, чтобы применить пользовательский ресурс '''DynaKube''', заменив <code><your-DynaKube-CR></code> фактическим именем файла вашего пользовательского ресурса '''DynaKube'''. Веб-хук проверки предоставит полезные сообщения об ошибках в случае возникновения проблем.
{| class="wikitable"
|kubectl apply -f <your-DynaKube-CR>.yaml
|}
4. <code>необязательно</code> Проверка развертывания

Убедитесь, что '''DynaKube''' запущен, а все модули в пространстве имен Ключ-АСТРОМ запущены и готовы.
{| class="wikitable"
|> kubectl get dynakube -n astromkey

NAME APIURL STATUS AGE

dynakube https://<ENVIRONMENTID>.live.astromkey.com/api Running 45s
|}
В конфигурации '''DynaKube''' по умолчанию с драйвером '''CSI''' вы должны увидеть следующие модули:
{| class="wikitable"
|> kubectl get pods -n astromkey

NAME READY STATUS RESTARTS AGE

dynakube-activegate-0 1/1 Running 0 50s

astromkey-oneagent-csi-driver-qxfwx 4/4 Running 0 2m49s

astromkey-oneagent-csi-driver-xk5c4 4/4 Running 0 2m49s

astromkey-oneagent-csi-driver-mz6ch 4/4 Running 0 2m49s

astromkey-operator-7dc8dc7d8c-wmh4z 1/1 Running 0 2m59s

astromkey-webhook-7bb6957fb5-l8fsq 1/1 Running 0 2m59s

astromkey-webhook-7bb6957fb5-rqnqk 1/1 Running 0 2m59s
|}
Драйвер '''CSI''' необязателен (см. шаг 2). Если он включен, он развёртывается как '''DaemonSet''' и создаёт модуль '''CSI'''-'''драйвера''' на каждом узле.

== Manifest ==

=== Kubernetes ===
1. Создание пространство имен <code>astromkey</code>
{| class="wikitable"
|kubectl create namespace astromkey
|}
2. Установка Ключ-АСТРОМ Operator
{| class="wikitable"
|kubectl apply -f <nowiki>https://github.com/astromkey/astromkey-operator/releases/download/v1.7.0/kubernetes-csi.yaml</nowiki>
|}
''Без драйвера '''CSI'''''
{| class="wikitable"
|kubectl apply -f <nowiki>https://github.com/astromkey/astromkey-operator/releases/download/v1.7.0/kubernetes.yaml</nowiki>
|}
Выполните следующую команду, чтобы увидеть, когда компоненты Ключ-АСТРОМ '''Operator''' завершат инициализацию:
{| class="wikitable"
|kubectl -n astromkey wait pod --for=condition=ready --selector=app.kubernetes.io/name=astromkey-operator,app.kubernetes.io/component=webhook --timeout=300s
|}
3. Создание секрета для токенов доступа

Создайте секрет, с названием <code>dynakube</code> для токена Ключ-АСТРОМ '''Operator''', и токен сбора данных, полученный в разделе [[Токен доступа|Требуемые токены и разрешения]].
{| class="wikitable"
|kubectl -n astromkey create secret generic dynakube --from-literal="apiToken=<OPERATOR_TOKEN>" --from-literal="dataIngestToken=<DATA_INGEST_TOKEN>"
|}
4. Применение пользовательского ресурса DynaKube

Загрузите пример пользовательского ресурса '''DynaKube''' для мониторинга приложений с '''[https://github.com/Dynatrace/dynatrace-operator/blob/v1.3.2/assets/samples/dynakube/v1beta2/applicationMonitoring.yaml GitHub]'''. Кроме того, вы можете ознакомиться с доступными параметрами или руководствами и адаптировать пользовательский ресурс '''DynaKube''' в соответствии со своими требованиями.

Выполните команду ниже, чтобы применить пользовательский ресурс '''DynaKube''', заменив <code><your-DynaKube-CR></code> фактическим именем файла вашего пользовательского ресурса '''DynaKube'''. Веб-хук проверки предоставит полезные сообщения об ошибках в случае возникновения проблем.
{| class="wikitable"
|kubectl apply -f <your-DynaKube-CR>.yaml
|}
5. <code>необязательно</code> Проверка развертывания

Убедитесь, что '''DynaKube''' запущен, а все модули в пространстве имен Ключ-АСТРОМ запущены и готовы.
{| class="wikitable"
|> kubectl get dynakube -n astromkey

NAME APIURL STATUS AGE

dynakube https://<ENVIRONMENTID>.live.astromkey.com/api Running 45s
|}
В конфигурации '''DynaKube''' по умолчанию с драйвером '''CSI''' вы должны увидеть следующие модули:
{| class="wikitable"
|> kubectl get pods -n astromkey

NAME READY STATUS RESTARTS AGE

dynakube-activegate-0 1/1 Running 0 50s

astromkey-oneagent-csi-driver-qxfwx 4/4 Running 0 2m49s

astromkey-oneagent-csi-driver-xk5c4 4/4 Running 0 2m49s

astromkey-oneagent-csi-driver-mz6ch 4/4 Running 0 2m49s

astromkey-operator-7dc8dc7d8c-wmh4z 1/1 Running 0 2m59s

astromkey-webhook-7bb6957fb5-l8fsq 1/1 Running 0 2m59s

astromkey-webhook-7bb6957fb5-rqnqk 1/1 Running 0 2m59s
|}
Драйвер '''CSI''' необязателен (см. шаг 2). Если он включен, он развёртывается как '''DaemonSet''' и создаёт модуль '''CSI'''-'''драйвера''' на каждом узле.

=== OpenShift ===
1. Добавление проекта <code>astromkey</code>
{| class="wikitable"
|oc adm new-project --node-selector="" astromkey
|}
2. Установка Ключ-АСТРОМ Operator
{| class="wikitable"
|oc apply -f <nowiki>https://github.com/astromkey/astromkey-operator/releases/download/v1.7.0/openshift-csi.yaml</nowiki>
|}
''Без драйвера '''CSI'''''
{| class="wikitable"
|oc apply -f <nowiki>https://github.com/astromkey/astromkey-operator/releases/download/v1.7.0/openshift.yaml</nowiki>
|}
Выполните следующую команду, чтобы увидеть, когда компоненты Ключ-АСТРОМ '''Operator''' завершат инициализацию:
{| class="wikitable"
|oc -n astromkey wait pod --for=condition=ready --selector=app.kubernetes.io/name=astromkey-operator,app.kubernetes.io/component=webhook --timeout=300s
|}
3. Создание секрета для токенов доступа

Создайте секрет, с названием <code>dynakube</code> для токена Ключ-АСТРОМ '''Operator''', и токен сбора данных, полученный в разделе [[Токен доступа|Требуемые токены и разрешения]].
{| class="wikitable"
|oc -n astromkey create secret generic dynakube --from-literal="apiToken=<OPERATOR_TOKEN>" --from-literal="dataIngestToken=<DATA_INGEST_TOKEN>"
|}
4. Применение пользовательского ресурса DynaKube

Загрузите пример пользовательского ресурса '''DynaKube''' для мониторинга приложений с '''[https://github.com/Dynatrace/dynatrace-operator/blob/v1.3.2/assets/samples/dynakube/v1beta2/applicationMonitoring.yaml GitHub]'''. Кроме того, вы можете ознакомиться с доступными параметрами или руководствами и адаптировать пользовательский ресурс '''DynaKube''' в соответствии со своими требованиями.

Выполните команду ниже, чтобы применить пользовательский ресурс '''DynaKube''', заменив <code><your-DynaKube-CR></code> фактическим именем файла вашего пользовательского ресурса '''DynaKube'''. Веб-хук проверки предоставит полезные сообщения об ошибках в случае возникновения проблем.
{| class="wikitable"
|oc apply -f <your-DynaKube-CR>.yaml
|}
5. <code>необязательно</code> Проверка развертывания

Убедитесь, что '''DynaKube''' запущен, а все модули в пространстве имен Ключ-АСТРОМ запущены и готовы.
{| class="wikitable"
|> oc get dynakube -n astromkey

NAME APIURL STATUS AGE

dynakube https://<ENVIRONMENTID>.live.astromkey.com/api Running 45s
|}
В конфигурации '''DynaKube''' по умолчанию с драйвером '''CSI''' вы должны увидеть следующие модули:
{| class="wikitable"
|> oc get pods -n astromkey

NAME READY STATUS RESTARTS AGE

dynakube-activegate-0 1/1 Running 0 50s

astromkey-oneagent-csi-driver-qxfwx 4/4 Running 0 2m49s

astromkey-oneagent-csi-driver-xk5c4 4/4 Running 0 2m49s

astromkey-oneagent-csi-driver-mz6ch 4/4 Running 0 2m49s

astromkey-operator-7dc8dc7d8c-wmh4z 1/1 Running 0 2m59s

astromkey-webhook-7bb6957fb5-l8fsq 1/1 Running 0 2m59s

astromkey-webhook-7bb6957fb5-rqnqk 1/1 Running 0 2m59s
|}
Драйвер '''CSI''' необязателен (см. шаг 2). Если он включен, он развёртывается как '''DaemonSet''' и создаёт модуль '''CSI'''-'''драйвера''' на каждом узле.

Начало работы с наблюдаемостью приложений - История изменений

IKuznetsov: Новая страница: «На этой странице представлены инструкции по развертыванию Ключ-АСТРОМ '''Operator''' в конфиг...»