IKuznetsov в 14:34, 15 ноября 2025

2025-11-15T14:34:34Z

← Предыдущая версия		Версия от 14:34, 15 ноября 2025
Строка 59:		Строка 59:

	{\| class="wikitable"		{\| class="wikitable"
	\|<nowiki>> helm list -n ~~dynatrace~~ -o json \| jq -r '.[].app_version'`</nowiki>		\|<nowiki>> helm list -n astromkey -o json \| jq -r '.[].app_version'`</nowiki>

	1.6.2		1.6.2
Строка 69:		Строка 69:

	{\| class="wikitable"		{\| class="wikitable"
	\|> kubectl get deployment ~~dynatrace~~-operator -n ~~dynatrace~~ -o jsonpath='{.metadata.labels.app\.kubernetes\.io/version}'		\|> kubectl get deployment astromkey-operator -n astromkey -o jsonpath='{.metadata.labels.app\.kubernetes\.io/version}'

	1.6.2		1.6.2

IKuznetsov: Новая страница: «== Обзор == В зависимости от версии Ключ-АСТРОМ '''Operator''' поддерживаются разные версии `api...»`


2025-11-15T14:34:26Z
Новая страница: «== Обзор == В зависимости от версии Ключ-АСТРОМ '''Operator''' поддерживаются разные версии <code>api...»
Новая страница
== Обзор ==

В зависимости от версии Ключ-АСТРОМ '''Operator''' поддерживаются разные версии <code>apiVersion</code>. На этой странице собраны руководства по переходу <code>DynaKubeapiVersion</code> для каждой версии '''Operator'''.



=== Обзор версии API ===

{| class="wikitable"

!Версия API DynaKube

!Введено

!Устарело

!Удалено

|-

|v1beta5

|1.6.0

|

|

|-

|v1beta4

|1.5.0

|

|

|-

|v1beta3

|1.3.0

|1.6.0

|

|-

|v1beta2

|1.2.0

|1.6.0

|1.7.0

|-

|v1beta1

|0.3.0

|1.6.0

|1.7.0

|}



== Стратегия преобразования ==



=== Автоматическое преобразование ===

Каждая версия Ключ-АСТРОМ '''Operator''' преобразует развернутые <code>DynaKubes</code> с более старой версией '''API''' в последнюю версию <code>apiVersion</code>, поддерживаемую этой версией Ключ-АСТРОМ '''Operator'''.



* Пример: Ключ-АСТРОМ '''Operator''' '''v1.6.x''' всегда будет конвертировать <code>DynaKubes</code> в <code>v1beta5</code>.



Таким образом, при проверке <code>kubectl</code> используемого вами кода <code>apiVersion</code> вы всегда увидите последнюю версию <code>apiVersion</code>, поддерживаемую данной версией Ключ-АСТРОМ '''Operator'''. Вы можете воспользоваться этим механизмом вместо ручного преобразования.



# Загрузите конвертированную версию '''DynaKube'''. Следующая команда вернет вам '''DynaKube''', конвертированный в последнюю поддерживаемую версию <code>apiVersion</code>:

#* <code>kubectl get dynakubes -n <namespace> <dynakube-name> -o yaml</code>

# Очистите загруженный '''DynaKube''', оставив только эти разделы.

#* соответствующие части раздела <code>.metadata</code>

#* полный раздел <code>.spec</code>



=== Ручное преобразование ===

1. Сначала проверьте текущую версию '''Operator'''. Если вы не знаете, какая версия у вас установлена, вот несколько способов узнать её.



<u>Использование '''Helm''':</u>



* Используйте команду <code>helm list</code>, в поле будет указана версия <code>APP VERSION</code> установленного Ключ-АСТРОМ '''Operator'''.

** Пример:



{| class="wikitable"

|<nowiki>> helm list -n dynatrace -o json | jq -r '.[].app_version'`</nowiki>



1.6.2

|}

<u>С использованием</u> <code>kubectl</code><u>:</u>



* На развертывании Ключ-АСТРОМ '''Operator''' имеется метка <code>app.kubernetes.io/version</code>, на которой указана используемая версия.

** Пример:



{| class="wikitable"

|> kubectl get deployment dynatrace-operator -n dynatrace -o jsonpath='{.metadata.labels.app\.kubernetes\.io/version}'



1.6.2

|}

2. Затем проверьте используемые  данные <code>apiVersion</code> и следуйте руководству по переходу <code>DynaKube</code>, приведенному выше.



== Процесс устаревания ==

Ключ-АСТРОМ '''Operator''' следует структурированному процессу устаревания, чтобы обеспечить плавный переход между версиями '''API DynaKube''' и предоставить достаточно времени для перехода.



=== Фаза 1: Объявление об устаревании ===

<u>Уведомление о предварительном прекращении поддержки:</u> в примечаниях к выпуску размещено объявление о том, что по крайней мере один выпуск Ключ-АСТРОМ '''Operator''' должен состояться до того, как прекращение поддержки вступит в силу.



<u>Маркировка устаревших версий:</u> версия '''API''' официально отмечена как устаревшая в последующем выпуске, но остается полностью функциональной и поддерживаемой.



=== Этап 2: Поддерживаемый период устаревания ===

<u>Продолжение поддержки:</u> устаревшая версия '''API''' продолжает полностью поддерживаться и функционировать в течение периода устаревания.



<u>Поощрение миграции:</u> Пользователям настоятельно рекомендуется перейти на новую версию '''API''' в течение этого времени, используя предоставленные руководства по миграции.



<u>Автоматическое преобразование:</u> Ключ-АСТРОМ '''Operator''' автоматически преобразует устаревшие версии '''API''' в последнюю поддерживаемую версию в фоновом режиме, обеспечивая совместимость.



=== Фаза 3: Подготовка к удалению ===

<u>Обслуживание API отключено:</u> после окончания периода поддержки устаревшая версия '''API''' помечается как <code>served: false</code> в определении пользовательских ресурсов ('''CRD''').



<u>Режим «только преобразование»:</u> схема версии API сохраняется в '''CRD''' только для целей преобразования, что позволяет читать и преобразовывать существующие ресурсы.



<u>Крайний срок миграции:</u> пользователи должны завершить миграцию на новую версию '''API''' до начала этого этапа, чтобы обеспечить дальнейшую функциональность своих ресурсов '''DynaKube'''.



=== Фаза 4: Полное удаление ===

<u>Удаление схемы:</u> устаревшая версия схемы '''API''' будет полностью удалена из '''CRD''' в будущем выпуске '''Operator'''.



<u>Нет поддержки преобразования:</u> после удаления поддержка преобразования и совместимости для устаревшей версии '''API''' недоступна.



=== Рекомендации по срокам переноса ===



* <u>Немедленное действие:</u> планируйте миграцию сразу после объявления об отмене поддержки.

* <u>Период тестирования:</u> используйте период устаревания для тестирования миграции в непроизводственных средах.

* <u>Миграция производства:</u> завершите миграцию производства задолго до отключения обслуживания '''API'''.

* <u>Проверка:</u> убедитесь, что все ресурсы '''DynaKube''' используют текущую версию '''API''' после миграции.

Руководства по переходу для DynaKube apiVersions - История изменений

IKuznetsov в 14:34, 15 ноября 2025

IKuznetsov: Новая страница: «== Обзор == В зависимости от версии Ключ-АСТРОМ '''Operator''' поддерживаются разные версии api...»

IKuznetsov: Новая страница: «== Обзор == В зависимости от версии Ключ-АСТРОМ '''Operator''' поддерживаются разные версии `api...»`