Red Hat SummitThis documentation is for a release that is no longer maintained
See documentation for the latest supported version 3 or the latest supported version 4.11.3. Hooks für die Migration
Sie können einem einzelnen Migrationsplan bis zu vier Hooks für die Migration hinzufügen, wobei jeder Hook in einer anderen Phase der Migration ausgeführt wird. Hooks für die Migration übernehmen Aufgaben wie die Anpassung der Anwendungsruhezeit, die manuelle Migration nicht unterstützter Datentypen und die Aktualisierung von Anwendungen nach der Migration.
Ein Hook für die Migration wird auf einem Quell- oder Ziel-Cluster bei einem der folgenden Migrationsschritte ausgeführt:
-
PreBackup: Bevor die Ressourcen auf dem Quell-Cluster gesichert werden. -
PostBackup: Nachdem die Ressourcen auf dem Quell-Cluster gesichert wurden. -
PreRestore: Bevor die Ressourcen auf dem Ziel-Cluster wiederhergestellt werden. -
PostRestore: Nachdem die Ressourcen auf dem Ziel-Cluster wiederhergestellt wurden.
Sie können einen Hook erstellen, indem Sie ein Ansible-Playbook erstellen, das mit dem standardmäßigen Ansible-Image oder mit einem benutzerdefinierten Hook-Container ausgeführt wird.
Ansible-Playbook
Das Ansible-Playbook wird in einen Hook-Container als Config-Map eingebunden. Der Hook-Container wird als Auftrag ausgeführt und verwendet den Cluster, den Service Account und den Namespace, die in der Custom Resource MigPlan angegeben sind. Der Auftrag wird so lange ausgeführt, bis er die Standardgrenze von 6 Wiederholungen erreicht oder erfolgreich abgeschlossen wird. Dies gilt auch dann, wenn der ursprüngliche Pod gestoppt oder beendet wird.
Das standardmäßige Ansible-Laufzeit-Image ist registry.redhat.io/rhmtc/openshift-migration-hook-runner-rhel7:1.6. Dieses Image basiert auf dem Ansible-Runner-Image und enthält python-openshift für Ansible-Kubernetes-Ressourcen und eine aktualisierte oc-Binärdatei.
Kundenspezifischer Hook-Container
Sie können einen eigenen Hook-Container anstelle des standardmäßigen Ansible-Image verwenden.
11.3.1. Schreiben eines Ansible-Playbooks für einen Hook für die Migration
Sie können ein Ansible-Playbook schreiben, das als Hook für die Migration dient. Der Hook wird einem Migrationsplan über die MTC-Webkonsole oder durch Angabe von Werten für die spec.hooks-Parameter im Manifest der Custom Resource (CR) MigPlan hinzugefügt.
Das Ansible-Playbook wird als Config-Map in einen Hook-Container eingebunden. Der Hook-Container wird als Auftrag ausgeführt und verwendet den Cluster, den Service Account und den Namespace, die in der CR MigPlan angegeben sind. Der Hook-Container verwendet ein bestimmtes Service Account-Token, sodass die Aufgaben keine Authentifizierung erfordern, bevor sie im Cluster ausgeführt werden.
11.3.1.1. Ansible-Module
Sie können das Ansible-Modul shell verwenden, um oc-Befehle auszuführen.
Beispiel für ein shell-Modul
- hosts: localhost
gather_facts: false
tasks:
- name: get pod name
shell: oc get po --all-namespaces
- hosts: localhost
gather_facts: false
tasks:
- name: get pod name
shell: oc get po --all-namespaces
Sie können kubernetes.core-Module wie z. B. k8s_info verwenden, um mit Kubernetes-Ressourcen zu interagieren.
Beispiel für ein k8s_facts-Modul
- hosts: localhost
gather_facts: false
tasks:
- name: Get pod
k8s_info:
kind: pods
api: v1
namespace: openshift-migration
name: "{{ lookup( 'env', 'HOSTNAME') }}"
register: pods
- name: Print pod name
debug:
msg: "{{ pods.resources[0].metadata.name }}"
- hosts: localhost
gather_facts: false
tasks:
- name: Get pod
k8s_info:
kind: pods
api: v1
namespace: openshift-migration
name: "{{ lookup( 'env', 'HOSTNAME') }}"
register: pods
- name: Print pod name
debug:
msg: "{{ pods.resources[0].metadata.name }}"
Sie können das Modul fail verwenden, um einen Exit-Status ungleich 0 in Fällen zu erzeugen, in denen dieser Status normalerweise erzeugt werden würde. Dies würde die Erkennung eines erfolgreichen oder fehlerhaften Hook sicherstellen. Hooks werden als Aufträge ausgeführt und der Erfolg oder Misserfolg eines Hook basiert auf dem Exit-Status des Auftragscontainers.
Beispiel für ein fail-Modul
- hosts: localhost
gather_facts: false
tasks:
- name: Set a boolean
set_fact:
do_fail: true
- name: "fail"
fail:
msg: "Cause a failure"
when: do_fail
- hosts: localhost
gather_facts: false
tasks:
- name: Set a boolean
set_fact:
do_fail: true
- name: "fail"
fail:
msg: "Cause a failure"
when: do_fail11.3.1.2. Umgebungsvariablen
Der CR-Name MigPlan und die Namespaces für die Migration werden als Umgebungsvariablen an den Hook-Container übergeben. Der Zugriff auf diese Variablen erfolgt über das Plugin lookup.
Beispiel für Umgebungsvariablen
- hosts: localhost
gather_facts: false
tasks:
- set_fact:
namespaces: "{{ (lookup( 'env', 'migration_namespaces')).split(',') }}"
- debug:
msg: "{{ item }}"
with_items: "{{ namespaces }}"
- debug:
msg: "{{ lookup( 'env', 'migplan_name') }}"
- hosts: localhost
gather_facts: false
tasks:
- set_fact:
namespaces: "{{ (lookup( 'env', 'migration_namespaces')).split(',') }}"
- debug:
msg: "{{ item }}"
with_items: "{{ namespaces }}"
- debug:
msg: "{{ lookup( 'env', 'migplan_name') }}"
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}