Nimble Studio File Transfer の開始方法

GUI の S3 バケットファイルブラウザウィンドウで [リモート設定を作成] を選択します。

[リモート設定を追加] セクションで、以下の情報を入力します。

1. [リモート設定名] に、リモート設定の名前を入力します。名前は一度設定すると変更できません。

2. [S3 バケット] に、File Transfer で使用する S3 バケットの名前を追加します。S3 バケットを作成する方法については、「S3 バケットを作成する」を参照してください。

3. [AWSリージョン] に、S3 バケットがあるリージョンを入力します。

4. [AWS 名前付きプロファイル] に、S3 アクセスに使用する AWS 名前付きプロファイルを入力します。代わりに AWS アクセスキーまたは AWS シークレットキーを使用する場合は、このフィールドを空白のままにします。AWS 名前付きプロファイルがない場合は、「IAM アクセスポリシーの作成」トピックおよび「のセットアップ AWS CLI」トピックを参照してください。

[追加] を選択して続行します。

[詳細設定] セクションに、以下の情報を入力します。

1. [ストレージクラス] では、S3 バケットのストレージクラスを指定します。ストレージクラスの詳細については、「Amazon S3 ストレージクラス」を参照してください。

2. [チェックサムアルゴリズム] では、チェックサムの計算にどのチェックサムアルゴリズムを使用するかを指定します。

3. (オプション) [ローカルディレクトリ] では、ローカルマシンのデフォルトディレクトリを指定します。

4. (オプション) [S3 バケットプレフィックス] では、S3 バケットのデフォルトディレクトリを指定します。

5. [フィルター] では、形式に応じたファイルのフィルターを指定します。このフィールドでは、有効な正規表現を使用できます。例えば、"^.*\.(mov)$" は .mov で終わるファイルのみをアップロードします。

6. [最大経過時間] は、Max Age の時間値よりも後で、現在の時刻よりも前に作成または変更したファイルに File Transfer を制限します。単位は m (分)、h (時間)、d (日)、w (週) で表します。単位を指定しない場合、値は秒数で指定されます。例えば、「5d」と入力すると、直近 5 日間に作成または変更したファイルが転送されます。「350」と入力すると、直近 350 秒以内に作成または変更したファイルが転送されます。

7. (オプション) [ファイル順序リスト] は、ファイル拡張子ごとに転送の優先順位を設定します。拡張子を入力してリストに追加します。リストにない拡張子の付いたファイルは優先順位が最も低く、ファイルシステムにリストされている順序で転送されます。

   

8. [転送の自動チューニング] を有効にすると、ファイル転送のスレッド数とチャンクサイズが動的に設定されます。これはデフォルトで有効になっています。このオプションを有効にしておくことをお勧めします。

   スレッドの数

   個々のファイルの転送に使用される個別のスレッドの数。

   チャンクサイズ

   各スレッドが提供するチャンクのサイズ (MB 単位)。

9. [S3 Transfer Acceleration を使用] を有効にすると、大容量ファイルの転送速度が向上します。S3 Transfer Acceleration は File Transfer で高速転送を実現するために必要ではないため、これをオフにしておくことがベストプラクティスです。バケットが地理的に離れている場合は、この機能を有効にしてください。詳細については、「S3 Transfer Acceleration」を参照してください。これを有効にすると、追加料金が適用される場合があります。詳細については、Amazon S3 の料金 を参照してください。

10. [メタデータフィルターを有効にする] をオンにすると、システムメタデータファイルを自動的にフィルタリングします。これらのファイルには、._ で始まるファイルや、thumbs.db ファイル、.DS_Store ファイルが含まれます。

[Save] (保存) を選択します。

File Transfer を開きます。

1. スタートメニューに進み、File Transfer を検索します。

2. リストから Nimble Studio File Transfer を選択します。

ドロップダウンメニュー ( ) から、[設定] を選択します。

「Nimble Studio にスタジオをセットアップする」チュートリアルで見つけたスタジオ ID を入力します。

[Save (保存)] を選択します。

コンピュータ上の任意のテキスト編集ソフトウェアで設定ファイルを開きます。

1. Windows: コンピュータ上の User/<your username> フォルダに移動します。.filetransfer フォルダを開き、テキストエディタで filetransfer.yaml ファイルを開きます。

2. macOS: Cmd+Shift+G と入力します。次に、~/.filetransfer と入力します。テキストエディタで filetransfer.yaml ファイルを開きます。

3. Linux: 任意のテキストエディタを使用して filetransfer.yaml ファイルを開きます。このファイルは ~/.filetransfer/configuration.yaml にあります。

設定ファイルに以下の変数を定義します。必要な値が入力されます。オプションの値を指定する必要があります。

1. studio_id: 「Nimble Studio にスタジオをセットアップする」チュートリアルで見つけたスタジオ ID を入力します。

2. max_active_checksums: 同時に処理される個々のチェックサムの数を入力します。この値がシステムで使用可能な CPU コアの数を超えると、警告メッセージが表示され、この値は CPU コアの数に制限されます。詳細については、「File Transfer チェックサム」を参照してください。

3. max_active_transfers: 同時に処理される個々のファイルの数を入力します。

設定ファイルに 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: ""

name: 転送プロファイルの名前を入力します。

bucket: アップロード先およびダウンロード元にする S3 バケットの名前を入力します。管理者によって S3 バケットを作成する にバケットが作成されているはずです。

region: バケットがある AWS リージョンを入力します。

profile: システム管理者が のセットアップ AWS CLI の手順 4 で作成したプロファイルの名前を入力します。このプロファイルを使用して、Amazon Simple Storage Service (Amazon S3) にアクセスできます。設定したプロファイルのリストを表示するには、ターミナルウィンドウで次のコマンドを実行します: aws configure list

storage_class: デフォルトでは standard に設定されています。この変数に指定できる値は、以下のとおりです。

auto_tuning: ファイルのサイズに基づいて、チャンクサイズと最大アクティブ転送数を自動的に調整します。デフォルトで、これは true に設定されます。

chunk_size: 各スレッドによって提供されるチャンクのサイズ (MB 単位) を入力します。auto_tuning を true に設定している場合、このフィールドは必須ではありません。

threads: 個々のファイルの転送に使用する個別のスレッドの数を入力します。auto_tuning を true に設定した場合、このフィールドは必須ではありません。

checksum_algorithm: これは S3 にファイルをアップロードするときに使用するチェックサムアルゴリズムです。md5-hex (デフォルト値)、xxhash、xxhash64、xxh3 checksum algorithms のいずれかを選択できます。

(オプション) Max Age: Max Age の時間値よりも後で、現在の時刻よりも前に作成または変更したファイルに File Transfer を制限します。単位は m (分)、h (時間)、d (日)、w (週) で表します。単位を指定しない場合、値は秒数で指定されます。例えば、「5d」と入力すると、直近 5 日間に作成または変更したファイルが転送されます。「350」と入力すると、直近 350 秒以内に作成または変更したファイルが転送されます。

accelerated: S3 Transfer Acceleration を有効にします。デフォルトでは、これは false です。S3 Transfer Acceleration は File Transfer で高速転送を実現するために必要ではないため、これをオフにしておくことがベストプラクティスです。バケットが地理的に離れている場合は、この機能を有効にしてください。詳細については、「S3 Transfer Acceleration」を参照してください。これを有効にすると、追加料金が適用される場合があります。詳細については、Amazon S3 の料金 を参照してください。

(オプション) file_order: ファイル拡張子のカンマ区切りのリストを入力し、転送するファイルの優先順位を定義します。リストに含まれていないファイル拡張子は、ファイルシステムがリストした順序で最後に転送されます。例えば、".mov,.txt" は .mov ファイルの転送を .txt ファイルよりも優先します。

(オプション) filter: 形式に基づいて転送するファイルをフィルタリングします。filter フィールドでは、有効な正規表現を使用できます。例えば、"^.*\.(mov)$" は .mov で終わるファイルのみをアップロードします。

(オプション) upload_hot_folder enabled: アップロードホットフォルダ機能を有効にします。

(オプション) upload_hot_folder local_source_folder: upload hot folder が有効になっている場合は必須です。File Transfer は、指定したフォルダ内のすべてのファイルシステムイベントを再帰的にモニタリングし、ファイルを追加または変更すると、アップロードを開始します。

(オプション) upload_hot_folder s3_destination_folder: upload hot folder が有効な場合は必須です。アップロードしたホットフォルダファイルは、このフォルダに追加されます。

enable_metadata_filter: true の場合、File Transfer はシステムメタデータファイルを自動的にフィルタリングします。これらのファイルには、Thumbs.db、.DS_Store に加えて、._ で始まるファイルが含まれます。

(オプション) paths local: ローカルファイルシステム内の File Transfer ファイルのルートフォルダ。

(オプション) paths remote: S3 バケット内の File Transfer ファイルのルートフォルダ。

(オプション) paths local: ファイルパスを入力します。ローカルファイルシステムのファイルブラウザのそのローカルパスから転送が開始されます。

(オプション) paths remote: ファイルパスを入力します。S3 バケットのファイルブラウザのそのパスから転送が開始されます。

設定ファイルを保存します。

以下のコマンドを実行して、AWS 認証情報を検証します: filetransfer validate-credentials remote configuration

1. remote configuration を、作成した設定の名前に置き換えます。

2. このコマンドは、IAM キーなど、指定した AWS 認証情報を確認します。このコマンドは、File Transfer が Amazon S3 に接続できるかどうかを確認し、設定ファイルに指定されているバケット内のオブジェクトを一覧表示します。