DE 

//Cloudogu EcoSystem Docs

  1. docs.cloudogu.com
  2. Benutzerhandbuch
  3. Automatische Migration
  4. Anleitungen
  5. E-Mail mit Migrationsergebnissen
Getting Started
Benutzerhandbuch
Entwicklerdokumentation

E-Mail mit Migrationsergebnissen

Nachdem eine Migration durchgeführt wurde, können bestimmte Nutzer per E-Mail über das Ergebnis der Migration informiert werden. Dies gilt sowohl für Delta-Migrationen als auch für die finale Migration. In den E-Mails sind der aktuelle Status der Migration sowie etwaige Fehler aufgeführt. Ferner enthält jede E-Mail das Log der aktuell durchgeführten Migration als Anhang.

Voraussetzungen

Während der Migration können keine E-Mails über das Cloudogu EcoSystem versendet werden, da das dafür notwendige Postfix-Dogu nicht verfügbar ist. Aus diesem Grund muss ein externer SMTP-Server für den Mailversand bereitgestellt und entsprechend konfiguriert werden.

Konfiguration

Ist ein Mailversand der Migrationsergebnisse gewünscht, muss dies in der Custom-Resource der CES-Komponente ("Component-CR") des CES-Importer auf der Zielinstanz konfiguriert werden:

  • Editieren Sie die "Component-CR" des CES-Importers:

    kubectl edit component ces-importer -n ecosystem

  • Nehmen Sie im Feld valuesYamlOverwrite die Konfiguration unter dem Pfad config/smtp vor:

    apiVersion: k8s.cloudogu.com/v1
kind: Component
metadata:
  name: ces-importer
  namespace: ecosystem
spec:
  name: ces-importer
  namespace: k8s
  version: 1.0.0
  valuesYamlOverwrite: |
    config:
      smtp:
        server: smtp.mailserver.com
        port: 25
        # Optional
        username:
        secretName: "ces-importer-secret"
        secretDataKey: "mailPassword"
        from: importer@cloudogu.com
        to:
          - recipient1@cloudogu.com
          - recipient2@cloudogu.com
  • Speichern Sie die Änderungen an der Component-CR

  • Starten Sie den CES-Importer neu:

    kubectl rollout restart deployment/ces-importer -n ecosystem

Ist eine Authentifizierung gegenüber dem SMTP-Server notwendig, ist darauf zu achten, dass der username sowie ein Passwort gesetzt sind. Das Passwort wird dabei nicht als Klartext in der obigen Konfiguration gesetzt, sondern muss in einem Kubernetes-Secret hinterlegt werden. Über den Parameter secretName und dem dazugehörigen secretDataKey wird das Passwort in der Konfiguration referenziert.

Im Feld from kann der Absender der E-Mail konfiguriert werden. Sollte es sich bei dem SMTP-Server, um einen Relais-Server handeln, taucht der Absender als solcher in der E-Mail auf. Andernfalls enthält die E-Mail den Nutzer des SMTP-Server als Absender in dessen Auftrag die E-Mail versendet wurde. Die E-Mail wird an alle Adressen gesendet, die im Feld to definiert sind.