Redis- und Valkey-Arbeitslasten zu Memorystore for Valkey migrieren

In diesem Dokument wird erläutert, wie Sie die Migration Ihrer selbstverwalteten Redis- und Valkey-Arbeitslasten zu Memorystore for Valkey automatisieren. Durch die Migration zu einer vollständig verwalteten Umgebung entfällt der Aufwand für die Verwaltung Ihrer eigenen Infrastruktur. Sie müssen sich also nicht um manuelle Betriebssystem-Patches, die Replikationseinrichtung oder benutzerdefinierte Sicherungsskripts kümmern. Mit dieser Funktion können Sie das integrierte automatische Failover, die sichere VPC-Konnektivität und die Skalierung ohne Ausfallzeiten nutzen.

Wenn Sie Ihre selbstverwalteten Arbeitslasten zu Memorystore for Valkey migrieren, profitieren Sie von den folgenden Vorteilen, die den Betriebsaufwand reduzieren und Ihre Datenbankinfrastruktur modernisieren:

• Betriebsaufwand eliminieren: Übertragen Sie manuelle und zeitaufwendige Aufgaben wie Betriebssystem-Patching, Infrastrukturmonitoring, Sicherungsskripts und Replikationsverwaltung an Google Cloud. So können Sie sich auf die Anwendungsentwicklung statt auf die Datenbankwartung konzentrieren.
• Hochverfügbarkeit auf Unternehmensniveau erreichen: Profitieren Sie von einem vollständig verwalteten SLA mit 99,99 % Verfügbarkeit. Memorystore for Valkey bietet automatisches Failover und integrierte Sicherungs- und Wiederherstellungsfunktionen. So werden Ihre Anwendungen vor unerwarteten Knotenausfällen geschützt und eine schnelle Notfallwiederherstellung ermöglicht.
• Skalierung mit minimaler Ausfallzeit: Sie können Ihre Instanzen dynamisch hoch- oder herunterskalieren, um unvorhersehbare Traffic-Spitzen zu bewältigen. Sie können auf Hunderte von Knoten (bis zu 250 Shards) erweitern, ohne Ihre Anwendungen offline zu nehmen.
• Sicherheit erhöhen: Ersetzen Sie komplexe, manuell konfigurierte Netzwerkregeln durch sichere, integrierte VPC-Konnektivität und detaillierte, auf Identity and Access Management (IAM) basierende Zugriffssteuerung. So wird sichergestellt, dass Ihre Daten durch die strengen Sicherheitsgrenzen vonGoogle Cloudgeschützt sind.
• Instanzen konsolidieren und aktualisieren: Führen Sie Ihre verstreuten, isolierten und selbstverwalteten Instanzen in einer einzigen, leistungsstarken Bereitstellung in Memorystore for Valkey zusammen. Im Rahmen dieser Migration können Sie auch Ihre veralteten Redis- oder Valkey-Versionen automatisch auf die neuesten unterstützten Releases aktualisieren.
• Erweiterte Echtzeitanalysen und generative KI nutzen: Wechseln Sie zu einer optimierten Umgebung, die Latenzen im Mikrosekundenbereich für Caching und Sitzungsverwaltung bietet. Für Ihre Anwendungen mit generativer KI (GenAI) erhalten Sie sofortigen, verwalteten Zugriff auf erweiterte Funktionen wie die Vektorsuche.

Versionsunterstützung

In der Tabelle in diesem Abschnitt finden Sie die folgenden Informationen zu den selbstverwalteten Redis- und Valkey-Quellinstanzen und den Zielinstanzen in Memorystore for Valkey:

• Die Typen und Versionen der Quellinstanzen, die die Migration unterstützt
• Die Versionen der Memorystore for Valkey-Zielinstanzen, zu denen Sie Ihre Arbeitslasten migrieren können

Quellinstanztyp	Version der Quellinstanz	Zielinstanzversion
Redis	3.2.x–7.2.x	Valkey 7.2, 8.0, 9.0 und 9.1
Valkey	7.x, 8.x und 9.x	Valkey 7.2, 8.0, 9.0 und 9.1

Wichtig: Die Version der Zielinstanz muss dieselbe oder eine neuere Version als die Quellinstanz sein. Sie können für die Zielinstanz kein Downgrade auf eine frühere Version durchführen.

Hinweis

Bevor Sie mit der Migration Ihrer Arbeitslasten beginnen, müssen Sie die Voraussetzungen in diesem Abschnitt erfüllen.

Google Cloud Console, gcloud CLI und APIs verwenden

So verwenden Sie die Google Cloud Console, die Google Cloud CLI (gcloud CLI) und APIs:

1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Roles required to select or create a project

   • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
   • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

2. Verify that billing is enabled for your Google Cloud project.

3. Installieren und initialisieren Sie die Google Cloud CLI.

   Wenn Sie die gcloud CLI bereits installiert haben, prüfen Sie, ob Sie die aktuelle Version haben, indem Sie gcloud components update ausführen. Für den Zugriff auf die gcloud CLI-Befehle für Memorystore for Valkey benötigen Sie mindestens die gcloud CLI-Version 489.0.0.

4. Aktivieren Sie die Memorystore for Valkey API.
   Memorystore for Valkey API
5. Aktivieren Sie die Network Connectivity API.
   Network Connectivity API
6. Aktivieren Sie die Service Consumer Management API.
   Service Consumer Management API
7. Aktivieren Sie die Compute Engine API.
   Compute Engine API

Rollen und Berechtigungen zuweisen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle „Memorystore-Administrator“ (roles/memorystore.admin) für Ihr Google Cloud Projekt zuzuweisen, um Ihre selbstverwalteten Redis- und Valkey-Arbeitslasten zu Memorystore for Valkey zu migrieren. Weitere Informationen zu dieser Rolle finden Sie unter Vordefinierte Rollen.

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle „Compute-Netzwerkadministrator“ (roles/compute.networkAdmin) für Ihr Google Cloud Projekt zuzuweisen, um Netzwerkanhänge zu erstellen und aufzurufen. Weitere Informationen zu dieser Rolle finden Sie unter Compute Engine-Rollen.

Workflow zum Migrieren Ihrer Arbeitslasten

So migrieren Sie Ihre selbstverwalteten Redis- und Valkey-Arbeitslasten zu Memorystore for Valkey:

1. Quellinstanz vorbereiten: Konfigurieren Sie Ihre selbstverwaltete Redis- oder Valkey-Instanz so, dass sichere Verbindungen und die ausgehende Replikation zu Memorystore for Valkey zulässig sind.
2. Zielinstanz vorbereiten: Bestimmen Sie die erforderlichen Instanzspezifikationen, z. B. die Anzahl der Shards und den Knotentyp.
3. Zielinstanz erstellen: Stellen Sie die Memorystore for Valkey-Instanz bereit, die Ihre migrierten Daten empfängt.
4. Netzwerkanhang konfigurieren: Richten Sie einen Netzwerkanhang ein. Mit diesem Anhang kann die Zielinstanz (die sich in einem von Google verwalteten VPC-Netzwerk befindet) Verbindungen zur Quellinstanz (die sich in Ihrem VPC-Netzwerk befindet) initiieren. Dadurch wird die Replikation eingerichtet.
5. Migration starten: Starten Sie den Synchronisierungsvorgang. Die Zielinstanz stellt automatisch eine Verbindung zu Ihrer Quellinstanz her und repliziert Ihre Daten kontinuierlich als Lesereplikat.
6. Migration überwachen: Prüfen Sie, ob die Migration ohne Probleme verläuft und der Status der Migration HEALTHY ist.
7. Migration abschließen: Stellen Sie den Anwendungs-Traffic auf die Zielinstanz um.

Quellinstanz vorbereiten

Sie müssen Ihre selbstverwaltete Redis- oder Valkey-Instanz vorbereiten, damit Sie Ihre Arbeitslasten zu einer Memorystore for Valkey-Zielinstanz migrieren können.

So lassen Sie Verbindungen von den Knoten der Zielinstanz zu den Knoten der Quellinstanz zu:

• Wenn Sie den geschützten Modus auf den Quellknoten aktiviert haben, deaktivieren Sie ihn.
• Wenn Sie die Quellknoten mit einer expliziten bind-Anweisung konfiguriert haben, aktualisieren Sie die Knoten, um eingehende Verbindungen von den Zielknoten zuzulassen. Die Zielknoten initiieren Verbindungen von den IP-Adressen im Subnetz des Netzwerkanhangs.
• Aktualisieren Sie alle Firewallregeln, die eingehende Verbindungen von den Zielknoten blockieren könnten.
• Wenn Sie die Authentifizierung und Transport Layer Security (TLS) auf den Quellknoten aktiviert haben, deaktivieren Sie sie.

So ermöglichen Sie den Zielknoten, die Replikation mit den Quellknoten einzurichten:

• Benennen Sie keine Valkey- oder Redis-Befehle um, die Daten ändern oder für die Replikation verwendet werden (z. B. PING, PSYNC und HSET).
• Wenn Sie für Ihre Instanz Access Control Lists (ACLs) verwenden, lassen Sie die folgenden Befehle für den Nutzer default zu, damit die Zielinstanz die Replikation einrichten kann:
  • REPLCONF
  • SYNC
  • PSYNC
  • PING
  • INFO
  • CLUSTER | NODES
• Achten Sie darauf, dass die Quellinstanz über genügend Arbeitsspeicher und CPU-Kapazität verfügt, um die zusätzliche Replikationslast von den Zielknoten zu bewältigen.

Wichtig: Notieren Sie sich die IP-Adresse und die Portnummer der Quellinstanz. Sie benötigen diese Informationen, um den Migrationsprozess zu starten.

Außerdem muss Memorystore for Valkey während des gesamten Migrationsprozesses mit dieser IP-Adresse und diesem Port kommunizieren können. Memorystore for Valkey verwendet die IP-Adresse und den Port, um die anderen Knoten in der Topologie der Instanz automatisch zu erkennen.

Zielinstanz vorbereiten

Damit die Replikation reibungslos verläuft, müssen Sie die Memorystore for Valkey-Zielinstanz so dimensionieren, dass sie die eingehende Arbeitslast von der Quellinstanz verarbeiten kann. Ermitteln Sie dazu die genauen Spezifikationen für Ihre Zielinstanz. Diese Spezifikationen umfassen die Kompatibilität mit der Quellinstanz, den Clustermodus, die Anzahl der Datenbanken, die Anzahl der Shards, die Instanzversion und den Knotentyp.

Beachten Sie die folgenden Richtlinien, um die Zielinstanz vorzubereiten:

• Kompatibilität mit der Quellinstanz: Die Quell- und Zielinstanzen müssen sich im selben Projekt und in derselben Region von Google Cloud befinden.
• Clustermodus: Der Clustermodus der Zielinstanz muss mit dem Clustermodus der Quellinstanz übereinstimmen. Wenn der Clustermodus für die Quellinstanz deaktiviert ist, muss er auch für die Zielinstanz deaktiviert sein. Andernfalls muss die Zielinstanz im Clustermodus aktiviert sein.
• Anzahl der Datenbanken: Wenn der Clustermodus für die Zielinstanz deaktiviert ist, muss die Anzahl der logischen Datenbanken auf der Instanz größer oder gleich der Anzahl der Datenbanken auf der Quellinstanz sein.
• Anzahl der Shards: Wenn für die Zielinstanz der Clustermodus aktiviert ist, muss die Anzahl der Shards auf der Instanz mit der Anzahl der Shards auf der Quellinstanz übereinstimmen. Die Anzahl der Replikate auf den Quell- und Zielinstanzen kann jedoch unterschiedlich sein.
• Instanzversion: Die Version der Zielinstanz muss mit der Version der Quellinstanz kompatibel sein. Weitere Informationen finden Sie unter Versionsunterstützung.
• Wartungsversion: Die Wartungsversion der Zielinstanz muss MEMORYSTORE_20260313_01_00 oder höher sein. Weitere Informationen finden Sie unter Wartung.
• Knotentyp: Der Knotentyp der Zielinstanz muss groß genug sein, um die Daten zu verarbeiten, die sie von Quellknoten empfängt. Weitere Informationen zu den Knotentypen, die Sie für die Zielinstanz auswählen können, und zur entsprechenden Keyspace-Kapazität für jeden Knotentyp finden Sie unter Knotentypspezifikation.

Wichtig: Sie können keine Instanzen mit regionenübergreifender Replikation als Zielinstanzen verwenden. Prüfen Sie außerdem, ob Memorystore for Valkey keine der Befehle blockiert, die Sie in der Quellinstanz verwenden.

Zielinstanz erstellen

Wenn Sie keine Zielinstanz haben, die die Anforderungen zum Empfangen der Daten erfüllt, die Memorystore for Valkey von der Quellinstanz migriert, müssen Sie die Instanz erstellen.

Verwenden Sie zum Erstellen dieser Instanz die Google Cloud Console, die gcloud CLI oder die REST API. Weitere Informationen zum Erstellen der Instanz finden Sie unter Instanzen erstellen.

Wichtig: Bevor Sie die Zielinstanz erstellen, sollten Sie die Richtlinien zur Dimensionierung und Konfiguration lesen. Weitere Informationen finden Sie unter Zielinstanz vorbereiten.

Netzwerkanhang konfigurieren

Wenn Sie die Arbeitslasten einer Quellinstanz zu einer Zielinstanz migrieren möchten, müssen die Zielknoten eine Verbindung zu den Quellknoten herstellen. Um diese Verbindung zu aktivieren, müssen Sie einen Netzwerkanhang verwenden. Die Zielknoten initiieren Verbindungen über das Subnetz im VPC-Netzwerk der Quellinstanz, das mit dem Netzwerkanhang verknüpft ist.

Sie können einen Netzwerkanhang verwenden, der die folgenden Anforderungen erfüllt:

• Es muss sich im selben Projekt und in derselben Region wie die Zielinstanz von Google Cloud befinden.
• Das Subnetz muss sich im selben VPC-Netzwerk wie die Quellinstanz befinden.
• Das Subnetz für die Quellinstanz muss einen ausreichenden IP-CIDR-Bereich haben, der mindestens N+1 verwendbare IP-Adressen unterstützt (wobei N die Anzahl der Knoten in der Zielinstanz ist). Wenn eine Zielinstanz beispielsweise drei Shards und ein Replikat hat, hat sie sechs Knoten: drei Knoten für die primäre Instanz und drei Knoten für das Replikat. Daher benötigen Sie mindestens sieben IP-Adressen.
• Der Subnetzbereich darf sich nicht mit 10.0.0.0/23 überschneiden, da Memorystore for Valkey diesen Bereich reserviert.

Wenn Ihr Netzwerkanhang diese Anforderungen nicht erfüllt oder Sie keinen Netzwerkanhang haben, müssen Sie einen erstellen. Weitere Informationen finden Sie unter Netzwerkanhänge erstellen.

Migration starten

Wenn Sie die Migration starten, wird die Replikation der Zielinstanz mit der Quellinstanz eingerichtet. Die Zielinstanz repliziert automatisch alle Daten, die Ihre Anwendung in die Quellinstanz schreibt. Die Zielinstanz wird zu einem Lesereplikat der Quellinstanz.

Verwenden Sie zum Starten der Migration die Google Cloud Console, die gcloud CLI oder die REST API.

Wichtig: Lesen Sie vor Beginn der Migration die Richtlinien unter Netzwerkanhang konfigurieren. Führen Sie nach dem Start der Migration keine Slot-Migrationsvorgänge auf der Quellinstanz aus (z. B. Neuausgleich der Instanz oder manuelles Verschieben von Hash-Slots zwischen Shards), bis die Migration abgeschlossen ist.

Console

1. Rufen Sie in der Google Cloud Console die Seite Memorystore for Valkey auf.

   Memorystore for Valkey

2. Klicken Sie auf die ID der Zielinstanz.

3. Klicken Sie auf der Seite Instanz auf einen Blick auf Migration starten.

4. Führen Sie im Fenster Selbstverwaltete Redis- und Valkey-Instanzen migrieren die folgenden Schritte aus:

5. Lesen Sie auf dem Tab Vorbereiten die Informationen zu den Voraussetzungen für die Quellinstanz und die Richtlinien für den Netzwerkanhang. Klicken Sie anschließend auf Weiter.

6. Führen Sie auf dem Tab Verbinden die folgenden Schritte aus:

   1. Geben Sie die IP-Adresse und den Port der Quellinstanz ein. Sie haben diese Informationen unter Quellinstanz vorbereiten notiert.
   2. Wählen Sie den Netzwerkanhang aus, den Sie für die Datenmigration verwenden möchten.
   3. Klicken Sie auf Weiter.

7. Prüfen Sie auf dem Tab Überprüfen die Informationen zum Migrationsprozess. Diese Informationen umfassen die ID der Zielinstanz, die IP-Adresse und den Port der Quellinstanz sowie den Namen des Netzwerkanhangs. Lesen Sie sich diese Informationen durch und klicken Sie dann auf Migration starten.

8. Prüfen Sie auf der Seite Instanz auf einen Blick, ob der Status Wird migriert angezeigt wird.

Wenn die Zielknoten keine Verbindung zu den Quellknoten herstellen können oder die Quellinstanz keine Daten in die Zielinstanz replizieren kann, schlägt die Migration fehl.

In diesem Fall setzt Memorystore for Valkey die Zielinstanz auf den Zustand zurück, den sie vor dem Start des Migrationsprozesses hatte. Der Status der Zielinstanz wird auf Bereit zurückgesetzt und die Instanz hat wieder Lese- und Schreibfunktionen.

Nachdem Sie die Probleme behoben haben, die zum Fehlschlagen der Migration geführt haben, können Sie die Migration noch einmal starten.

gcloud

Verwenden Sie den Befehl gcloud memorystore instances start-migration so:

gcloud memorystore instances start-migration INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID \
--source-ip=SOURCE_IP_ADDRESS \
--source-port=SOURCE_PORT \
--network-attachment=projects/PROJECT_ID/locations/REGION_ID/networkAttachments/NETWORK_ATTACHMENT_ID

Ersetzen Sie die folgenden Werte:

• INSTANCE_ID: die ID der Zielinstanz.
• PROJECT_ID: die ID oder Projektnummer desGoogle Cloud -Projekts, das diese Instanz enthält.
• REGION_ID: die ID der Region, in der sich die Instanz befindet.
• SOURCE_IP_ADDRESS: die IP-Adresse der Quellinstanz. Sie haben diese IP-Adresse unter Quellinstanz vorbereiten notiert.
• SOURCE_PORT: die Portnummer der Quellinstanz. Sie haben diesen Port unter Quellinstanz vorbereiten notiert.
• NETWORK_ATTACHMENT_ID: die ID des Netzwerkanhangs.

Prüfen Sie mit dem Befehl gcloud memorystore instances describe, ob die Migration erfolgreich gestartet wurde:

gcloud memorystore instances describe INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID

Prüfen Sie, ob neben dem Parameter state der Status MIGRATING angezeigt wird.

Wenn die Zielknoten keine Verbindung zu den Quellknoten herstellen können oder die Quellinstanz keine Daten in die Zielinstanz replizieren kann, schlägt die Migration fehl.

In diesem Fall setzt Memorystore for Valkey die Zielinstanz auf den Zustand zurück, den sie vor dem Start des Migrationsprozesses hatte. Der Status der Zielinstanz wird auf ACTIVE zurückgesetzt und die Instanz hat wieder Lese- und Schreibfunktionen.

Nachdem Sie die Probleme behoben haben, die zum Fehlschlagen der Migration geführt haben, können Sie die Migration noch einmal starten.

REST

Verwenden Sie den folgenden REST API-Befehl, um die Migration zu starten.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• PROJECT_ID: die ID oder Projektnummer des Google Cloud -Projekts, das die Zielinstanz enthält.
• REGION_ID: die ID der Region, in der sich diese Instanz befindet.
• INSTANCE_ID: die ID der Instanz.
• SOURCE_IP_ADDRESS: die IP-Adresse der Quellinstanz. Sie haben sich diese IP-Adresse unter Quellinstanz vorbereiten notiert.
• SOURCE_PORT: die Portnummer der Quellinstanz. Sie haben diesen Port unter Quellinstanz vorbereiten notiert.
• NETWORK_ATTACHMENT_ID: die ID des Netzwerkanhangs.

HTTP-Methode und URL:

POST https://memorystore.googleapis.com/v1/projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID:startMigration

JSON-Text anfordern:

{
  "selfManagedSource": {
    "ipAddress": "SOURCE_IP_ADDRESS",
    "port": SOURCE_PORT,
    "networkAttachment": "projects/PROJECT_ID/regions/REGION_ID/networkAttachments/NETWORK_ATTACHMENT_ID"
  }
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://memorystore.googleapis.com/v1/projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID:startMigration"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://memorystore.googleapis.com/v1/projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID:startMigration" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "name": "projects/PROJECT_ID/locations/REGION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.memorystore.v1.OperationMetadata",
    "createTime": "2026-10-26T20:00:00.000000000Z",
    "target": "projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID",
    "verb": "startMigration",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Migration überwachen

Damit die Migration ohne Probleme verläuft, sollten Sie sowohl die Quell- als auch die Zielinstanzen im Blick behalten.

Quellinstanz überwachen

Prüfen Sie auf der Quellinstanz, ob die Nutzung des Client-Ausgabepuffers auf den Quellknoten niedrig bleibt. Führen Sie einen der folgenden Schritte aus, um die Puffernutzung zu prüfen:

• Vorhandene Monitoring-Dashboards verwenden
• Stellen Sie mit Ihrem Redis- oder Valkey-Client eine Verbindung zur Quellinstanz her und führen Sie dann den Befehl INFO CLIENTS aus, um die Messwerte für den Ausgabepuffer zu prüfen.

Eine anhaltend niedrige Nutzung weist auf eine minimale Verzögerung und eine erfolgreiche Synchronisierung der Daten von der Quellinstanz zur Zielinstanz hin.

Zielinstanz überwachen

Sie können den Zustand der Migration von der Quellinstanz zu Memorystore for Valkey überwachen. Prüfen Sie dazu den Messwert Migrationsstatus (/instance/migration_status) für die Zielinstanz, um festzustellen, ob der aktuelle Status der Instanz HEALTHY lautet. Dieser Status gibt an, dass die Replikationslinks zwischen den Shards der Quell- und Zielinstanzen während des Migrationsprozesses aktiv sind und ordnungsgemäß funktionieren.

So prüfen Sie den Messwert Migrationsstatus für die Instanz mithilfe derGoogle Cloud Console:

1. Wechseln Sie in der Google Cloud Console zur Seite Metrics Explorer.

   Metrics Explorer

2. Wählen Sie im Menü Messwert den Messwert Migrationsstatus aus. Wählen Sie dazu Memorystore-Instanz  > Instanz  > Migrationsstatus aus und klicken Sie dann auf Anwenden.

3. Fügen Sie im Feld Filter den folgenden Filter hinzu: instance_id = (equals) INSTANCE_ID.

   Ersetzen Sie INSTANCE_ID durch die ID der Zielinstanz.

4. Prüfen Sie im Abschnitt Ergebnisse den aktuellen Status der Instanz. Wenn der Status HEALTHY angezeigt wird, funktioniert die Instanz und Sie können die Migration abschließen.

   Wenn der Status HEALTHY nicht angezeigt wird, können Sie den Messwert Migrationsstatus für die primären Knoten der Zielinstanz verwenden. Durch das Monitoring dieser Knoten können Sie feststellen, ob ein bestimmter Knoten fehlerhaft ist.

   So verwenden Sie den Messwert Migrationsstatus für die Instanzknoten:

   1. Wählen Sie im Menü Messwert den Messwert Migrationsstatus aus. Wählen Sie dazu Memorystore-Instanzknoten  > Instanz  > Migrationsstatus aus und klicken Sie dann auf Anwenden.

   2. Fügen Sie im Feld Filter den folgenden Filter hinzu: role = (equals) primary.

   3. Prüfen Sie im Abschnitt Ergebnisse, ob der aktuelle Status aller primären Knoten FEHLERFREI ist. Wenn der Status HEALTHY lautet, funktionieren die Knoten und Sie können die Migration abschließen.

Migration abschließen

Verwenden Sie zum Abschließen der Migration die Google Cloud Console, die gcloud CLI oder die REST API.

Wichtig: Standardmäßig sorgt Memorystore for Valkey dafür, dass die Zielinstanz bis zum Abschluss der Migration vollständig mit der Quellinstanz synchronisiert ist. Schreibvorgänge in der Quellinstanz, die nach Abschluss der Migration erfolgen, werden möglicherweise nicht repliziert.

Wenn Sie eine vollständige Datenkonsistenz zwischen den Quell- und Zielinstanzen und keinen Datenverlust wünschen, beenden Sie vor Abschluss der Migration alle Schreibvorgänge in der Quellinstanz.

Console

1. Rufen Sie in der Google Cloud Console die Seite Memorystore for Valkey auf.

   Memorystore for Valkey

2. Klicken Sie auf die ID der Zielinstanz.

3. Klicken Sie auf der Seite Instanz auf einen Blick auf Migration abschließen.

4. Führen Sie im Dialogfeld Migration abschließen die folgenden Schritte aus:

   1. Wenn Sie sicherstellen möchten, dass die Zielinstanz alle Daten aus der Quellinstanz repliziert, wählen Sie Standard aus.

      Achtung: Wenn Sie den Anwendungs-Traffic sofort auf die Zielinstanz umstellen möchten, wählen Sie Erzwingen (Synchronisierung überspringen) aus. Wenn Sie diese Auswahl treffen, kann Memorystore for Valkey jedoch möglicherweise nicht alle Daten in der Quellinstanz auf der Zielinstanz replizieren.

   2. Geben Sie im Textfeld Instanz-ID die ID der Zielinstanz ein.

   3. Klicken Sie auf Migration fertigstellen.

5. Prüfen Sie auf der Seite Instanz auf einen Blick, ob der Status Migriert angezeigt wird.

Wichtig: Aktualisieren Sie nach Abschluss der Migration die Konfigurationsdateien Ihrer Anwendung, um den gesamten Traffic an die Zielinstanz weiterzuleiten.

gcloud

Verwenden Sie den Befehl gcloud memorystore instances finish-migration so:

gcloud memorystore instances finish-migration INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID

Ersetzen Sie die folgenden Werte:

• INSTANCE_ID: die ID der Zielinstanz
• PROJECT_ID: die ID oder Projektnummer desGoogle Cloud -Projekts, das diese Instanz enthält
• REGION_ID: die ID der Region, in der sich die Instanz befindet

Achtung: Wenn Sie den Anwendungs-Traffic sofort auf die Zielinstanz umstellen möchten, verwenden Sie den Parameter --force. Wenn Sie diesen Parameter verwenden, kann Memorystore for Valkey jedoch möglicherweise nicht alle Daten in der Quellinstanz auf der Zielinstanz replizieren.

Mit dem Befehl gcloud memorystore instances describe können Sie prüfen, ob die Migration erfolgreich abgeschlossen wurde:

gcloud memorystore instances describe INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID

Prüfen Sie, ob neben dem Parameter state der Status MIGRATED angezeigt wird.

Wichtig: Aktualisieren Sie nach Abschluss der Migration die Konfigurationsdateien Ihrer Anwendung, damit der gesamte Traffic an die Zielinstanz weitergeleitet wird.

REST

Verwenden Sie den folgenden REST API-Befehl, um die Migration abzuschließen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• PROJECT_ID: die ID des Google Cloud -Projekts, das die Zielinstanz enthält.
• REGION_ID: die ID der Region, in der sich diese Instanz befindet.
• INSTANCE_ID: die ID der Instanz.

• FORCE_BOOLEAN: optional. Dieser Parameter bestimmt, ob Memorystore for Valkey die Migration sofort beendet.

  • Wenn Sie diesen Parameter auf true setzen, schließt Memorystore for Valkey die Migration sofort ab, sodass Sie den Anwendungs-Traffic auf die Zielinstanz umstellen können. Memorystore for Valkey kann jedoch möglicherweise nicht alle Daten von der Quellinstanz auf die Zielinstanz replizieren.
  • Wenn Sie diesen Parameter auf false setzen, repliziert Memorystore for Valkey alle Daten von der Quellinstanz auf die Zielinstanz bis zu dem Zeitpunkt, an dem Sie die Migration abschließen.

HTTP-Methode und URL:

POST https://memorystore.googleapis.com/v1/projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID:finishMigration

JSON-Text anfordern:

{
  "force": FORCE_BOOLEAN
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://memorystore.googleapis.com/v1/projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID:finishMigration"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://memorystore.googleapis.com/v1/projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID:finishMigration" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "name": "projects/PROJECT_ID/locations/REGION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.memorystore.v1.OperationMetadata",
    "createTime": "2026-10-26T20:00:00.000000000Z",
    "target": "projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID",
    "verb": "finishMigration",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}