Просмотр кода страницы Обновление или удаление Ключ-АСТРОМ Operator

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

Ключ-АСТРОМ '''Operator''' управляет развертыванием и жизненным циклом всех компонентов Ключ-АСТРОМ в кластерах '''Kubernetes''' (например, ЕдинымАгентом, АктивнымШлюзом и модулей кода). Это включает в себя, в зависимости от конфигурации, автоматическое обновление этих компонентов. Сам Ключ-АСТРОМ '''Operator''' необходимо обновлять либо путём применения новых манифестов, либо с помощью '''Helm Charts'''.

Мы рекомендуем использовать актуальную версию '''Operator''' (как минимум версию n-2) и всегда использовать последнюю версию патча для этой версии '''Operator''' (например, 0.10.4 вместо 0.10.0).

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

=== Manifest ===
Для <code>classicFullStack</code>, <code>applicationMonitoring</code>, или <code>hostMonitoring</code>без драйвера CSI выполните следующую команду.
{| class="wikitable"
!Kubernetes
!OpenShift
|-
|kubectl apply -f <nowiki>https://github.com/astromkey/astromkey-operator/releases/download/v1.7.2/kubernetes.yaml</nowiki>
|oc apply -f <nowiki>https://github.com/astromkey/astromkey-operator/releases/download/v1.7.2/openshift.yaml</nowiki>
|}
Если вы используете драйвер CSI, используйте следующую команду:
{| class="wikitable"
!Kubernetes
!OpenShift
|-
|kubectl apply -f <nowiki>https://github.com/astromkey/astromkey-operator/releases/download/v1.7.2/kubernetes-csi.yaml</nowiki>
|oc apply -f <nowiki>https://github.com/astromkey/astromkey-operator/releases/download/v1.7.2/openshift-csi.yaml</nowiki>
|}

=== Helm ===
Обновите '''Helm Charts'''.
{| class="wikitable"
|helm upgrade astromkey-operator oci://public.ecr.aws/astromkey/astromkey-operator \

   --namespace astromkey \

   --atomic \

   -f values.yaml
|}
Файл <code>values.yaml</code> мог измениться в более новых версиях. Если существующие значения больше недействительны, они будут проигнорированы, поскольку для этого нет проверки.

==== Обновление из реестра OCI ====
Чтобы выполнить обновление до последней версии из реестра OCI, выполните следующую команду.
{| class="wikitable"
|helm upgrade astromkey-operator astromkey/astromkey-operator \

   --namespace astromkey \

   --atomic \

   -f values.yaml
|}
Обратите внимание, что эта команда не поддерживает реестры OCI. С OCI <code>helm repo</code> можно использовать только команды <code>helm pull</code>, <code>helm show</code>, <code>helm install</code>и <code>helm upgrade</code>.

=== Обновление старых версий Ключ-АСТРОМ Operator с помощью Helm ===
Если вы используете версию Ключ-АСТРОМ '''Operator''' более раннюю, чем '''v0.8.0''', в развертывании '''Helm''', выполните следующие шаги для перехода на последнюю версию Ключ-АСТРОМ '''Operator''' с '''Helm'''.

==== Обновите определение пользовательского ресурса ====
В зависимости от конфигурации файла <code>[https://github.com/Dynatrace/dynatrace-operator/blob/v1.3.2/config/helm/chart/default/values.yaml values.yaml]</code> выберите один из вариантов ниже.

* Если <code>installCRD</code> установлено на значение <code>true</code>, определение пользовательского ресурса будет автоматически обновляться и управляться '''Helm'''.
* Если <code>installCRD</code> установлено на значение <code>false</code>, вам необходимо вручную обновить определение пользовательского ресурса перед началом установки '''Helm''':

{| class="wikitable"
!Kubernetes
!OpenShift
|-
|kubectl apply -f <nowiki>https://github.com/astromkey/astromkey-operator/releases/download/v1.7.2/astromkey-operator-crd.yaml</nowiki>
|oc apply -f <nowiki>https://github.com/astromkey/astromkey-operator/releases/download/v1.7.2/astromkey-operator-crd.yaml</nowiki>
|}

==== Обновите Helm chart ====
Удалите раздел '''CRD''' и секреты из существующего файла values.yaml или используйте и настройте пример <code>[https://github.com/Dynatrace/dynatrace-operator/blob/v1.3.2/config/helm/chart/default/values.yaml values.yaml]</code> с GitHub. Обновите '''Helm chart''':
{| class="wikitable"
|helm upgrade astromkey-operator astromkey/astromkey-operator -f values.yaml --atomic -n astromkey
|}

== Обновление подов АктивногоШлюза ==
Обычно поды АктивногоШлюза обновляются автоматически при перезапуске пода, если доступна новая версия (если только образ не указывает конкретную версию). Однако, если вам необходимо вручную перезапустить поды АктивногоШлюза, выполните команду ниже.
{| class="wikitable"
!Kubernetes
!OpenShift
|-
|kubectl -n astromkey rollout restart statefulset/<ACTIVEGATE-STATEFULSET-NAME>
|oc -n astromkey rollout restart statefulset/<ACTIVEGATE-STATEFULSET-NAME>
|}

== Обновление токенов доступа ==
Если вам необходимо обновить токены доступа Ключ-АСТРОМ, выполните следующие действия.

=== Найдите текущие токены доступа ===
Найдите и сохраните используемые вами в настоящее время токены.

После генерации новых токенов вам необходимо удалить старые.
{| class="wikitable"
!Kubernetes
!OpenShift
|-
|<nowiki>kubectl -n astromkey get secrets <dynakube-name> -o yaml | yq '.data.apiToken' | base64 -d</nowiki>
|<nowiki>oc -n astromkey get secrets <dynakube-name> -o yaml | yq '.data.apiToken' | base64 -d</nowiki>
|}

=== Удалите свой секрет ===
Чтобы удалить секрет, выполните одну из команд ниже.

В '''Kubernetes''' использованные токены хранятся в секрете с именем <code>dynakube</code> по умолчанию. Если у пользовательского ресурса '''DynaKube''' другое имя или поле <code>tokens</code> в '''DynaKube''' задано, убедитесь, что имя нового секрета совпадает с указанным там.
{| class="wikitable"
!Kubernetes
!OpenShift
|-
|kubectl -n astromkey delete secret dynakube
|oc -n astromkey delete secret dynakube
|}

=== Создайте новые токены доступа ===
Инструкции по созданию токенов см. в разделе [[Токены доступа и разрешения]].

=== Создайте новый секрет с обновленными токенами доступа ===
Чтобы создать новый секрет с обновленными токенами, выполните одну из приведенных ниже команд, обязательно заменив заполнители новыми токенами.
{| class="wikitable"
!Kubernetes
!OpenShift
|-
|Для токена Ключ-АСТРОМ Operator:
{| class="wikitable"
|kubectl -n astromkey create secret generic dynakube --from-literal="apiToken=<OPERATOR_TOKEN>"
|}
|Для токена Ключ-АСТРОМ Operator:
{| class="wikitable"
|oc -n astromkey create secret generic dynakube --from-literal="apiToken=<OPERATOR_TOKEN>"
|}
|-
|Для токена Ключ-АСТРОМ Operator и Data Ingest:
{| class="wikitable"
|kubectl -n astromkey create secret generic dynakube --from-literal="apiToken=<OPERATOR_TOKEN>" --from-literal="dataIngestToken=<DATA-INGEST-TOKEN>"
|}
|Для токена Ключ-АСТРОМ Operator и Data Ingest:
{| class="wikitable"
|oc -n astromkey create secret generic dynakube --from-literal="apiToken=<OPERATOR_TOKEN>" --from-literal="dataIngestToken=<DATA-INGEST-TOKEN>"
|}
|}
Ключ-АСТРОМ '''Operator''' подхватывает обновлённые секреты примерно через пять минут. Удаление '''DynaKube''' и его повторное применение запускают мгновенную сверку.

=== Удалить старый токен доступа ===
После установки новых токенов удалите старые.

# В Ключ-АСТРОМ перейдите в раздел '''Токены доступа''' и найдите старый токен.
# Выберите '''Удалить'''.

== Удаление Ключ-АСТРОМ Operator ==
В следующем руководстве описаны рекомендуемые шаги для чистого удаления Ключ-АСТРОМ '''Operator'''.
{| class="wikitable"
|<u>Важно для пользователей CRI-O Runtime с classicFullStack</u>

<code>ЕдиныйАгент версии 1.279 и ниже</code>

Если вы используете '''CRI-O''' в качестве среды выполнения контейнера вашего кластера с <code>classicFullStack</code>, выполните шаги, описанные в разделе [[Переход с классического полнофункционального стека на облачный полнофункциональный стек|Переход из классического полнофункционального режима в облачный полнофункциональный режим]] в рамках процесса удаления.
|}

=== Удалить компоненты, управляемые Ключ-АСТРОМ Operator ===
Удалите пользовательские ресурсы '''DynaKube''', чтобы Ключ-АСТРОМ '''Operator''' мог полностью удалить все связанные компоненты, управляемые Ключ-АСТРОМ '''Operator''', из вашего кластера '''Kubernetes'''. Дождитесь удаления этих компонентов, чтобы убедиться в успешном завершении очистки.
{| class="wikitable"
!Kubernetes
!OpenShift
|-
|kubectl delete dynakube -n astromkey --all

kubectl -n astromkey wait pod --for=delete -l app.kubernetes.io/managed-by=astromkey-operator --timeout=300s
|oc delete dynakube -n astromkey --all

oc -n astromkey wait pod --for=delete -l app.kubernetes.io/managed-by=astromkey-operator --timeout=300s
|}


<u>Почему необходима дополнительная очистка?</u>

Большинство ресурсов, связанных с '''DynaKube''', автоматически очищаются через систему владения '''Kubernetes''': при удалении '''DynaKube''' '''Kubernetes''' автоматически удаляет все ресурсы, указывающие на <code>OwnerReference</code> DynaKube.

Однако некоторые ресурсы требуют дополнительных шагов очистки из-за ограничений '''Kubernetes''':

* '''Зависимости драйвера CSI''' : приложения, использующие драйвер '''CSI''', должны быть завершены, прежде чем драйвер '''CSI''' можно будет безопасно удалить. Это предотвращает потенциальное повреждение данных или проблемы с монтированием.
* '''Ресурсы между пространствами имён''' : '''Kubernetes''' <code>OwnerReferences</code> работает только в пределах одного пространства имён. Поскольку Ключ-АСТРОМ '''Operator''' создаёт ресурсы, например,<code>Secrets</code>  в пространствах имён вашего приложения, он должен очищать их отдельно.

=== <code>необязательно</code> Если вы использовали драйвер CSI : перезапустите контролируемые приложения. ===
Чтобы убедиться, что тома '''CSI''' правильно размонтированы и отключены от драйвера '''CSI''' перед продолжением удаления, используйте следующую команду для определения приложений, которые используют драйвер '''CSI''' и требуют перезапуска.

На выходе будет представлен список подов в формате <code>namespace pod</code> для каждого приложения, использующего драйвер '''CSI'''.
{| class="wikitable"
!Kubernetes
!OpenShift
|-
|kubectl get pods --all-namespaces -o jsonpath='{range .items[?(@.spec.volumes[*].csi.driver=="csi.oneagent.astromkey.com")]}{.metadata.namespace}{"\t"}{.metadata.name}{"\n"}{end}'
|oc get pods --all-namespaces -o jsonpath='{range .items[?(@.spec.volumes[*].csi.driver=="csi.oneagent.astromkey.com")]}{.metadata.namespace}{"\t"}{.metadata.name}{"\n"}{end}'
|}

=== Удаление Ключ-АСТРОМ Operator ===
После успешного удаления всех компонентов, управляемых Ключ-АСТРОМ '''Operator''', вы можете безопасно удалить Ключ-АСТРОМ '''Operator'''.

1. Удаление Ключ-АСТРОМ '''Operator.'''
{| class="wikitable"
!Helm
!Kubernetes
!Openshift
|-
|helm uninstall astromkey-operator -n astromkey
|
* Если драйвер CSI не был установлен (вы использовали <code>kubernetes.yaml</code> при установке):

{| class="wikitable"
|kubectl delete -f <nowiki>https://github.com/astromkey/astromkey-operator/releases/download/v1.7.2/kubernetes.yaml</nowiki>
|}

* Если был установлен драйвер CSI (вы использовали <code>kubernetes-csi.yaml</code> во время установки):

{| class="wikitable"
|kubectl delete -f <nowiki>https://github.com/astromkey/astromkey-operator/releases/download/v1.7.2/kubernetes-csi.yaml</nowiki>
|}
|
* Если драйвер CSI не был установлен (вы использовали <code>openshift.yaml</code> при установке):

{| class="wikitable"
|oc delete -f <nowiki>https://github.com/astromkey/astromkey-operator/releases/download/v1.7.2/openshift.yaml</nowiki>
|}

* Если был установлен драйвер CSI (вы использовали <code>openshift-csi.yaml</code> во время установки):

{| class="wikitable"
|oc delete -f <nowiki>https://github.com/astromkey/astromkey-operator/releases/download/v1.7.2/openshift-csi.yaml</nowiki>
|}
|}
2. Удаление пространства имен.
{| class="wikitable"
!Kubernetes
!OpenShift
|-
|kubectl delete namespace astromkey
|oc delete namespace astromkey
|}