Начало работы с наблюдаемостью Kubernetes

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

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

Прежде чем начать

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

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

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

• Необходимо разрешить выход для модулей Ключ-АСТРОМ (по умолчанию: пространство имен Ключ-АСТРОМ) на URL-адрес вашей среды Ключ-АСТРОМ.
  • Для Ключ-АСТРОМ Managed вы можете дополнительно использовать URL-адрес кластера АктивногоШлюза.
• Для OpenShift Dedicated вам потребуется роль администратора кластера.
• Установка Helm Используйте Helm версии 3.

Поддерживаемые версии

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

Helm

Ключ-АСТРОМ Operator версии 0.8.0+

Kubernetes

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

Следующая команда работает как для установок по умолчанию, так и для установок с использованием реестра OCI.

helm install astromkey-operator oci://public.ecr.aws/astromkey/astromkey-operator \    --set "csidriver.enabled=false" \    --create-namespace \    --namespace astromkey \    --atomic \

Установка с дополнительной настройкой Helm chart

Отредактируйте пример из GitHub, а затем запустите команду установки, передав файл YAML в качестве аргумента: values.yaml

helm install astromkey-operator oci://public.ecr.aws/astromkey/astromkey-operator \    --create-namespace \    --namespace astromkey \    --atomic \    -f values.yaml

Если в installCRD установлено значение false, вам необходимо вручную создать определение пользовательского ресурса перед началом установки Helm:

kubectl apply -f https://github.com/astromkey/astromkey-operator/releases/download/v1.7.0/astromkey-operator-crd.yaml

Создание секрета для токена доступа

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

kubectl -n astromkey create secret generic dynakube --from-literal="apiToken=<OPERATOR_TOKEN>"

Применение пользовательского ресурса DynaKube

Загрузите пример пользовательского ресурса DynaKube для наблюдения за Kubernetes с GitHub. Кроме того, вы можете ознакомиться с доступными параметрами или руководствами и адаптировать пользовательский ресурс DynaKube в соответствии со своими требованиями.

Выполните команду ниже, чтобы применить пользовательский ресурс DynaKube, заменив <your-DynaKube-CR> фактическим именем файла вашего пользовательского ресурса DynaKube. Веб-хук проверки предоставит полезные сообщения об ошибках в случае возникновения проблем.

kubectl apply -f <your-DynaKube-CR>.yaml

Проверить развертывание

необязательно

Убедитесь, что DynaKube запущен, а все модули в пространстве имен Ключ-АСТРОМ запущены и готовы.

> kubectl get dynakube -n astromkey NAME         APIURL                                             STATUS     AGE dynakube     https://{your-domain}/e/{your-environment-id}/api  Running    45s

В этой конфигурации DynaKube вы должны увидеть следующие модули:

> kubectl get pods -n astromkey NAME                                  READY   STATUS    RESTARTS        AGE dynakube-activegate-0                 1/1     Running   0               50s 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

OpenShift

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

Следующая команда работает как для установок по умолчанию, так и для установок с использованием реестра OCI.

helm install astromkey-operator oci://public.ecr.aws/astromkey/astromkey-operator \    --set "csidriver.enabled=false" \    --create-namespace \    --namespace astromkey \    --atomic \

Установка с дополнительной настройкой Helm chart

Отредактируйте пример из GitHub, а затем запустите команду установки, передав файл YAML в качестве аргумента: values.yaml

helm install astromkey-operator oci://public.ecr.aws/astromkey/astromkey-operator \    --create-namespace \    --namespace astromkey \    --atomic \    -f values.yaml

Если в installCRD установлено значение false, вам необходимо вручную создать определение пользовательского ресурса перед началом установки Helm:

oc apply -f https://github.com/astromkey/astromkey-operator/releases/download/v1.7.0/astromkey-operator-crd.yaml

Создание секрета для токена доступа

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

oc -n astromkey create secret generic dynakube --from-literal="apiToken=<OPERATOR_TOKEN>"

Применение пользовательского ресурса DynaKube

Загрузите пример пользовательского ресурса DynaKube для наблюдения за Kubernetes с GitHub. Кроме того, вы можете ознакомиться с доступными параметрами или руководствами и адаптировать пользовательский ресурс DynaKube в соответствии со своими требованиями.

Выполните команду ниже, чтобы применить пользовательский ресурс DynaKube, заменив <your-DynaKube-CR> фактическим именем файла вашего пользовательского ресурса DynaKube. Веб-хук проверки предоставит полезные сообщения об ошибках в случае возникновения проблем.

oc apply -f <your-DynaKube-CR>.yaml

Проверить развертывание

необязательно

Убедитесь, что DynaKube запущен, а все модули в пространстве имен Ключ-АСТРОМ запущены и готовы.

> oc get dynakube -n astromkey NAME         APIURL                                             STATUS     AGE dynakube     https://{your-domain}/e/{your-environment-id}/api  Running    45s

В этой конфигурации DynaKube вы должны увидеть следующие модули:

> oc get pods -n astromkey NAME                                  READY   STATUS    RESTARTS        AGE dynakube-activegate-0                 1/1     Running   0               50s 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

Manifest

Kubernetes

Создание пространства имен `astromkey`

kubectl create namespace astromkey

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

kubectl apply -f https://github.com/astromkey/astromkey-operator/releases/download/v1.7.0/kubernetes.yaml

Выполните следующую команду, чтобы увидеть, когда компоненты Ключ-АСТРОМ Operator завершат инициализацию:

kubectl -n astromkey wait pod --for=condition=ready --selector=app.kubernetes.io/name=astromkey-operator,app.kubernetes.io/component=webhook --timeout=300s

Создание секрета для токена доступа

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

kubectl -n astromkey create secret generic dynakube --from-literal="apiToken=<OPERATOR_TOKEN>"

Применение пользовательского ресурса DynaKube

Загрузите пример пользовательского ресурса DynaKube для наблюдения за Kubernetes с GitHub. Кроме того, вы можете ознакомиться с доступными параметрами или руководствами и адаптировать пользовательский ресурс DynaKube в соответствии со своими требованиями.

Выполните команду ниже, чтобы применить пользовательский ресурс DynaKube, заменив <your-DynaKube-CR> фактическим именем файла вашего пользовательского ресурса DynaKube. Веб-хук проверки предоставит полезные сообщения об ошибках в случае возникновения проблем.

kubectl apply -f <your-DynaKube-CR>.yaml

Проверка развертывания

необязательно

Убедитесь, что DynaKube запущен, а все модули в пространстве имен Ключ-АСТРОМ запущены и готовы.

> kubectl get dynakube -n astromkey NAME         APIURL                                             STATUS     AGE dynakube     https://{your-domain}/e/{your-environment-id}/api  Running    45s

В этой конфигурации DynaKube вы должны увидеть следующие модули:

> kubectl get pods -n astromkey NAME                                  READY   STATUS    RESTARTS        AGE dynakube-activegate-0                 1/1     Running   0               50s 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

OpenShift

Создание пространства имен `astromkey`

oc adm new-project --node-selector="" astromkey

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

oc apply -f https://github.com/astromkey/astromkey-operator/releases/download/v1.7.0/openshift.yaml

Выполните следующую команду, чтобы увидеть, когда компоненты Ключ-АСТРОМ Operator завершат инициализацию:

oc -n astromkey wait pod --for=condition=ready --selector=app.kubernetes.io/name=astromkey-operator,app.kubernetes.io/component=webhook --timeout=300s

Создание секрета для токена доступа

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

oc -n astromkey create secret generic dynakube --from-literal="apiToken=<OPERATOR_TOKEN>"

Применение пользовательского ресурса DynaKube

Загрузите пример пользовательского ресурса DynaKube для наблюдения за Kubernetes с GitHub. Кроме того, вы можете ознакомиться с доступными параметрами или руководствами и адаптировать пользовательский ресурс DynaKube в соответствии со своими требованиями.

Выполните команду ниже, чтобы применить пользовательский ресурс DynaKube, заменив <your-DynaKube-CR> фактическим именем файла вашего пользовательского ресурса DynaKube. Веб-хук проверки предоставит полезные сообщения об ошибках в случае возникновения проблем.

oc apply -f <your-DynaKube-CR>.yaml

Проверка развертывания

необязательно

Убедитесь, что DynaKube запущен, а все модули в пространстве имен Ключ-АСТРОМ запущены и готовы.

> oc get dynakube -n astromkey NAME         APIURL                                             STATUS     AGE dynakube     https://{your-domain}/e/{your-environment-id}/api  Running    45s

В этой конфигурации DynaKube вы должны увидеть следующие модули:

> oc get pods -n astromkey NAME                                  READY   STATUS    RESTARTS        AGE dynakube-activegate-0                 1/1     Running   0               50s 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