Dateien mit Cloud Storage sichern und wiederherstellen
Auf dieser Seite wird beschrieben, wie Sie Cloud Storage verwenden, um Dateien in Ihrer Gemini Enterprise Agent Platform Workbench-Instanz zu sichern und wiederherzustellen.
Übersicht
In dieser Anleitung werden zwei Möglichkeiten beschrieben, wie Sie Cloud Storage verwenden können, um Dateien auf Ihrer Agent Platform Workbench-Instanz zu sichern und wiederherzustellen:
Stellen Sie einen Cloud Storage-Bucket bereit für Ihre Agent Platform Workbench-Instanz.
Exportieren Sie Ihre Dateien nach Cloud Storage und stellen Sie sie dann wieder her.
Hinweis
- Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.
-
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 theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
Enable the Notebooks API.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (
roles/serviceusage.serviceUsageAdmin), which contains theserviceusage.services.enablepermission. Learn how to grant roles.-
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 theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
Enable the Notebooks API.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (
roles/serviceusage.serviceUsageAdmin), which contains theserviceusage.services.enablepermission. Learn how to grant roles.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Bereitstellen eines Cloud Storage-Bucket auf einer Agent Platform Workbench-Instanz benötigen:
- Notebooks-Ausführer (
roles/notebooks.runner) für das Projekt - Storage Object User (
roles/storage.objectUser) für das Dienstkonto der Agent Platform Workbench-Instanz
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.
Cloud Storage-Bucket bereitstellen
Agent Platform Workbench-Instanzen umfassen eine Cloud Storage-Einbindung, mit der Sie einen Cloud Storage-Bucket bereitstellen können. Sie können also den Inhalt des Buckets über die JupyterLab-Oberfläche durchsuchen und mit kompatiblen Dateien arbeiten.
Sie können auf alle Cloud Storage-Buckets und -Dateien zugreifen, auf die Ihre Instanz innerhalb des Projekts Ihrer Agent Platform Workbench-Instanz Zugriff hat.
Erforderliche Berechtigung zum Aktivieren des Freigabespeichers
Wenn Sie das Bereitstellen freigegebenen Speichers in Ihrer Agent Platform Workbench-Instanz aktivieren möchten, bitten Sie Ihren Administrator, dem Dienstkonto Ihrer Agent Platform Workbench-Instanz die Berechtigung storage.buckets.list für das Projekt zu erteilen.
Die Berechtigung storage.buckets.list ist erforderlich, damit der Button Freigegebenen Speicher bereitstellen in der JupyterLab-Oberfläche Ihrer Agent Platform Workbench-Instanz angezeigt wird.
Bucket und Agent Platform Workbench-Instanz erstellen
Sie benötigen Zugriff auf mindestens einen Cloud Storage-Bucket im selben Projekt wie Ihre Agent Platform Workbench-Instanz.- Informationen zum Erstellen eines Cloud Storage-Bucket finden Sie unter Bucket erstellen.
- Falls noch nicht geschehen, erstellen Sie eine Agent Platform Workbench-Instanz im selben Projekt wie der Cloud Storage-Bucket.
JupyterLab öffnen
-
Rufen Sie in der Google Cloud Console die Seite Instanzen auf.
-
Klicken Sie neben dem Namen der Agent Platform Workbench-Instanz auf JupyterLab öffnen.
Ihre Agent Platform Workbench-Instanz öffnet JupyterLab.
Cloud Storage-Bucket bereitstellen
So stellen Sie einen Cloud Storage-Bucket bereit und greifen darauf zu:
-
Achten Sie darauf, dass in JupyterLab der Tab Dateibrowser ausgewählt ist.
-
Klicken Sie in der linken Seitenleiste auf den Button Freigegebenen Speicher bereitstellen. Wenn Sie den Button nicht sehen, ziehen Sie die rechte Seite der Seitenleiste, um sie zu maximieren, bis der Button angezeigt wird.
-
Geben Sie im Feld Bucket-Name den Namen des Cloud Storage-Buckets ein, das Sie bereitstellen möchten.
-
Klicken Sie auf Mount.
-
Ihr Cloud Storage-Bucket wird in der linken Seitenleiste auf dem Tab Dateibrowser als Ordner angezeigt. Doppelklicken Sie auf den Ordner, um ihn zu öffnen und den Inhalt zu durchsuchen.
Dateien in Cloud Storage exportieren und daraus wiederherstellen
In diesem Abschnitt wird beschrieben, wie Sie Dateien nach Cloud Storage exportieren und Dateien wiederherstellen, die sich in einem Cloud Storage-Bucket befinden.
Nach Cloud Storage exportieren
-
Rufen Sie in der Google Cloud Console die Seite Instanzen auf.
-
Klicken Sie neben dem Namen der Agent Platform Workbench-Instanz auf JupyterLab öffnen.
Ihre Agent Platform Workbench-Instanz öffnet JupyterLab.
-
Achten Sie darauf, dass in JupyterLab der Tab Dateibrowser ausgewählt ist.
-
Klicken Sie in der linken Seitenleiste auf die Schaltfläche Nach GCS exportieren. Wenn Sie den Button nicht sehen, ziehen Sie die rechte Seite der Seitenleiste, um sie zu maximieren, bis der Button angezeigt wird.
-
Geben Sie im Dialogfeld Exportspeicherort angeben den Namen eines Cloud Storage-Bucket ein, in den Sie Dateien exportieren möchten. Informationen zum Erstellen eines Cloud Storage-Bucket finden Sie unter Bucket erstellen.
In Agent Platform Workbench wird ein neues Notebook mit Code zum Exportieren der Dateien Ihrer Instanz nach Cloud Storage geöffnet.
-
Führen Sie den Code in dieser Zelle aus.
Dateien aus Cloud Storage wiederherstellen
Wenn Sie eine Datei in Ihrer Agent Platform Workbench-Instanz wiederherstellen möchten, können Sie die Datei mit gcloud storage cp kopieren.
Führen Sie den folgenden Code in einer Zelle eines Ihrer Instanz-Notebooks aus:
!gcloud storage cp URI /home/jupyter/FILE_NAME
Ersetzen Sie Folgendes:
URI: Der gsutil-URI der Datei, die Sie kopieren möchten, z. B.: gs://BUCKET_NAME/ZONE/INSTANCE_ID/FILE_NAMEFILE_NAME: der Name der Datei, die kopiert werden soll
Weitere Informationen finden Sie unter Objekt aus dem Bucket herunterladen.