Bewertung und Migration

In diesem Dokument wird beschrieben, wie Sie eine Bewertung Ihrer vorhandenen Cloud Foundry (CF) Foundation durchführen und die CF Foundation, Organisation, Space oder App zu Kf migrieren.

Prüfung zur Migrationseignung

Verwenden Sie den Befehl kf migrate scan-cf-cluster, um einen Bericht zu erstellen, der eine Bewertung der Migrationsbereitschaft einer CF Foundation enthält. Sie können den Bericht als Tabelle (empfohlen) oder als Textdatei formatieren.

Vorbereitung

Bewertung durchführen

  1. Validieren Sie die Foundation für das Targeting.

    cf curl /v2/info
  2. Führen Sie den Befehl aus, um eine Tabelle mit dem Bewertungsbericht zu generieren.

    kf migrate scan-cf-cluster report.xlsx
  3. Prüfen Sie die Bewertung.

    Wenn Sie die Bewertung teilen möchten, können Sie alle Informationen entfernen, die Sie nicht teilen möchten.

Migration

Führen Sie die folgenden Schritte aus, um Entitäten aus CF zu migrieren:

  1. Erstellen Sie einen Migrationsplan, der die Migration beschreibt.

  2. Bearbeiten Sie den Migrationsplan und passen Sie die Migration an.

  3. Wenden Sie den Migrationsplan an, um die Migration durchzuführen.

Diese Schritte werden in den folgenden Abschnitten näher erläutert.

Migrationsbereiche

Bei der Migration müssen Sie sich zuerst über den Umfang der Migration entscheiden. Der Bereich bestimmt die zu migrierende CF-Entität und die Berechtigungen, die Sie für die Migration benötigen:

  • Gesamte Stiftung oder Organisation: Sie benötigen auf der CF Foundation Administratorberechtigungen oder höher.

  • Einzelner Bereich oder App: Sie benötigen Space-Entwicklerberechtigungen oder höher.

Vorbereitung

Für eine Migration benötigen Sie Folgendes:

  • So erstellen Sie den Migrationsplan: Die Kf-Befehlszeile. Eine Installationsanleitung finden Sie unter Kf-Befehlszeile installieren.
  • So wenden Sie den Migrationsplan an: Ein GKE-Cluster, auf dem Kf ausgeführt wird. Weitere Informationen zur Installation finden Sie unter Kf installieren.
  • Zugriff auf einen Cluster mit einer Cloud Foundry-Installation.
  • CF-Befehlszeile, die auf die CF Foundation ausgerichtet ist.
  • Die Berechtigungen für die CF Foundation, die für den gewünschten Migrationsbereich erforderlich sind, wie oben dargestellt.

Einen Migrationsplan erstellen

Verwenden Sie den Befehl kf migrate plan, um den Migrationsplan zu erstellen.

Standardmäßig schreibt der Befehl den Migrationsplan in ein Standard-Out. In der Regel leiten Sie die Ausgabe an eine YAML-Datei weiter, sodass Sie den Plan vor der Anwendung anpassen können. Der folgende Befehl schreibt die Ausgabe beispielsweise in Standard-Out:

kf migrate plan

Leiten Sie die Ausgabe an eine YAML-Datei weiter:

kf migrate plan > plan.yaml

Wenn Sie den Befehl kf migrate plan ausführen, sollten Sie im Befehlsfenster in der Form unten eine Ausgabe mit den vom Befehl ausgeführten Schritten und etwaige Warnungen oder Migrationsprobleme sehen:

kf migrate plan > plan.yaml

    Checking CF CLI is available
    Checking CF CLI is authenticated
    ...

    WARNING: plan has issues
    Issues with domain "apps.internal" in space "kf-team-acceptance":
        E04 - internal domains are not supported

    Issues with application "spring-music" in space "kf-team-app":
        E14 - app manifest must have a single process

    Issues with service instance "logspinner-1" in space "kf-team-app":
        E10 - syslog drain configuration is not supported
    ...

So generieren Sie einen Migrationsplan:

  1. Prüfen Sie, ob Sie sich mithilfe der CF-Befehlszeile in Ihrer CF Foundation angemeldet haben.

  2. Führen Sie die Migration basierend auf dem gewünschten Migrationsbereich durch. Dabei gilt Folgendes:

    • MY_ORG gibt den Namen der Organisation an.
    • MY_SPACE gibt den Namen des Bereichs an.
    • MY_APP gibt den Namen der App an.
    1. Einen Migrationsplan für eine gesamte CF Foundation generieren.

      kf migrate plan > plan.yaml
    2. Einen Migrationsplan für eine Organisation erstellen

      kf migrate plan --cf-org MY_ORG > plan.yaml
    3. Migrationsplan für einen Bereich generieren

      kf migrate plan --cf-org MY_ORG --cf-space MY_SPACE > plan.yaml
    4. Einen Migrationsplan für eine Anwendung generieren

      kf migrate plan --cf-org MY_ORG --cf-space MY_SPACE --cf-app MY_APP > plan.yaml

Wenn nach Ausführung eines dieser Befehle der folgende Fehler angezeigt wird:

You are not authorized to perform the requested action CF-NotAuthorized 10003

Sie haben nicht die erforderlichen Berechtigungen, um die erforderlichen CAPI-Endpunkte zu lesen.

Migrationsplan bearbeiten

Prüfen und optional ändern Sie den generierten Migrationsplan, um Fehler zu beheben.

Migrationsplan anwenden

Verwenden Sie den Befehl kf migrate apply, um den Migrationsplan anzuwenden und die CF-Entität zu migrieren.

So wenden Sie eine Migration an:

  1. Achten Sie darauf, dass .kubeconfig für das Ziel Ihres Kf-Clusters festgelegt ist.

  2. Sorgen Sie dafür, dass Sie Zugriff auf einen GKE-Cluster haben, auf dem eine vollständige Kf-Installation ausgeführt wird. Sie haben also den folgenden Befehl ausgeführt, um eine Verbindung zum Cluster herzustellen:

    gcloud container clusters get-credentials CLUSTER_NAME \
       --project=CLUSTER_PROJECT_ID \
       --zone=CLUSTER_LOCATION
  3. Achten Sie darauf, dass sich in Ihrem Kf-Cluster keine Bereichsnamen befinden, die mit einem Bereich übereinstimmen, auf den im Migrationsplan verwiesen wird.

    Raumnamen haben das Format cf-org-cf-space. Wenn der Name der Organisation beispielsweise myorg und der Name des Bereichs myspace lautet, ist der Kf-Bereich myorg-myspace.

  4. Wenden Sie den Migrationsplan an.

    kf migrate apply -v --plan plan.yaml

    Das ausführliche Flag -v wird empfohlen, ist aber nicht erforderlich. Dieses Flag gibt an, dass der Befehl die Kf-Befehle ausgibt, die für die Migration verwendet wurden.