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

IKuznetsov в 08:58, 8 января 2025

2025-01-08T08:58:40Z

← Предыдущая версия		Версия от 08:58, 8 января 2025
Строка 1:		Строка 1:
	'''''[[Установка и настройка]] / [[Установка и настройка\|АппОптима разворачивается на]] / [https://docs.expert-apm.ru/index.php/%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0_%D0%B8_%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0#:~:text=%D0%9A%D0%BE%D0%BD%D1%82%D0%B5%D0%B9%D0%BD%D0%B5%D1%80%D0%BD%D1%8B%D1%85%20%D0%BF%D0%BB%D0%B0%D1%82%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%85 Контейнерных платформах] / [[Kubernetes/OpenShift]] / [https://docs.expert-apm.ru/index.php/%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0_%D0%B8_%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0#:~:text=%D0%92%D0%BA%D0%BB%D1%8E%D1%87%D0%B5%D0%BD%D0%B8%D0%B5%20API%20%D0%BC%D0%BE%D0%BD%D0%B8%D1%82%D0%BE%D1%80%D0%B8%D0%BD%D0%B3%D0%B0 Включение API мониторинга] / ~~Запуск мониторинга~~ Kubernetes/OpenShift'''''		'''''[[Установка и настройка]] / [[Установка и настройка\|АппОптима разворачивается на]] / [https://docs.expert-apm.ru/index.php/%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0_%D0%B8_%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0#:~:text=%D0%9A%D0%BE%D0%BD%D1%82%D0%B5%D0%B9%D0%BD%D0%B5%D1%80%D0%BD%D1%8B%D1%85%20%D0%BF%D0%BB%D0%B0%D1%82%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%85 Контейнерных платформах] / [[Kubernetes/OpenShift]] / [https://docs.expert-apm.ru/index.php/%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0_%D0%B8_%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0#:~:text=%D0%92%D0%BA%D0%BB%D1%8E%D1%87%D0%B5%D0%BD%D0%B8%D0%B5%20API%20%D0%BC%D0%BE%D0%BD%D0%B8%D1%82%D0%BE%D1%80%D0%B8%D0%BD%D0%B3%D0%B0 Включение API мониторинга] / Подключение своих кластеров Kubernetes/OpenShift к АппОптима'''''

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

IKuznetsov в 08:58, 8 января 2025

2025-01-08T08:58:03Z

← Предыдущая версия		Версия от 08:58, 8 января 2025
Строка 1:		Строка 1:
			'''''[[Установка и настройка]] / [[Установка и настройка\|АппОптима разворачивается на]] / [https://docs.expert-apm.ru/index.php/%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0_%D0%B8_%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0#:~:text=%D0%9A%D0%BE%D0%BD%D1%82%D0%B5%D0%B9%D0%BD%D0%B5%D1%80%D0%BD%D1%8B%D1%85%20%D0%BF%D0%BB%D0%B0%D1%82%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%85 Контейнерных платформах] / [[Kubernetes/OpenShift]] / [https://docs.expert-apm.ru/index.php/%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0_%D0%B8_%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0#:~:text=%D0%92%D0%BA%D0%BB%D1%8E%D1%87%D0%B5%D0%BD%D0%B8%D0%B5%20API%20%D0%BC%D0%BE%D0%BD%D0%B8%D1%82%D0%BE%D1%80%D0%B8%D0%BD%D0%B3%D0%B0 Включение API мониторинга] / Запуск мониторинга Kubernetes/OpenShift'''''

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

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

Строка 59:		Строка 61:
	АктивныйШлюз:		АктивныйШлюз:
	capabilities:		capabilities:
	- kubernetes-monitoring~~</code>~~		- kubernetes-monitoring
	#Примените свою конфигурацию.		#Примените свою конфигурацию.
	Примечание. Чтобы отключить конфигурацию, удалите аннотацию.		Примечание. Чтобы отключить конфигурацию, удалите аннотацию.

IKuznetsov в 18:10, 2 января 2025

2025-01-02T18:10:33Z

← Предыдущая версия		Версия от 18:10, 2 января 2025
Строка 3:		Строка 3:
	==Предпосылки==		==Предпосылки==
	#Настройте оператора АппОптима .		#Настройте оператора АппОптима .
	#Установите значения АктивныйШлюз конфигурационного файла ~~AstromkeyKube~~ в соответствии со списком параметров . Примечание: Чтобы включить АктивныйШлюз, в <code>АктивныйШлюз</code>разделе добавьте <code>routing</code>и/или <code>kubernetes-monitoring</code>в <code>capabilities</code>. Пример:		#Установите значения АктивныйШлюз конфигурационного файла AppOptimaKube в соответствии со списком параметров . Примечание: Чтобы включить АктивныйШлюз, в <code>АктивныйШлюз</code>разделе добавьте <code>routing</code>и/или <code>kubernetes-monitoring</code>в <code>capabilities</code>. Пример:
	<code>АктивныйШлюз:</code>		<code>АктивныйШлюз:</code>

Строка 30:		Строка 30:
	Автоматическое подключение к локальной конечной точке API Kubernetes		Автоматическое подключение к локальной конечной точке API Kubernetes
	#Помимо предварительных условий, необходимых для настройки мониторинга , обязательно включите разрешения на чтение объектов , чтение параметров и запись параметров (API v2) для вашего токена API.		#Помимо предварительных условий, необходимых для настройки мониторинга , обязательно включите разрешения на чтение объектов , чтение параметров и запись параметров (API v2) для вашего токена API.
	#Убедитесь, что эта <code>kubernetes-monitoring</code>возможность включена в вашем пользовательском ресурсе ~~AstromkeyKube~~.		#Убедитесь, что эта <code>kubernetes-monitoring</code>возможность включена в вашем пользовательском ресурсе AppOptimaKube.
	#Добавьте следующую аннотацию (см. пример ниже).		#Добавьте следующую аннотацию (см. пример ниже).
	<~~code>~~apiVersion: ruscomtech.ru/v1beta1		<apiVersion: ruscomtech.ru/v1beta1
	kind: ~~AstromkeyKube~~		kind: AppOptimaKube
	metadata:		metadata:
	name: ~~astromkeykube~~		name: AppOptimakube
	namespace: ~~astromkey~~		namespace: AppOptima
	annotations:		annotations:
	feature.ruscomtech.ru/automatic-kubernetes-api-monitoring: "true"		feature.ruscomtech.ru/automatic-kubernetes-api-monitoring: "true"
Строка 44:		Строка 44:
	capabilities:		capabilities:
	- kubernetes-monitoring</code>		- kubernetes-monitoring</code>
	Примечание. После добавления этой аннотации имя кластера, отображаемое в АппОптима, будет таким же, как и у пользовательского ресурса ~~AstromkeyKube~~, для которого настроена аннотация. Начиная с АппОптима Operator версии 0.7.0, вы можете изменить имя кластера, отображаемое в АппОптима, также добавив <code>feature.ruscomtech.ru/automatic-kubernetes-api-monitoring-cluster-name: "custom-cluster-name"</code>аннотацию. Обязательно замените <code>"custom-cluster-name"</code>на желаемое имя кластера.		Примечание. После добавления этой аннотации имя кластера, отображаемое в АппОптима, будет таким же, как и у пользовательского ресурса AppOptimaKube, для которого настроена аннотация. Начиная с АппОптима Operator версии 0.7.0, вы можете изменить имя кластера, отображаемое в АппОптима, также добавив <code>feature.ruscomtech.ru/automatic-kubernetes-api-monitoring-cluster-name: "custom-cluster-name"</code>аннотацию. Обязательно замените <code>"custom-cluster-name"</code>на желаемое имя кластера.

	Пример:		Пример:
	<~~code>~~apiVersion: ruscomtech.ru/v1beta1		<apiVersion: ruscomtech.ru/v1beta1
	kind: ~~AstromkeyKube~~		kind: AppOptimaKube
	metadata:		metadata:
	name: ~~AstromkeyKube~~		name: AppOptimaKube
	namespace: ~~astromkey~~		namespace: AppOptima
	annotations:		annotations:
	feature.ruscomtech.ru/automatic-kubernetes-api-monitoring: "true"		feature.ruscomtech.ru/automatic-kubernetes-api-monitoring: "true"
Строка 66:		Строка 66:
	#Получите URL-адрес API Kubernetes.		#Получите URL-адрес API Kubernetes.
	<code>kubectl config view --minify -o jsonpath='{.clusters[0].cluster.server}'</code>		<code>kubectl config view --minify -o jsonpath='{.clusters[0].cluster.server}'</code>
	Примечание. Если <code>enableIstio</code>в пользовательском ресурсе ~~AstromkeyKube~~<code>true</code> установлено значение , используйте приведенную ниже команду, чтобы получить URL-адрес Kubernetes API:		Примечание. Если <code>enableIstio</code>в пользовательском ресурсе AppOptimaKube<code>true</code> установлено значение , используйте приведенную ниже команду, чтобы получить URL-адрес Kubernetes API:

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

	2. Получите жетон носителя.		2. Получите жетон носителя.
	<code>kubectl get secret $(kubectl get sa ~~astromkey~~-kubernetes-monitoring -o jsonpath='{.secrets[0].name}' -n ~~astromkey~~) -o jsonpath='{.data.token}' -n ~~astromkey~~ \| base64 --decode</code>		<code>kubectl get secret $(kubectl get sa AppOptima-kubernetes-monitoring -o jsonpath='{.secrets[0].name}' -n AppOptima) -o jsonpath='{.data.token}' -n AppOptima \| base64 --decode</code>
	''Специальные инструкции для дистрибутивов Rancher для получения URL-адреса API и токена носителя''		''Специальные инструкции для дистрибутивов Rancher для получения URL-адреса API и токена носителя''

IKuznetsov: Новая страница: «АппОптима версии 1.232+ ==Предпосылки== #Настройте оператора АппОптима . #Установите значения АктивныйШлюз конфигурационного файла AstromkeyKube в соответствии со списком параметров . Примечание: Чтобы включить АктивныйШлюз, в `АктивныйШлюз`разделе доба...»

2024-11-11T11:43:19Z

Новая страница: «АппОптима версии 1.232+ ==Предпосылки== #Настройте оператора АппОптима . #Установите значения АктивныйШлюз конфигурационного файла AstromkeyKube в соответствии со списком параметров . Примечание: Чтобы включить АктивныйШлюз, в <code>АктивныйШлюз</code>разделе доба...»

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

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

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

<code>capabilities:</code>

<code>- routing</code>

<code>- kubernetes-monitoring</code>

<code>...</code>
==Подключите свои кластеры и включите мониторинг==
У вас есть два варианта:
*Подключите контейнерный АктивныйШлюз к локальной конечной точке 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
#Помимо предварительных условий, необходимых для настройки мониторинга , обязательно включите разрешения на чтение объектов , чтение параметров и запись параметров (API v2) для вашего токена API.
#Убедитесь, что эта <code>kubernetes-monitoring</code>возможность включена в вашем пользовательском ресурсе AstromkeyKube.
#Добавьте следующую аннотацию (см. пример ниже).
<code>apiVersion: ruscomtech.ru/v1beta1
kind: AstromkeyKube
metadata:
name: astromkeykube
namespace: astromkey
annotations:
feature.ruscomtech.ru/automatic-kubernetes-api-monitoring: "true"
spec:
...
АктивныйШлюз:
capabilities:
- kubernetes-monitoring</code>
Примечание. После добавления этой аннотации имя кластера, отображаемое в АппОптима, будет таким же, как и у пользовательского ресурса AstromkeyKube, для которого настроена аннотация. Начиная с АппОптима Operator версии 0.7.0, вы можете изменить имя кластера, отображаемое в АппОптима, также добавив <code>feature.ruscomtech.ru/automatic-kubernetes-api-monitoring-cluster-name: "custom-cluster-name"</code>аннотацию. Обязательно замените <code>"custom-cluster-name"</code>на желаемое имя кластера.

Пример:
<code>apiVersion: ruscomtech.ru/v1beta1
kind: AstromkeyKube
metadata:
name: AstromkeyKube
namespace: astromkey
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</code>
#Примените свою конфигурацию.
Примечание. Чтобы отключить конфигурацию, удалите аннотацию.
===Подключитесь к общедоступному API Kubernetes.===
Чтобы подключиться к общедоступному API Kubernetes
#Получите URL-адрес API Kubernetes.
<code>kubectl config view --minify -o jsonpath='{.clusters[0].cluster.server}'</code>
Примечание. Если <code>enableIstio</code>в пользовательском ресурсе AstromkeyKube<code>true</code> установлено значение , используйте приведенную ниже команду, чтобы получить URL-адрес Kubernetes API:

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

2. Получите жетон носителя.
<code>kubectl get secret $(kubectl get sa astromkey-kubernetes-monitoring -o jsonpath='{.secrets[0].name}' -n astromkey) -o jsonpath='{.data.token}' -n astromkey | base64 --decode</code>
''Специальные инструкции для дистрибутивов Rancher для получения URL-адреса API и токена носителя''

Для дистрибутивов Rancher Kubernetes необходимо использовать токен носителя и URL -адрес API сервера Rancher , поскольку этот сервер управляет и защищает трафик к серверу API Kubernetes. Следуйте инструкциям ниже.
*Получите URL API Kubernetes .
<code>kubectl config view --minify -o jsonpath='{.clusters[0].cluster.server</code>
*Настройте пользователя.
В веб-интерфейсе Rancher либо создайте нового пользователя, либо используйте существующего пользователя для связи с токеном. Мы рекомендуем создать нового пользователя.
*Установите разрешения.
Убедитесь, что у пользователя есть права владельца или пользователя для кластера, который вы хотите отслеживать.

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

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

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

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

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

5. Выберите Сохранить изменения .
==Поведение АктивныйШлюз при обновлении==
АктивныйШлюз автоматически обновляется при перезапуске модуля, когда доступна новая версия, если только версия образа не указана в файле <code>cr.yaml</code>.