//Cloudogu EcoSystem Docs

Erste Schritte: Automatische Migration von CES-MN zu CES-MN

1. Quellinstanz einrichten

Installieren sie den Importer wie in dieser Anleitung beschrieben.

2. Zielinstanz einrichten

1. Den k8s-ecosystem Installationsleitfaden befolgen, um eine neue Multinode-CES-Instanz einzurichten. a. Die Dogus müssen in den gleichen Versionen wie auf der zu migrierenden Instanz installiert werden.
2. Mit der Instanz verbinden, indem der Kubernetes-Kontext entsprechend gesetzt wird.

3. Ein Kubernetes-Secret mit folgenden Informationen für den Importer erstellen:

   • API-Key
   • privater SSH-Schlüssel
   • Mail-Passwort (wenn benötigt)

   Das Secret mit dem folgenden kubectl-Befehl erstellen:

   kubectl -n ecosystem create secret generic ces-importer-secret \
   --from-file=privateKey=</path/to_my/Private-key> \
   --from-literal=apiKey=<my-api-key> \
   --from-literal=mailPassword=<your-mail-password>

   Wenn der Mailserver ohne Passwort zugänglich ist, genügt ein leerer String.

4. Den ces-importer durch Anwendung des folgenden YAML im Cluster installieren:

   kubectl apply --namespace=ecosystem -f - <<EOF
   apiVersion: k8s.cloudogu.com/v1
   kind: Component
   metadata:
   labels:
   app: ces
   name: ces-importer
   namespace: ecosystem
   spec:
   name: ces-importer
   namespace: k8s
   version: <neueste ces-importer Version>
   valuesYamlOverwrite: |
   config:
     api:
       host: <FQDN der Quellinstanz>
       skipTLSVerify: <true, wenn kein Zertifikat oder ein selbst-signiertes Zertifikat vorhanden>
     migration:
       regularSchedule: <Zeitpunkt der Migration(en) im CRON-Format>
       finalSchedule: <Zeitstempel für den Start der finalen Migration im RFC-3339-Format, z.B. „2025-04-03T12:34:56Z“>
     smtp:
       server: <smtp.my-mailserver.com>
       port: <der Port des Mail-Servers, z.B. 25>
       username: <der Benutzername zur Authentifizierung am Mailserver; ein leerer String wenn nicht benötigt>
       from: <Absender-Adresse>
       to:
         - <Empfänger-Adresse(n)>
   EOF

5. Überprüfen, ob die Komponente bereit ist: kubectl get component/ces-importer

3. Migration

1. Jetzt muss nur noch auf den konfigurierten Zeitpunkt in config/migration/regularSchedule gewartet werden. Dann startet der Migrations-Job automatisch und überträgt die Daten und Konfiguration Ihrer Quell- zur Zielinstanz.
2. Abschließend die migrierten Daten prüfen.