Migrate to Containers und Plug-ins aktualisieren

In diesem Dokument wird beschrieben, wie Sie Ihre aktuelle Installation von Migrate to Containers auf Version 1.15.0 aktualisieren und Ihre Plug-ins für Migrate to Containers auf die neueste Version aktualisieren.

In der Regel löschen Sie alle vorhandenen Migrationen, bevor Sie das Upgrade durchführen. Wenn aktuell Migrationen ausgeführt werden, warten Sie, bis diese abgeschlossen sind, und löschen Sie sie dann. Löschen Sie jedoch nicht Ihre Migrationsquellen. Die Migrationsquellen werden im Rahmen des Upgrades aktualisiert.

Upgrade mit migctl ausführen

Der Upgrade-Prozess basiert auf der Umgebung, in der Sie migctl ausführen:

Wenn Sie Google Kubernetes Engine (GKE) oder GKE Enterprise-Verarbeitungscluster in Google Cloud verwenden, führen Sie migctl in Cloud Shell aus.

In Cloud Shell wird der neueste Release von migctl automatisch installiert. Sie müssen dann nur Ihre Verarbeitungscluster aktualisieren.
Wenn Sie einen Google Distributed Cloud Virtual for Bare Metal-Verarbeitungscluster verwenden, installieren Sie migctl auf Ihrer Administrator-Workstation.

Laden Sie zuerst den neuesten Release von migctl auf Ihre lokale Administrator-Workstation herunter und installieren Sie ihn. Führen Sie danach ein Upgrade Ihrer Verarbeitungscluster durch.

Upgrade von Migrate to Containers durchführen

So aktualisieren Sie eine frühere Version von Migrate to Containers auf Version 1.15.0:

Stellen Sie eine Verbindung zu Ihrem Verarbeitungscluster her:
migctl in Google Cloud
1. Rufen Sie in der Google Cloud Console das GKE-Menü auf.
  
  Zum GKE-Menü
2. Suchen Sie in der Liste der Cluster den Cluster, den Sie als Verarbeitungscluster verwenden möchten, und klicken Sie auf die zugehörige Schaltfläche Verbinden.
3. Klicken Sie unter Befehlszeilenzugriff im Dialogfeld Mit dem Cluster verbinden auf In Cloud Shell ausführen, um den Verbindungsbefehl in Cloud Shell auszuführen.
```
gcloud container clusters get-credentials cluster-name --zone zone-name --project project-name
```
migctl in Google Distributed Cloud Virtual for Bare Metal
1. Mit dem Cluster verbinden. Weitere Informationen finden Sie unter Cluster über die Google Cloud Console verwalten.
Suchen Sie nach vorhandenen Migrationen und löschen Sie diese:
1. Aktuelle Migrationen auflisten:
```
migctl migration list

NAME                STATUS      CURRENT-OPERATION
my-migration        Completed   GenerateArtifacts
another-migration   Running     GenerateMigrationPlan
```
2. Löschen Sie alle abgeschlossenen Migrationen nacheinander mit dem folgenden Befehl:
```
migctl migration delete my-migration
```
3. Wiederholen Sie bei einer Migration, die gerade ausgeführt wird, den obigen „Schritt A“ und warten Sie, bis dieser Vorgang abgeschlossen ist. Löschen Sie sie anschließend.
  
  Hinweis: Wenn bei einer Migration Fehler auftreten, müssen Sie diese nicht löschen. Stattdessen können Sie das Upgrade durchführen, indem Sie die Option --force in den Upgrade-Befehl einfügen: migctl setup upgrade --force. Mit dieser Option wird migctl so konfiguriert, dass alle Migrationen mit dem Fehlerstatus als Teil des Upgrades neu erstellt werden, um zu sehen, ob sie abgeschlossen werden können.
Mit dem Befehl migctl version können Sie die aktuelle Version ermitteln. Beispiel:
```
migctl version
```
Liefert:
```
Migrate to Containers version: 1.10.1
```
Aktualisieren Sie den Cluster:
migctl in Google Cloud
1. Upgrade auf 1.15.0 ausführen
  1. Führen Sie in Cloud Shell den folgenden Befehl aus:
    
    migctl setup upgrade
    Hinweis: Wenn Sie das Upgrade aus irgendeinem Grund abbrechen, können Sie es anschließend mit der Tastenkombination Strg+C neu starten.
    Der Befehl bewirkt Folgendes:
    
    Die alte Version von Migrate to Containers wird deinstalliert und Version 1.15.0 wird installiert.
    
    Vorhandene Migrationsquellen auf Version 1.15.0 aktualisiert.
migctl in Google Distributed Cloud Virtual for Bare Metal
1. Stellen Sie migctl auf Ihrer Administrator-Workstation bereit:
```
wget https://modernize-release.storage.googleapis.com/v1.15.0/linux/amd64/migctl
sudo cp migctl /usr/local/bin/
sudo chmod +x /usr/local/bin/migctl
. <(migctl completion bash)
```
2. Upgrade auf 1.15.0 ausführen
  1. Führen Sie das Upgrade aus:
    
    migctl setup upgrade --gkeop
    Hinweis: Wenn Sie das Upgrade aus irgendeinem Grund abbrechen, können Sie es anschließend mit der Tastenkombination Strg+C neu starten.
    Der Befehl bewirkt Folgendes:
    
    Die alte Version von Migrate to Containers wird deinstalliert und Version 1.15.0 wird installiert.
    
    Vorhandene Migrationsquellen auf Version 1.15.0 aktualisiert.
Validieren Sie das Upgrade mit dem Befehl migctl doctor.

Bevor das Upgrade abgeschlossen ist, wird möglicherweise eine Meldung wie die folgende angezeigt. Warten Sie in diesem Fall einige Minuten, bis das Upgrade abgeschlossen ist, bevor Sie migctl doctor noch einmal ausführen.
```
migctl doctor
[✓] Deployment
  [✓] Admission Controller
  [!] Components
    Job controllers-deploy-cert is not ready
    Job controllers-upgrade is not ready
```
In der folgenden Beispielausgabe zeigt das Häkchen an, dass Migrate to Containers erfolgreich aktualisiert wurde.
```
migctl doctor
[✓] Deployment
[✓] Docker registry
[✓] Artifacts repo
[✓] Source Status
```
Wenn Sie ein Upgrade auf Version 1.6 oder höher durchführen, werden in migctl doctor jetzt die Felder Docker registry, Artifacts repo und Source Status angezeigt. Dabei gilt:
- Für Docker registry und Artifacts repo wird [✓] angezeigt, wenn Ihre Daten-Repositories richtig konfiguriert sind. Unter Daten-Repositories definieren finden Sie Informationen, wenn ein Fehler im Zusammenhang mit der Docker-Registry oder mit dem Artefakte-Repository vorhanden ist.
- Source Status zeigt [!], bis Sie Ihre erste Migrationsquelle definiert haben. Weitere Informationen finden Sie unter Weitere Migrationsquelle (Linux) hinzufügen oder weitere Migrationsquelle (Windows) hinzufügen.
Nach Abschluss des Upgrades müssen Sie Ihre Migrationen neu erstellen, um zu prüfen, ob die Migrationsquellen erfolgreich aktualisiert wurden. Weitere Informationen finden Sie unter Migration erstellen.

Migrate to Containers-Plug-ins aktualisieren

Migrate to Containers verwendet Plug-ins, um die Modernisierungslogik für verschiedene Prozesse der unterstützten Arbeitslasten zu verwalten. Wenn Sie die in der neuesten Version der Plug-ins verfügbaren Features verwenden möchten, müssen Sie die Plug-ins aktualisieren und dann eine neue Migration erstellen. Das Upgrade der Plug-ins wirkt sich nicht auf eine laufende Migration aus.

Führen Sie den folgenden Befehl aus, um den Agent auf die neueste Version zu aktualisieren:

JOB_NAME=plugins-updater-NAME
kubectl apply -f - <<EOF
apiVersion: batch/v1
kind: Job
metadata:
  name: $JOB_NAME
  namespace: v2k-system
spec:
  backoffLimit: 20
  template:
    spec:
      serviceAccountName: plugins-updater-sa
      containers:
      - name: plugins-updater
        image: us-docker.pkg.dev/migrate-modernize-public/modernize-plugins-prod/plugins-updater:latest
        imagePullPolicy: Always
      restartPolicy: OnFailure
EOF

Ersetzen Sie NAME durch einen String, der dem Jobnamen hinzugefügt werden soll.

Führen Sie den folgenden Befehl aus, um sich den Status des Upgrades anzeigen zu lassen:

kubectl get job -n v2k-system  plugins-updater-NAME

Ersetzen Sie NAME durch denselben String, den Sie Ihrem Jobnamen hinzugefügt haben.

Die Ausgabe zeigt den Status des Jobs wie unten dargestellt an:

NAME                                COMPLETIONS   DURATION   AGE
plugins-updater-upgrade             1/1           12s        37s

Wenn in der Spalte Abschlüsse 1/1 angezeigt wird, ist der Job abgeschlossen und die Plug-ins wurden aktualisiert.

Führen Sie nach dem Upgrade den folgenden Befehl aus, um den Job zu löschen:

kubectl delete  job -n v2k-system  plugins-updater-NAME