オンライン転送を有効または無効にする

Transfer Appliance には次の 2 つのモードがあります。

• オフライン転送: アプライアンスがいっぱいになるまでデータがコピーされます。アプライアンスが Google に返送され、コピーしたデータが Cloud Storage バケットに移動します。

• オンライン転送: アプライアンスにコピーされたデータは、Cloud Storage バケットにストリーミングされます。データが Cloud Storage バケットにアップロードされた後、アプライアンスから削除されます。gcloud CLI や他のコマンドライン ツールと比較して、オンライン転送では転送中のデータが圧縮および暗号化され、データ転送が高速化されます。

オフライン モードとオンライン モードを切り替えることができます。

アプライアンスのサービス アカウント キーをダウンロードする

プロジェクトの設定が完了したら、サービス アカウント キーを準備します。

1. アプライアンス サービス アカウントのサービス アカウント キーを作成します。これは 1 回限りのダウンロード キーです。

2. キーの名前を key.json に変更し、安全な場所に保存します。

3. アプライアンスが届いたら、アプライアンスの /tmp ディレクトリに key.json をアップロードします。

オンライン モードに設定

オンライン転送モードを初めて有効にする前に、指示に従ってプロジェクトの設定を完了してください。

オンライン モードを有効にして使用するには、送信接続が必要です。 オンライン転送モードを有効にするには、次の手順を行います。

1. アプライアンスから次の HTTPS エンドポイントへの送信接続を確認します。

   • https://gcr.io

   • https://storage.googleapis.com

   • https://oauth2.googleapis.com

   • https://storagetransfer.googleapis.com

   • https://pubsub.googleapis.com

   各 HTTPS エンドポイントを使用して、次のコマンドを実行します。

   ping URL
   

   コマンドが失敗した場合は、アプライアンスで DNS が正しく構成されていない可能性があります。アプライアンスが静的 IP アドレスを使用するように構成されている場合は、DHCP を使用するように更新します。

   ta config --data_port=PORT --ip=dhcp
   

   PORT は、アプライアンスで使用しているデータポート（RJ45 または QSFP）に置き換えます。

2. アプライアンスのサービス アカウント キーのダウンロードでダウンロードしたサービスキーを、アプライアンスの tmp フォルダにコピーします。手順は次のとおりです。

   Windows

   1. SCP ツールを使用して、次の設定でアプライアンスに接続します。

      • ファイル プロトコル: SFTP
      • ホスト名: アプライアンスの IP アドレス。
      • ポート番号: 22
      • ユーザー名: Transfer Appliance チームから提供されたアプライアンスのユーザー名。
      • パスワード: Transfer Appliance チームから提供されたアプライアンスのパスワード。

   2. ファイルを /tmp フォルダにコピーします。

   Linux

   1. 次のコマンドを実行します。

      scp PATH_TO_KEY_FILE/key.json USERNAME@IP_ADDRESS:/tmp
      

      以下を置き換えます。

      • PATH_TO_KEY_FILE: コピーする鍵ファイルのパス。
      • USERNAME: Transfer Appliance チームから提供されたアプライアンスのユーザー名。
      • IP_ADDRESS: アプライアンスの IP アドレス。

   2. プロンプトが表示されたら、Transfer Appliance チームから提供されたアプライアンスのパスワードを入力します。

   Apple macOS

   1. 次のコマンドを実行します。

      scp PATH_TO_KEY_FILE/key.json USERNAME@IP_ADDRESS:/tmp
      

      以下を置き換えます。

      • PATH_TO_KEY_FILE: コピーする鍵ファイルのパス。
      • USERNAME: Transfer Appliance チームから提供されたアプライアンスのユーザー名。
      • IP_ADDRESS: アプライアンスの IP アドレス。

   2. プロンプトが表示されたら、Transfer Appliance チームから提供されたアプライアンスのパスワードを入力します。

3. アプライアンスをオンライン モードに設定するには、次のコマンドを実行します。

   ta online
   

   次のレスポンスのサンプルは、返される出力に似ています。

   
   Starting containers for online transfer...
   Copied new credentials.          ## Or, Using old credentials
   Running binary to enable online transfer.
   This may take several minutes to finish...
   
   Containers have been successfully started. You can transfer data in
   online mode.
   

4. 省略可: 転送先バケットとジョブ オブジェクトの接頭辞を変更します。

   ta online --bucket=BUCKET --object_prefix=OBJECT_PREFIX
   

   BUCKET は転送先のバケットに、OBJECT_PREFIX は更新先のオブジェクト接頭辞に置き換えます。

   コマンドが成功すると、これら 2 つの引数を指定せずにオンライン転送を実行したステップの出力に類似した出力が返されます。

   注: 転送先バケットとオブジェクト接頭辞は個別に更新できます。新しい宛先バケットに更新する場合は、必要なサービス アカウントが新しいバケット用に設定されていることを確認してください。また、2 つのフラグの少なくとも 1 つを指定してこのコマンドを呼び出すたびに、アプライアンスがオフラインかオンラインかにかかわらず、新しい転送オペレーションがトリガーされます。

オンライン モードのトラブルシューティングについては、オンライン モードのトラブルシューティングをご覧ください。

オフライン モードに設定

オフライン モードを指定するには、次のコマンドを実行します。

ta offline

次のレスポンスのサンプルは、返される出力に似ています。

Putting the appliance in offline mode...
Appliance is successfully put into the offline mode.