Auf dieser Seite wird beschrieben, wie Sie Sicherungsvorgänge für Memorystore for Valkey ausführen. Bevor Sie diese Seite lesen, sollten Sie sich mit Sicherungen vertraut gemacht haben.
Hinweise
Achten Sie darauf, dass Sie oder das verwendete Nutzerkonto die erforderlichen Berechtigungen für die Aktion haben, die Sie ausführen möchten.
Mit den Rollen Memorystore-Administrator und Memorystore-Bearbeiter können alle Sicherungsvorgänge ausgeführt werden. Mit der Rolle Memorystore-Betrachter können Back-ups angesehen und exportiert werden.
On-Demand-Sicherung erstellen
Verwenden Sie den Befehl gcloud memorystore instances
backup
, um eine On-Demand-Sicherung zu erstellen.
gcloud
gcloud memorystore instances backup INSTANCE_ID \ --backup-id=BACKUP_ID \ --ttl=TTL_PERIOD \ --project=PROJECT_ID \ --location=REGION_ID
Ersetzen Sie Folgendes:
- INSTANCE_ID: die ID der Memorystore for Valkey-Instanz.
- BACKUP_ID: Eine ID für die Sicherung, z. B.
march-2025-backup
. TTL_PERIOD: Die Gültigkeitsdauer (TTL) für die Sicherung. Wenn die Sicherung das TTL-Limit erreicht, wird sie von Memorystore for Valkey automatisch gelöscht.
Sie legen den Wert für diesen Parameter auf eine Anzahl von Tagen fest (z. B.
14d
). Der Mindestwert ist 1 Tag. Wenn Sie keinen Wert angeben, beträgt der Standardwert 100 Jahre.PROJECT_ID: Ihre Projekt-ID.
REGION_ID: Die Region, in der sich Ihre Instanz befindet, z. B.
us-east1
.
Der Befehl gibt einen Vorgangsnamen im folgenden Format zurück:
projects/PROJECT_ID/locations/REGION_ID/operations/operation-UID
Mit dem Befehl gcloud memorystore operations describe
können Sie den Status eines Vorgangs prüfen.
gcloud memorystore operations describe projects/PROJECT_ID/locations/REGION_ID/operations/operation-UID
Verwenden Sie den Befehl gcloud memorystore operations list
, um alle Vorgänge in einem Projekt und einer Region aufzulisten.
gcloud memorystore operations list --projects=PROJECT_ID \ --location=REGION_ID
Zeitpläne für automatische Sicherungen konfigurieren
Sie können einen täglichen Sicherungszeitplan beim Erstellen einer Instanz konfigurieren oder für eine vorhandene Instanz aktivieren.
Instanz mit aktiviertem automatischen Sicherungszeitplan erstellen
Im folgenden Beispiel wird gezeigt, wie Sie beim Erstellen einer Instanz einen täglichen Sicherungszeitplan festlegen. Weitere Optionen, die beim Erstellen von Instanzen verfügbar sind, finden Sie unter Instanz erstellen.
gcloud
gcloud memorystore instances create INSTANCE_ID \ --automated-backup-mode=ENABLED \ --automated-backup-start-time=START_TIME \ --automated-backup-ttl=RETENTION_POLICY
Ersetzen Sie Folgendes:
- INSTANCE_ID: die ID der Memorystore for Valkey-Instanz, die Sie erstellen.
- START_TIME: Die Zeit, zu der Memorystore for Valkey mit der Erstellung von Back-ups beginnt. Geben Sie die Zeit im
HH
-Format im 24-Stunden-Zyklus in UTC-Zeit an. Beispiel:23
. RETENTION_POLICY: Die Anzahl der Tage, für die Memorystore for Valkey jede Sicherung aufbewahrt. Legen Sie für diesen Parameter einen Wert in Tagen fest, z. B.
7d
. Der Höchstwert ist 365 Tage und der Standardwert 35 Tage.Auch nachdem Sie die Instanz gelöscht haben, behält Memorystore for Valkey die Sicherung für den Aufbewahrungszeitraum bei, maximal 365 Tage. Wenn Sie die Sicherung vor Ablauf des Aufbewahrungszeitraums entfernen möchten, müssen Sie sie manuell löschen.
Geplante Sicherungen für eine vorhandene Instanz aktivieren
Verwenden Sie den Befehl gcloud memorystore instances update
, um geplante Sicherungen für eine Instanz zu aktivieren.
gcloud
gcloud memorystore instances update INSTANCE_ID \ --automated-backup-mode=enabled \ --automated-backup-start-time=START_TIME \ --automated-backup-ttl=RETENTION_POLICY
Ersetzen Sie Folgendes:
- INSTANCE_ID: die ID der Memorystore for Valkey-Instanz, die Sie aktualisieren.
- START_TIME: Ein Zeitstempel, der angibt, wann Memorystore for Valkey mit der Erstellung von Sicherungen beginnt. Dieser Zeitstempel muss auf Stundenbasis im Format
HH
und in einem 24-Stunden-Zyklus in UTC-Zeit angegeben werden (z. B.23
). Der Zeitstempel gibt auch ein einstündiges Zeitfenster an, in dem Memorystore for Valkey mit der Erstellung von Sicherungen beginnt. RETENTION_POLICY: Die Anzahl der Tage, für die Memorystore for Valkey jede Sicherung aufbewahrt. Legen Sie für diesen Parameter einen Wert in Tagen fest, z. B.
7d
.Auch nachdem Sie die Instanz gelöscht haben, wird die Sicherung von Memorystore for Valkey für den Aufbewahrungszeitraum beibehalten. Wenn Sie die Sicherung vor Ablauf des Aufbewahrungszeitraums entfernen möchten, müssen Sie die Sicherung manuell löschen.
Geplante Sicherungen für eine vorhandene Instanz deaktivieren
Verwenden Sie den Befehl gcloud memorystore instances update
, um geplante Back-ups für eine Instanz zu deaktivieren.
gcloud
gcloud memorystore instances update INSTANCE_ID \ --automated-backup-mode=disabled
Ersetzen Sie INSTANCE_ID durch die ID der Memorystore for Valkey-Instanz, die Sie aktualisieren.
Gleichzeitigkeit mit Vorgängen zum Aktualisieren von Instanzen, Wartung und Sicherung
Aktualisierungs- und Wartungsvorgänge für eine Instanz können laufende Sicherungsvorgänge in den folgenden Situationen abbrechen:
- Wenn eine Instanz gerade aktualisiert wird, lehnt Memorystore for Valkey Anfragen für Sicherungsvorgänge ab.
- Wenn ein Sicherungsvorgang läuft, lehnt Memorystore for Valkey einen eingehenden Vorgang zum Aktualisieren einer Instanz ab.
- Wartungs- und Sicherungsvorgänge können sich überschneiden. In diesem Fall überspringt Memorystore for Valkey die Sicherungsvorgänge für diese Instanz.
Sicherungen auflisten und beschreiben
In den folgenden Abschnitten wird beschrieben, wie Sie Informationen zu Sicherungen finden.
Sicherungssammlungen auflisten
Eine Sicherungssammlung enthält alle Sicherungen für eine Memorystore for Valkey-Instanz. Mit dem Befehl gcloud memorystore backup-collections list
können Sie Sicherungssammlungen für ein Projekt und eine Region auflisten.
gcloud
gcloud memorystore backup-collections list \ --project=PROJECT_ID \ --location=REGION_ID
Ersetzen Sie Folgendes:
- PROJECT_ID: Ihre Projekt-ID.
- REGION_ID: Die Region, in der sich Ihre Instanz befindet, z. B.
us-east1
Der Befehl gibt eine Liste von Sicherungssammlungen zurück.
Sicherungen in einer Sicherungssammlung auflisten
Verwenden Sie den Befehl gcloud memorystore backup-collections backups list
, um die Sicherungen in einer Sicherungssammlung aufzulisten.
gcloud
gcloud memorystore backup-collections backups list \ --backup-collection=BACKUP_COLLECTION --project=PROJECT_ID \ --location=REGION_ID
Ersetzen Sie Folgendes:
- BACKUP_COLLECTION: der Name der Sicherungssammlung
- PROJECT_ID: Ihre Projekt-ID.
- REGION_ID: Die Region, in der sich Ihre Instanz befindet, z. B.
us-east1
Der Befehl gibt eine Liste der Sicherungen zurück, die sich in einer Sicherungssammlung befinden.
Sicherung beschreiben
Verwenden Sie den Befehl gcloud memorystore backup-collections backups describe
, um Informationen zu einer Sicherung abzurufen.
gcloud
gcloud memorystore backup-collections backups describe BACKUP_NAME \ --backup-collection=BACKUP_COLLECTION \ --project=PROJECT_ID \ --location=REGION_ID
Ersetzen Sie Folgendes:
- BACKUP_NAME: der Name der Sicherung (z. B.
2024-05-01-10-15-00
) - BACKUP_COLLECTION: der Name der Sicherungssammlung
- PROJECT_ID: Ihre Projekt-ID.
- REGION_ID: Die Region, in der sich Ihre Instanz befindet, z. B.
us-east1
Der Befehl gibt Informationen zum Backup zurück, die in etwa so aussehen:
backupFiles: - createTime: '2024-11-10T03:52:55.539Z' fileName: 3d2774dab822137c5bac9386f3fa69ee4c73b928.rdb sizeBytes: '694879680' - createTime: '2024-11-10T03:52:54.742Z' fileName: 7f5d99faaefc63ed8292a71da2552db3b06cdcff.rdb sizeBytes: '694925906' - createTime: '2024-11-10T03:52:54.972Z' fileName: 0aac1092a3fb81515aefb6b2421f31eb346c3961.rdb sizeBytes: '694784169' instance: projects/PROJECT_ID/locations/us-east1/instances/instance1 instanceUid: 57130520-636c-4ac7-ad7e-86f7cfb32838 createTime: '2024-11-10T03:52:40.899882388Z' expireTime: '2124-11-10T03:53:02.856981736Z' name: projects/PROJECT_ID/locations/us-east1/backupCollections/dda2f551-b416-47ff-b1cf-684e00483dc9/backups/march-2025-backup nodeType: HIGHMEM_MEDIUM shardCount: 3 state: ACTIVE totalSizeBytes: '2084589755'
Sicherung löschen
Verwenden Sie den Befehl gcloud memorystore backup-collections backups delete
, um eine Sicherung zu löschen.
gcloud
gcloud memorystore backup-collections backups delete BACKUP_NAME \ --backup-collection=BACKUP_COLLECTION \ --project=PROJECT_ID \ --location=REGION_ID
Ersetzen Sie Folgendes:
- BACKUP_NAME: der Name der Sicherung (z. B.
2024-05-01-10-15-00
) - BACKUP_COLLECTION: der Name der Sicherungssammlung
- PROJECT_ID: Ihre Projekt-ID.
- REGION_ID: Die Region, in der sich Ihre Instanz befindet, z. B.
us-east1
Sicherung in einen Storage-Bucket exportieren
Sie können eine Sicherung in einen Cloud Storage-Bucket exportieren.
In den folgenden Schritten wird gezeigt, wie Sie eine Sicherung exportieren.
Gewähren Sie dem Dienst-Agent von Memorystore for Valkey Zugriff auf die Ressourcen von Cloud Storage.
Sie gewähren dem Dienst-Agent Zugriff auf die Ressourcen von Cloud Storage, damit Memorystore for Valkey auf den Ziel-Cloud Storage-Bucket zugreifen kann. Der Dienst-Agent für Memorystore for Valkey verwendet das folgende Namensformat:
service-PROJECT_NUMBER@gcp-sa-memorystore.iam.gserviceaccount.com
Ersetzen Sie PROJECT_NUMBER durch die Projektnummer des Projekts, in dem sich die Instanz oder das Backup befindet.
Weisen Sie dem Dienst-Agent eine Rolle zu, die die Berechtigungen
storage.buckets.get
,storage.objects.create
,storage.objects.delete
undstorage.folders.create
enthält.Mit dem folgenden Befehl wird beispielsweise dem Dienst-Agent für einen Cloud Storage-Bucket die Rolle
Storage Admin
zugewiesen:gcloud
gcloud storage buckets add-iam-policy-binding gs://BUCKET_NAME \ --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-memorystore.iam.gserviceaccount.com \ --role=roles/storage.admin
Ersetzen Sie Folgendes:
- BUCKET_NAME: Der Name des Cloud Storage-Ziel-Buckets. Dieser Bucket muss ein regionaler Bucket sein und sich in derselben Region wie das Backup befinden. Memorystore for Valkey muss Berechtigungen haben, um auf den Bucket zuzugreifen und Ordner und Objekte im Bucket zu erstellen.
- PROJECT_NUMBER: die Projektnummer, die im Namen des Dienstkontos verwendet wird.
Verwenden Sie den Befehl
gcloud memorystore backup-collections backups export
, um ein Backup in einen Cloud Storage-Bucket zu exportieren.gcloud
gcloud memorystore backup-collections backups export BACKUP_NAME \ --backup-collection=BACKUP_COLLECTION \ --location=REGION_ID \ --gcs-bucket=BUCKET_NAME
Ersetzen Sie Folgendes:
- BACKUP_NAME: der Name der Memorystore for Valkey-Sicherung
- BACKUP_COLLECTION: der Name der Sicherungssammlung
- REGION_ID: die Region, in der sich die Sicherungssammlung befindet, z. B.
us-east1
- BUCKET_NAME: der Name des Cloud Storage-Bucket, der nicht das Präfix
gs://
hat
Daten aus einem Back-up wiederherstellen
Wenn Sie Daten aus einer Sicherung wiederherstellen möchten, können Sie entweder eine neue Instanz aus einer verwalteten Sicherung im selben Projekt oder aus RDB-Dateien in einem Cloud Storage-Bucket initialisieren. Damit eine Instanz aus RDB-Dateien initialisiert werden kann, muss Memorystore for Valkey die Berechtigung haben, auf die Dateien zuzugreifen.
Neue Instanz aus einer Sicherung erstellen
Im folgenden Beispiel wird gezeigt, wie Daten aus einer Sicherung in eine neue Instanz importiert werden. Das Backup muss sich in derselben Region wie die Instanz befinden. Außerdem muss das Prinzipal, das die Instanz erstellt, die Berechtigung redis.backups.get
für die Sicherung haben.
gcloud
gcloud memorystore instances create INSTANCE_ID \ --import-managed-backup=BACKUP_NAME \ --location=REGION_ID
Ersetzen Sie Folgendes:
- INSTANCE_ID: die ID der Memorystore for Valkey-Instanz, die Sie erstellen.
- BACKUP_NAME: der Name der Sicherung. Dieser Name hat das folgende Format:
projects/PROJECT_ID/locations/REGION_ID/backupCollections/BACKUP_COLLECTION_ID/backups/BACKUP_ID
. - REGION_ID: Die Region, in der sich Ihre Instanz befindet, z. B.
us-east1
.
Neue Instanz aus RDB-Dateien in einem Speicher-Bucket übertragen
Sie können Daten aus RDB-Dateien, die in einem Cloud Storage-Bucket enthalten sind, in eine neue Instanz importieren.
In den folgenden Schritten wird gezeigt, wie Sie Daten aus RDB-Dateien in einem Cloud Storage-Bucket in eine neue Instanz importieren.
Gewähren Sie dem Dienst-Agent von Memorystore for Valkey Zugriff auf die Ressourcen von Cloud Storage.
Sie gewähren dem Dienst-Agent Zugriff auf die Ressourcen von Cloud Storage, damit Memorystore for Valkey auf die RDB-Dateien im Cloud Storage-Bucket zugreifen kann. Der Memorystore for Valkey-Dienst-Agent verwendet das folgende Namensformat:
service-PROJECT_NUMBER@gcp-sa-memorystore.iam.gserviceaccount.com
Ersetzen Sie PROJECT_NUMBER durch die Projektnummer des Projekts, in dem Sie die neue Instanz erstellen.
Weisen Sie dem Dienst-Agent eine Rolle zu, die die Berechtigungen
storage.buckets.get
undstorage.objects.get
enthält.Mit dem folgenden Befehl wird beispielsweise dem Dienst-Agent für einen Cloud Storage-Bucket die Rolle
Storage Admin
zugewiesen:gcloud
gcloud storage buckets add-iam-policy-binding gs://BUCKET_NAME --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-memorystore.iam.gserviceaccount.com --role=roles/storage.admin
Ersetzen Sie Folgendes:
- BUCKET_NAME: Der Name des Buckets, in dem sich die RDB-Dateien befinden. Dieser Bucket muss entweder ein regionaler Bucket in derselben Region wie das Backup oder ein biregionaler Bucket sein, wobei eine Region mit dem Backup übereinstimmen muss. Memorystore for Valkey muss Berechtigungen für den Zugriff auf den Bucket haben.
- PROJECT_NUMBER: die Projektnummer, die im Namen des Dienstkontos verwendet wird.
Verwenden Sie den Befehl
gcloud memorystore instances create
, um Daten aus RDB-Dateien in einem Cloud Storage-Bucket in eine neue Instanz zu importieren.gcloud
gcloud memorystore instances create INSTANCE_ID \ --import-gcs-object-uris=URI \ --location=REGION_ID
Ersetzen Sie Folgendes:
- INSTANCE_ID: die ID der Memorystore for Valkey-Instanz, die Sie erstellen.
- URI: Ein oder mehrere durch Kommas getrennte Cloud Storage-URIs (Uniform Resource Identifiers). Beispiel:
gs://my-bucket/folder/file1.rdb,gs://my-bucket/folder/file2.rdb
- REGION_ID: Die Region, in der sich Ihre Instanz befindet, z. B.
us-east1
.
Cloud Monitoring-Messwerte
Sie können Cloud Monitoring-Messwerte verwenden, um die letzten Sicherungs- und Importvorgänge zu überwachen. Eine Liste der Messwerte, die für Memorystore for Valkey-Sicherungen verfügbar sind, finden Sie unter Messwerte für Sicherungen.