オンプレミスまたはプライベート クラウドのファイル システム（POSIX 準拠のファイル システム、NFS、SMB など）からデータを転送するには、ソースファイルへのネットワーク アクセス権を持つマシンに Storage Transfer Service エージェントをインストールして構成する必要があります。
前提条件
転送を構成する前に、次の設定が完了していることを確認してください。
- ユーザー権限: ユーザー アカウントまたはユーザー管理のサービス アカウントに、転送ジョブとエージェント プールを構成する権限があることを確認します。必要なユーザー権限をご覧ください。
- エージェント ベースのプロジェクト レベルの権限: サービス エージェントと転送エージェント アカウントに必要なプロジェクト レベルのロールが構成されていることを確認します。エージェント ベースのプロジェクト レベルの権限をご覧ください。
- 宛先の権限: 転送先に応じて、必要なシンク権限を構成します。
- Cloud Storage への転送については、シンクへのアクセスを構成する: Cloud Storage をご覧ください。
- 別のファイル システムへの転送については、シンクへのアクセスを構成する: ファイル システムをご覧ください。
ローカル ファイル システムの権限
転送エージェントは、ホストマシンの Docker コンテナまたは Podman コンテナ内で実行されます。エージェントがファイルを読み取れるようにするには:
- OS ユーザー権限: コンテナを実行するオペレーティング システム ユーザーに、転送するすべてのファイルとディレクトリに対する読み取り（およびディレクトリでの実行）権限があることを確認します。
ディレクトリをマウントする: エージェントをインストールするときに、
--mount-directoriesフラグ（または Docker の-vフラグ）を使用して、コンテナにコピーするディレクトリをマウントします。gcloud transfer agents install --pool=AGENT_POOL_NAME \ --mount-directories=/path/to/source/dir
エージェントが表示できるホスト ディレクトリを制限するには、エージェントのディレクトリ アクセスを制限するをご覧ください。
パフォーマンスと最適化
- 大規模なファイル システムから転送する際のスループットを最大化するには、ソース エージェント プールに複数のエージェントをインストールします（推奨される最小数は 3）。転送エージェントのベスト プラクティスをご覧ください。
- 1 GB を超えるファイルの場合は、マルチパート アップロードを有効にすることを検討してください。
次のステップ
- 転送エージェントをインストールする方法を確認する。
- エージェント プールの作成方法を学習する。
- シンクへのアクセスを構成する: Cloud Storage の方法を学習する。
- シンクへのアクセスを構成する: ファイル システム方法を学習する。