Просмотр кода страницы Руководства по переходу для DynaKube apiVersions

== Обзор ==
В зависимости от версии Ключ-АСТРОМ '''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 astromkey -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 astromkey-operator -n astromkey -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''' после миграции.