Подключение своих кластеров Kubernetes/OpenShift к АппОптима

Установка и настройка / АппОптима разворачивается на / Контейнерных платформах / Kubernetes/OpenShift / Включение API мониторинга / Подключение своих кластеров Kubernetes/OpenShift к АппОптима

АппОптима версии 1.232+

Предпосылки

1. Настройте оператора АппОптима .
2. Установите значения АктивныйШлюз конфигурационного файла AppOptimaKube в соответствии со списком параметров . Примечание: Чтобы включить АктивныйШлюз, в АктивныйШлюзразделе добавьте routingи/или kubernetes-monitoringв capabilities. Пример:

АктивныйШлюз:

capabilities:

- routing

- kubernetes-monitoring

...

Подключите свои кластеры и включите мониторинг

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

• Подключите контейнерный АктивныйШлюз к локальной конечной точке API Kubernetes.
• Подключите контейнерный АктивныйШлюз к общедоступному URL-адресу API Kubernetes.

Инструкции для обоих вариантов см. ниже.

Подключитесь к локальной конечной точке API Kubernetes.

АктивныйШлюз версии 1.229+

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

• АппОптима Operator версии 0.4+: АппОптима Operator автоматически обрабатывает подключение к локальной конечной точке API Kubernetes.
• Версии АппОптима Operator до v0.4.0: необходимо настроить подключение вручную .

Подробнее об обоих методах см. ниже.

Оператор АппОптима версии 0.4.0+

Автоматическое подключение к локальной конечной точке API Kubernetes

1. Помимо предварительных условий, необходимых для настройки мониторинга , обязательно включите разрешения на чтение объектов , чтение параметров и запись параметров (API v2) для вашего токена API.
2. Убедитесь, что эта kubernetes-monitoringвозможность включена в вашем пользовательском ресурсе AppOptimaKube.
3. Добавьте следующую аннотацию (см. пример ниже).

<apiVersion: ruscomtech.ru/v1beta1
kind: AppOptimaKube
metadata:
  name: AppOptimakube
  namespace: AppOptima
  annotations:
    feature.ruscomtech.ru/automatic-kubernetes-api-monitoring: "true"
spec:
  ...
   АктивныйШлюз:
     capabilities:
       - kubernetes-monitoring

Примечание. После добавления этой аннотации имя кластера, отображаемое в АппОптима, будет таким же, как и у пользовательского ресурса AppOptimaKube, для которого настроена аннотация. Начиная с АппОптима Operator версии 0.7.0, вы можете изменить имя кластера, отображаемое в АппОптима, также добавив feature.ruscomtech.ru/automatic-kubernetes-api-monitoring-cluster-name: "custom-cluster-name"аннотацию. Обязательно замените "custom-cluster-name"на желаемое имя кластера.

Пример:

<apiVersion: ruscomtech.ru/v1beta1
kind: AppOptimaKube
metadata:
  name: AppOptimaKube
  namespace: AppOptima
  annotations:
    feature.ruscomtech.ru/automatic-kubernetes-api-monitoring: "true"
    feature.ruscomtech.ru/automatic-kubernetes-api-monitoring-cluster-name: "custom-cluster-name"
spec:
  ...
  АктивныйШлюз:
    capabilities:
      - kubernetes-monitoring

1. Примените свою конфигурацию.

Примечание. Чтобы отключить конфигурацию, удалите аннотацию.

Подключитесь к общедоступному API Kubernetes.

Чтобы подключиться к общедоступному API Kubernetes

1. Получите URL-адрес API Kubernetes.

kubectl config view --minify -o jsonpath='{.clusters[0].cluster.server}'

Примечание. Если enableIstioв пользовательском ресурсе AppOptimaKubetrue установлено значение , используйте приведенную ниже команду, чтобы получить URL-адрес Kubernetes API:

kubectl -n default get svc/kubernetes -o jsonpath='https://{.spec.clusterIP}'

2. Получите жетон носителя.

kubectl get secret $(kubectl get sa AppOptima-kubernetes-monitoring -o jsonpath='{.secrets[0].name}' -n AppOptima) -o jsonpath='{.data.token}' -n AppOptima | base64 --decode

Специальные инструкции для дистрибутивов Rancher для получения URL-адреса API и токена носителя

Для дистрибутивов Rancher Kubernetes необходимо использовать токен носителя и URL -адрес API сервера Rancher , поскольку этот сервер управляет и защищает трафик к серверу API Kubernetes. Следуйте инструкциям ниже.

• Получите URL API Kubernetes .

kubectl config view --minify -o jsonpath='{.clusters[0].cluster.server

• Настройте пользователя.

В веб-интерфейсе Rancher либо создайте нового пользователя, либо используйте существующего пользователя для связи с токеном. Мы рекомендуем создать нового пользователя.

• Установите разрешения.

Убедитесь, что у пользователя есть права владельца или пользователя для кластера, который вы хотите отслеживать.

Рекомендуется: выберите «Пользовательские разрешения» и обязательно выберите эти две роли: «Просмотр всех проектов» и «Просмотр узлов » .

• Создайте ключ API.

Перейдите в API & Keys и создайте ключ либо для вашей конкретной учетной записи (введите имя кластера), либо для всех кластеров (введите No scope ). Из соображений безопасности мы рекомендуем выбрать первый вариант.

Примечание. Вновь созданные ключи отображают четыре поля. Обязательно используйте содержимое поля Bearer token для настройки подключения к API Kubernetes, описанного в следующем разделе.

3. В меню АппОптима перейдите в Kubernetes и выберите Подключиться вручную .

4. На странице настроек мониторинга кластера Kubernetes укажите Имя , URL-адрес API Kubernetes и токен носителя для кластера Kubernetes.

Примечание. Для дистрибутивов Rancher вам потребуется токен носителя, созданный в веб-интерфейсе Rancher, как описано в разделе Специальные инструкции для дистрибутивов Rancher, чтобы получить URL-адрес API и токен носителя выше.

5. Выберите Сохранить изменения .

Поведение АктивныйШлюз при обновлении

АктивныйШлюз автоматически обновляется при перезапуске модуля, когда доступна новая версия, если только версия образа не указана в файле cr.yaml.