Wenn Sie Daten aus einem lokalen oder privaten Cloud-Dateisystem (z. B. POSIX-kompatible Dateisysteme, NFS oder SMB) übertragen möchten, müssen Sie Storage Transfer Service-Agents auf Computern mit Netzwerkzugriff auf die Quelldateien installieren und konfigurieren.
Vorbereitung
Bevor Sie die Übertragung konfigurieren, müssen Sie Folgendes eingerichtet haben:
- Nutzerberechtigungen: Ihr Nutzerkonto oder vom Nutzer verwaltetes Dienstkonto muss die Berechtigung zum Konfigurieren von Übertragungsjobs und Agent-Pools haben. Weitere Informationen finden Sie unter Erforderliche Nutzerberechtigungen.
- Agent-basierte Berechtigungen auf Projektebene: Prüfen Sie, ob Sie die erforderlichen Rollen auf Projektebene für Ihr Dienst-Agent- und Übertragungs-Agent-Konto konfiguriert haben. Siehe Agent-basierte Berechtigungen auf Projektebene.
- Zielberechtigungen: Konfigurieren Sie je nach Übertragungsziel die erforderlichen Senkenberechtigungen:
- Informationen zu Übertragungen an Cloud Storage finden Sie unter Zugriff auf eine Senke konfigurieren: Cloud Storage.
- Informationen zu Übertragungen in ein anderes Dateisystem finden Sie unter Zugriff auf ein Ziel konfigurieren: Dateisystem.
Berechtigungen für das lokale Dateisystem
Transfer-Agents werden in Docker- oder Podman-Containern auf Ihren Hostcomputern ausgeführt. So ermöglichen Sie KI-Agenten, Ihre Dateien zu lesen:
- Betriebssystem-Nutzerberechtigungen: Der Betriebssystemnutzer, der den Container ausführt, muss Leseberechtigungen (und Ausführungsberechtigungen für Verzeichnisse) für alle Dateien und Verzeichnisse haben, die Sie übertragen möchten.
Verzeichnisse bereitstellen: Stellen Sie bei der Installation Ihrer Agents die Verzeichnisse, die Sie in den Container kopieren möchten, mit dem Flag
--mount-directories(oder den Flags-vin Docker) bereit:gcloud transfer agents install --pool=AGENT_POOL_NAME \ --mount-directories=/path/to/source/dir
Informationen zum Einschränken der Hostverzeichnisse, die Agenten sehen können, finden Sie unter Zugriff auf Agent-Verzeichnis einschränken.
Leistung und Optimierung
- Wenn Sie den Durchsatz bei der Übertragung von großen Dateisystemen maximieren möchten, installieren Sie mehrere Agents in Ihrem Quell-Agent-Pool (empfohlen werden mindestens 3). Weitere Informationen finden Sie unter Best Practices für Übertragungs-Agents.
- Bei Dateien, die größer als 1 GB sind, sollten Sie mehrteilige Uploads aktivieren.