翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Nimble Studio File Transfer の開始方法
このチュートリアルでは File Transfer をインストールして設定する方法を紹介します。次の手順を開始する前に、管理者が「[Nimble Studio File Transfer を設定する](setting-up.md)」チュートリアルを完了していることを確認してください。
このチュートリアルの実行中に問題が発生した場合は、「[Nimble Studio File Transfer のサポート](support.md)」ページを参照してください。
**Topics**
+ [前提条件](#getting-started-prerequisites)
+ [ステップ 1: File Transfer をインストールする](#getting-started-install)
+ [ステップ 2: File Transfer の設定](#getting-started-configure)
## 前提条件
[Nimble Studio File Transfer を設定する](setting-up.md) のインストールと設定を行う前に、「File Transfer」セクションを完了してください。
### ハードウェア設定
File Transfer を使用するには、コンピュータが以下の要件を満たしていることをお勧めします。転送速度を上げる方法の詳細については、「[パフォーマンスの最適化](performance-optimization.md)」を参照してください。
+ 8 つの論理 CPU コア
+ 8 GB RAM
転送速度は、ハードウェア、ネットワーク構成、帯域幅によって異なります。File Transfer はネットワークとハードウェアが許す範囲でファイルを転送できます。例えば、マシンに 500 Mbps のネットワーク帯域幅が割り当てられている場合、File Transfer が転送を完了しようとする最高速度は 500 Mbps です。
## ステップ 1: File Transfer をインストールする
File Transfer インストーラは、セットアップをガイドし、マシンに基づいて正しいスレッドとチャンクサイズを設定します。
[File Transfer クライアント](https://aws.amazon.com/nimble-studio/features/file-transfer-client)から Nimble Studio File Transfer クライアントをダウンロードしてインストールします。
## ステップ 2: File Transfer の設定
File Transfer では、グラフィカルユーザーインターフェイス (GUI) またはコマンドラインインターフェイス (CLI) を使用できます。デスクトップでオペレーティングシステム (OS) を使用する場合、GUI で File Transfer を設定できます。デスクトップで OS を使用しない場合は、File Transfer CLI を使用して File Transfer を設定して実行できます。CLI を使用すると、File Transfer をより柔軟に使用できます。
------
#### [ GUI ]
File Transfer でファイルを転送する前に、*リモート設定*を追加する必要があります。リモート設定は、異なるバケットやディレクトリにファイルを転送するために使用できる個別の設定として扱われます。
**リモート設定を追加するには**
1. GUI の S3 バケットファイルブラウザウィンドウで **[リモート設定を作成]** を選択します。
1. **[リモート設定を追加]** セクションで、以下の情報を入力します。
1. **[リモート設定名]** に、リモート設定の名前を入力します。名前は一度設定すると変更できません。
1. **[S3 バケット]** に、File Transfer で使用する S3 バケットの名前を追加します。S3 バケットを作成する方法については、「[S3 バケットを作成する](setting-up.md#setting-up-bucket)」を参照してください。
1. **[AWSリージョン]** に、S3 バケットがあるリージョンを入力します。
1. **[AWS 名前付きプロファイル]** に、S3 アクセスに使用する AWS 名前付きプロファイルを入力します。代わりに AWS アクセスキーまたは AWS シークレットキーを使用する場合は、このフィールドを空白のままにします。AWS 名前付きプロファイルがない場合は、「[IAM アクセスポリシーの作成](setting-up.md#setting-up-iam-access-policy)」トピックおよび「[のセットアップ AWS CLI](setting-up.md#setting-up-cli)」トピックを参照してください。
1. **[追加]** を選択して続行します。
1. **[詳細設定]** セクションに、以下の情報を入力します。
1. **[ストレージクラス]** では、S3 バケットのストレージクラスを指定します。ストレージクラスの詳細については、「[Amazon S3 ストレージクラス](https://aws.amazon.com/s3/storage-classes/)」を参照してください。
1. **[チェックサムアルゴリズム]** では、チェックサムの計算にどのチェックサムアルゴリズムを使用するかを指定します。
1. (オプション) **[ローカルディレクトリ]** では、ローカルマシンのデフォルトディレクトリを指定します。
1. (オプション) **[S3 バケットプレフィックス]** では、S3 バケットのデフォルトディレクトリを指定します。
1. **[フィルター]** では、形式に応じたファイルのフィルターを指定します。このフィールドでは、有効な正規表現を使用できます。例えば、**"^.\$1\$1.(mov)\$1"** は `.mov` で終わるファイルのみをアップロードします。
1. **[最大経過時間]** は、`Max Age` の時間値よりも後で、現在の時刻よりも前に作成または変更したファイルに File Transfer を制限します。単位は **m** (分)、**h** (時間)、**d** (日)、**w** (週) で表します。単位を指定しない場合、値は秒数で指定されます。例えば、「**5d**」と入力すると、直近 5 日間に作成または変更したファイルが転送されます。「**350**」と入力すると、直近 350 秒以内に作成または変更したファイルが転送されます。
1. (オプション) **[ファイル順序リスト]** は、ファイル拡張子ごとに転送の優先順位を設定します。拡張子を入力してリストに追加します。リストにない拡張子の付いたファイルは優先順位が最も低く、ファイルシステムにリストされている順序で転送されます。
![\[.mov と.txt の拡張子を使用した File Transfer ファイル順序リストのサンプル画像。\]](http://docs.aws.amazon.com/ja_jp/nimble-studio/latest/filetransfer-guide/images/filetransfer-file-order-list-console.png.png)
1. **[転送の自動チューニング]** を有効にすると、ファイル転送のスレッド数とチャンクサイズが動的に設定されます。これはデフォルトで有効になっています。このオプションを有効にしておくことをお勧めします。
**スレッドの数**
個々のファイルの転送に使用される個別のスレッドの数。
**チャンクサイズ**
各スレッドが提供するチャンクのサイズ (MB 単位)。
1. **[S3 Transfer Acceleration を使用]** を有効にすると、大容量ファイルの転送速度が向上します。S3 Transfer Acceleration は File Transfer で高速転送を実現するために必要ではないため、これをオフにしておくことがベストプラクティスです。バケットが地理的に離れている場合は、この機能を有効にしてください。詳細については、「[S3 Transfer Acceleration]()」を参照してください。これを有効にすると、追加料金が適用される場合があります。詳細については、[Amazon S3 の料金](https://aws.amazon.com/s3/pricing) を参照してください。
1. **[メタデータフィルターを有効にする]** をオンにすると、システムメタデータファイルを自動的にフィルタリングします。これらのファイルには、`._` で始まるファイルや、`thumbs.db` ファイル、`.DS_Store` ファイルが含まれます。
1. **[Save]** (保存) を選択します。
**スタジオ ID を追加するには**
1. File Transfer を開きます。
1. **スタートメニュー**に進み、**File Transfer** を検索します。
1. リストから **Nimble Studio File Transfer** を選択します。
1. ドロップダウンメニュー (![\[The menu icon.\]](http://docs.aws.amazon.com/ja_jp/nimble-studio/latest/filetransfer-guide/images/icon-three-horizontal.png)) から、**[設定]** を選択します。
1. 「[Nimble Studio にスタジオをセットアップする](setting-up.md#setting-up-nimble-studio)」チュートリアルで見つけたスタジオ ID を入力します。
1. [**Save (保存)**] を選択します。
------
#### [ CLI ]
File Transfer がインストールされたので、設定ファイルを編集します。
**設定ファイルを編集するには**
1. コンピュータ上の任意のテキスト編集ソフトウェアで設定ファイルを開きます。
1. Windows: コンピュータ上の `User/` フォルダに移動します。`.filetransfer` フォルダを開き、テキストエディタで `filetransfer.yaml` ファイルを開きます。
1. macOS: **Cmd\$1Shift\$1G** と入力します。次に、**\$1/.filetransfer** と入力します。テキストエディタで `filetransfer.yaml` ファイルを開きます。
1. Linux: 任意のテキストエディタを使用して `filetransfer.yaml` ファイルを開きます。このファイルは `~/.filetransfer/configuration.yaml` にあります。
1. 設定ファイルに以下の変数を定義します。必要な値が入力されます。オプションの値を指定する必要があります。
1. `studio_id`: 「[Nimble Studio にスタジオをセットアップする](setting-up.md#setting-up-nimble-studio)」チュートリアルで見つけたスタジオ ID を入力します。
1. `max_active_checksums`: 同時に処理される個々のチェックサムの数を入力します。この値がシステムで使用可能な CPU コアの数を超えると、警告メッセージが表示され、この値は CPU コアの数に制限されます。詳細については、「[File Transfer チェックサム](checksums.md)」を参照してください。
1. `max_active_transfers`: 同時に処理される個々のファイルの数を入力します。
1. 設定ファイルに 1 つ以上のリモート設定を定義します。リモート設定に必要な値は自動的に入力されないため、手動で入力する必要があります。リモート設定ごとに以下の変数を定義します。
```
protocols:
s3:
remote_configuration:
demo:
name: demo
bucket: my-bucket
region: us-west-2
profile: my-profile
storage_class: standard
auto_tuning: true
chunk_size: 25
threads: 10
checksum_algorithm: md5_hex
max_age: ""
accelerated: false
file_order: []
filter: ""
upload_hot_folder:
enabled: false
local_source_folder: ""
s3_destination_folder: ""
enable_metadata_filter: true
paths:
local: ""
remote: ""
```
1. `name`: 転送プロファイルの名前を入力します。
1. `bucket`: アップロード先およびダウンロード元にする S3 バケットの名前を入力します。管理者によって [S3 バケットを作成する](setting-up.md#setting-up-bucket) にバケットが作成されているはずです。
1. `region`: バケットがある AWS リージョンを入力します。
1. `profile`: システム管理者が [のセットアップ AWS CLI](setting-up.md#setting-up-cli) の手順 4 で作成したプロファイルの名前を入力します。このプロファイルを使用して、Amazon Simple Storage Service (Amazon S3) にアクセスできます。設定したプロファイルのリストを表示するには、ターミナルウィンドウで次のコマンドを実行します: `aws configure list`
1. `storage_class`: デフォルトでは `standard` に設定されています。この変数に指定できる値は、以下のとおりです。
+ `reduced_redundancy`
+ `standard_ia`
+ `onezone_ia`
+ `intelligent_tiering`
+ `glacier`
+ `deep_archive`
+ `glacier_ir`
**注記**
Amazon S3 のどのストレージクラスにも直接アップロードできます。S3 Glacier Deep Archive または S3 Glacier Flexible Retrieval を使用する場合、File Transfer を使用してアップロードしたオブジェクトを File Transfer から直接ダウンロードすることはできません。ストレージクラスの詳細については、「[Amazon S3 ストレージクラス](https://aws.amazon.com/s3/storage-classes/)」を参照してください。
1. `auto_tuning`: ファイルのサイズに基づいて、チャンクサイズと最大アクティブ転送数を自動的に調整します。デフォルトで、これは `true` に設定されます。
1. `chunk_size`: 各スレッドによって提供されるチャンクのサイズ (MB 単位) を入力します。`auto`\$1tuning を `true` に設定している場合、このフィールドは必須ではありません。
1. `threads`: 個々のファイルの転送に使用する個別のスレッドの数を入力します。`auto_tuning` を `true` に設定した場合、このフィールドは必須ではありません。
1. `checksum_algorithm`: これは S3 にファイルをアップロードするときに使用するチェックサムアルゴリズムです。`md5-hex` (デフォルト値)、`xxhash`、`xxhash64`、`xxh3 checksum algorithms` のいずれかを選択できます。
1. (オプション) `Max Age`: `Max Age` の時間値よりも後で、現在の時刻よりも前に作成または変更したファイルに File Transfer を制限します。単位は **m** (分)、**h** (時間)、**d** (日)、**w** (週) で表します。単位を指定しない場合、値は秒数で指定されます。例えば、「**5d**」と入力すると、直近 5 日間に作成または変更したファイルが転送されます。「**350**」と入力すると、直近 350 秒以内に作成または変更したファイルが転送されます。
1. `accelerated`: S3 Transfer Acceleration を有効にします。デフォルトでは、これは `false` です。S3 Transfer Acceleration は File Transfer で高速転送を実現するために必要ではないため、これをオフにしておくことがベストプラクティスです。バケットが地理的に離れている場合は、この機能を有効にしてください。詳細については、「[S3 Transfer Acceleration]()」を参照してください。これを有効にすると、追加料金が適用される場合があります。詳細については、[Amazon S3 の料金](https://aws.amazon.com/s3/pricing) を参照してください。
1. (オプション) `file_order`: ファイル拡張子のカンマ区切りのリストを入力し、転送するファイルの優先順位を定義します。リストに含まれていないファイル拡張子は、ファイルシステムがリストした順序で最後に転送されます。例えば、`".mov,.txt"` は `.mov` ファイルの転送を `.txt` ファイルよりも優先します。
1. (オプション) `filter`: 形式に基づいて転送するファイルをフィルタリングします。`filter` フィールドでは、有効な正規表現を使用できます。例えば、`"^.*\.(mov)$"` は `.mov` で終わるファイルのみをアップロードします。
1. (オプション) `upload_hot_folder enabled`: アップロードホットフォルダ機能を有効にします。
1. (オプション) `upload_hot_folder local_source_folder`: `upload hot folder` が有効になっている場合は必須です。File Transfer は、指定したフォルダ内のすべてのファイルシステムイベントを再帰的にモニタリングし、ファイルを追加または変更すると、アップロードを開始します。
1. (オプション) `upload_hot_folder s3_destination_folder`: `upload hot folder` が有効な場合は必須です。アップロードしたホットフォルダファイルは、このフォルダに追加されます。
1. `enable_metadata_filter`: `true` の場合、File Transfer はシステムメタデータファイルを自動的にフィルタリングします。これらのファイルには、`Thumbs.db`、`.DS_Store` に加えて、`._` で始まるファイルが含まれます。
1. (オプション) `paths local`: ローカルファイルシステム内の File Transfer ファイルのルートフォルダ。
1. (オプション) `paths remote`: S3 バケット内の File Transfer ファイルのルートフォルダ。
1. (オプション) `paths local`: ファイルパスを入力します。ローカルファイルシステムのファイルブラウザのそのローカルパスから転送が開始されます。
1. (オプション) `paths remote`: ファイルパスを入力します。S3 バケットのファイルブラウザのそのパスから転送が開始されます。
1. 設定ファイルを保存します。
1. 以下のコマンドを実行して、AWS 認証情報を検証します: `filetransfer validate-credentials remote configuration`
1. *remote configuration* を、作成した設定の名前に置き換えます。
1. このコマンドは、IAM キーなど、指定した AWS 認証情報を確認します。このコマンドは、File Transfer が Amazon S3 に接続できるかどうかを確認し、設定ファイルに指定されているバケット内のオブジェクトを一覧表示します。
------
インストールと設定が完了したら、File Transfer を使用する準備が整います。