Cloud Storage FUSE ermöglicht es, einen Cloud Storage-Bucket als lokales Dateisystem bereitzustellen, damit Sie mit der Standardsemantik des Dateisystems mit Ihren Objekten interagieren können.
In dieser Kurzanleitung führen Sie die folgenden Aufgaben aus:
Cloud Storage FUSE unter Debian oder Ubuntu installieren
Bucket als Ordner auf dem Computer bereitstellen
Objekt in den Bucket hochladen
Sie verwenden die Google Cloud CLI, um das Objekt in Ihrem Storage-Bucket zu erstellen und zu verwalten, und Sie verwenden die Cloud Storage FUSE CLI, um Ihren Bucket auf Ihrem Computer bereitzustellen.
Hinweise
So richten Sie ein Projekt ein:
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, click Create project to begin creating a new Google Cloud project.
Roles required to create a project
To create a project, you need the Project Creator (
roles/resourcemanager.projectCreator
), which contains theresourcemanager.projects.create
permission. Learn how to grant roles. -
Verify that billing is enabled for your Google Cloud project.
-
Make sure that you have the following role or roles on the project: Storage Admin (
roles/storage.admin
), Storage Bucket Viewer (roles/storage.bucketViewer
)Check for the roles
-
In the Google Cloud console, go to the IAM page.
Go to IAM - Select the project.
-
In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.
- For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.
Grant the roles
-
In the Google Cloud console, go to the IAM page.
Zu IAM - Wählen Sie das Projekt aus.
- Klicken Sie auf Zugriffsrechte erteilen.
-
Geben Sie im Feld Neue Hauptkonten Ihre Nutzer-ID ein. Das ist in der Regel die E‑Mail-Adresse eines Google-Kontos.
- Wählen Sie in der Liste Rolle auswählen eine Rolle aus.
- Klicken Sie auf Weitere Rolle hinzufügen, wenn Sie weitere Rollen zuweisen möchten.
- Klicken Sie auf Speichern.
Install the Google Cloud CLI.
Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.
Führen Sie folgenden Befehl aus, um die gcloud CLI zu initialisieren:
gcloud init
-
-
In the Google Cloud console, on the project selector page, click Create project to begin creating a new Google Cloud project.
Roles required to create a project
To create a project, you need the Project Creator (
roles/resourcemanager.projectCreator
), which contains theresourcemanager.projects.create
permission. Learn how to grant roles. -
Verify that billing is enabled for your Google Cloud project.
-
Make sure that you have the following role or roles on the project: Storage Admin (
roles/storage.admin
), Storage Bucket Viewer (roles/storage.bucketViewer
)Check for the roles
-
In the Google Cloud console, go to the IAM page.
Go to IAM - Select the project.
-
In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.
- For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.
Grant the roles
-
In the Google Cloud console, go to the IAM page.
Zu IAM - Wählen Sie das Projekt aus.
- Klicken Sie auf Zugriffsrechte erteilen.
-
Geben Sie im Feld Neue Hauptkonten Ihre Nutzer-ID ein. Das ist in der Regel die E‑Mail-Adresse eines Google-Kontos.
- Wählen Sie in der Liste Rolle auswählen eine Rolle aus.
- Klicken Sie auf Weitere Rolle hinzufügen, wenn Sie weitere Rollen zuweisen möchten.
- Klicken Sie auf Speichern.
Install the Google Cloud CLI.
Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.
Führen Sie folgenden Befehl aus, um die gcloud CLI zu initialisieren:
gcloud init
-
- Sie benötigen einen Cloud Storage-Bucket, den Sie bereitstellen möchten. Wenn noch nicht geschehen, erstellen Sie einen neuen Bucket.
Generieren Sie Standardanmeldedaten für Anwendungen mit dem Befehl
gcloud auth application-default login
:gcloud auth application-default login
Cloud Storage FUSE lädt die Anmeldedaten automatisch.
Erstellen Sie ein Verzeichnis, in dem der Storage-Bucket bereitgestellt werden soll:
mkdir "$HOME/mount-folder"
Stellen Sie Ihren Storage-Bucket mit dem Befehl
gcsfuse
bereit:gcsfuse BUCKET_NAME "$HOME/mount-folder"
Ersetzen Sie BUCKET_NAME durch den Namen des Buckets, den Sie bereitstellen möchten.
Wenn der Vorgang erfolgreich war, sollte die Ausgabe in etwa so aussehen:
File system has been successfully mounted.
Klicken Sie mit der rechten Maustaste auf das Bild und speichern Sie es auf Ihrem Computer, z. B. auf dem Desktop.
Sie können das Bild auch mit dem cURL-Befehl
curl -O https://cloud.google.com/storage/images/kitten.png
herunterladen.Kopieren Sie das Bild aus seinem gespeicherten Speicherort in den Ordner, in dem der Bucket bereitgestellt wird. Verwenden Sie dazu den Befehl
cp
:cp kitten.png "$HOME/mount-folder/kitten.png"
Prüfen Sie anhand der folgenden Schritte, ob das Bild in Ihr lokales Dateisystem kopiert und erfolgreich in den Bucket hochgeladen wurde:
Führen Sie
ls
für den Ordner aus, in dem Ihr Bucket bereitgestellt ist, um zu prüfen, obkitten.png
in Ihr lokales Dateisystem kopiert wurde:ls "$HOME/mount-folder"
Wenn der Kopiervorgang erfolgreich war, wird
kitten.png
in der Ausgabe zurückgegeben.Verwenden Sie den Befehl
gcloud storage ls
, um den Inhalt Ihres Buckets aufzulisten:gcloud storage ls gs://BUCKET_NAME
Ersetzen Sie BUCKET_NAME durch den Namen Ihres Buckets:
Wenn das Image erfolgreich in Ihren Bucket hochgeladen wurde, wird
kitten.png
in der Ausgabe zurückgegeben.
Heben Sie die Bereitstellung des Storage-Buckets auf Ihrem Linux-Computer mit dem Tool
fusermount
auf:fusermount -u "$HOME/mount-folder"
Verwenden Sie den Befehl
gcloud storage rm
mit dem Flag--recursive
, um den Bucket und seinen Inhalt zu löschen:gcloud storage rm gs://BUCKET_NAME --recursive
Ersetzen Sie BUCKET_NAME durch den Namen Ihres Buckets:
Wenn der Prozess erfolgreich war, sollte die Ausgabe in etwa so aussehen:
Removing gs://my-bucket/kitten.png#1676488739323620... Removing gs://my-bucket/...
Weitere Informationen finden Sie unter Ausführlicher Überblick über Cloud Storage FUSE.
Informationen zum Einbinden von Buckets für verschiedene Anwendungsfälle
- Weitere Informationen dazu, wie Vertex AI Cloud Storage FUSE verwendet, um Cloud Storage-Buckets für benutzerdefinierte Trainingsjobs bereitzustellen
Cloud Storage FUSE installieren
Folgen Sie der Anleitung unter Cloud Storage FUSE installieren, um Cloud Storage FUSE zu installieren.
Bucket bereitstellen
Führen Sie die folgenden Schritte aus, um den Bucket in Ihrem lokalen Dateisystem bereitzustellen:
Objekt in den Bucket hochladen
Führen Sie die folgenden Schritte aus, um ein Beispielobjekt herunterzuladen und in den bereitgestellten Bucket hochzuladen:
Bereinigen
Mit den folgenden Schritten vermeiden Sie, dass Ihrem Google Cloud -Konto die auf dieser Seite verwendeten Ressourcen in Rechnung gestellt werden: