本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 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戶Nimble Studio File Transfer](https://aws.amazon.com/nimble-studio/features/file-transfer-client)端。
## 步驟 2：設定 File Transfer
使用時File Transfer，您可以使用圖形化使用者介面 (GUI) 或命令列介面 (CLI)。如果您在桌面上使用作業系統 (OS)，您可以在 GUI File Transfer 中進行設定。如果您不是在桌面平台上使用作業系統，則可以使用 File Transfer CLI 來設定和執行File Transfer。CLI 為您的使用方式提供了更大的靈活性File Transfer。
------
#### [ GUI ]
您必須先新增*遠端組態 File Transfer*，才能使用傳輸檔案。遠端組態會被視為不同的組態，您可以用來將檔案傳輸到不同的值區和目錄。
**新增遠端組態**
1. 在 GUI 的 S3 儲存貯體檔案瀏覽器視窗中選擇**建立遠端組態**。
1. 在「**新增遠端組態**」段落中，輸入下列資訊。
1. 在**遠端組態名稱**中，輸入遠端組態的名稱。名稱一旦設定就無法修改。
1. 在 **S3 儲存貯體**中，新增您要用於的 S3 儲存貯體的名稱File Transfer。若要建立 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**傳輸檔案的輸入。在過去 350 秒內建立或修改的**350**傳輸檔案的輸入。
1. (選擇性) **檔案順序清單**會依副檔名設定傳輸優先順序。輸入副檔名以將其新增至清單。副檔名不在清單中的檔案是最低的優先順序，並會依照檔案系統中的列出順序傳輸。
![\[具有 .mov 和 .txt 副檔名的檔案傳輸檔案順序清單範例影像。\]](http://docs.aws.amazon.com/zh_tw/nimble-studio/latest/filetransfer-guide/images/filetransfer-file-order-list-console.png.png)
1. 啟用時，**傳輸自動調整**會動態設定檔案傳輸的執行緒數量和區塊大小。其預設為啟用。建議您保持啟用此選項。
**執行緒數目**
用來傳輸每個個別檔案的個別執行緒數目。
**塊大小**
每個執行緒所傳送的區塊大小 (MB)。
1. 啟用「**使用 S3 傳輸加**速」可在啟用時提高大型檔案的傳輸速度。最佳做法是保持關閉 S3 傳輸加速，因為它不需要實現高速傳輸File Transfer。如果值區在地理位置上離您很遠，請開啟此功能。如需詳細資訊，請參閱 [S3 傳輸加速]()。如果啟用此功能，可能需要支付額外費用。如需詳細資訊，請參閱 [Amazon S3 定價](https://aws.amazon.com/s3/pricing)。
1. **啟用中繼資料篩選會在啟用時自動篩選**系統中繼資料 這些文件包括以`._`及和文件開頭`thumbs.db`的`.DS_Store`文件。
1. 選擇**儲存**
**若要新增工作室 ID**
1. 打開 File Transfer.
1. 轉到開**始菜單**並搜索**File Transfer**。
1. **Nimble Studio File Transfer**從清單中選取。
1. 從下拉式選單 (![\[The menu icon.\]](http://docs.aws.amazon.com/zh_tw/nimble-studio/latest/filetransfer-guide/images/icon-three-horizontal.png)) 中，選擇 **[設定]**。
1. 輸入您在[在靈活工作室設立工作室](setting-up.md#setting-up-nimble-studio)自學課程中找到的工作室 ID。
1. 選擇**儲存**。
------
#### [ CLI ]
現在File Transfer已安裝，編輯配置文件。
**編輯組態檔案的步驟**
1. 使用電腦上的任何文字編輯軟體開啟組態檔案。
1. 視窗：瀏覽至電腦上的資`User/`料夾。開啟資`.filetransfer`料夾並使用文字編輯器開啟`filetransfer.yaml`檔案。
1. macOS：輸入**Cmd\$1Shift\$1G**。然後輸入**\$1/.filetransfer**。使用文字編輯器開啟 `filetransfer.yaml` 檔案。
1. Linux：使用任何文字編輯器開啟`filetransfer.yaml`檔案。檔案位於中`~/.filetransfer/configuration.yaml`。
1. 在組態檔案中定義下列變數。會填入必要的值。您必須提供選擇性值。
1. `studio_id`：輸入您在[在靈活工作室設立工作室](setting-up.md#setting-up-nimble-studio)教程中找到的工作室 ID。
1. `max_active_checksums`：輸入同時處理的單個校驗和的數量。如果此值超過系統中可用的 CPU 核心數目，則會顯示警告訊息，並將該值限制為 CPU 核心數目。如需詳細資訊，請參閱[File Transfer校驗和](checksums.md)。
1. `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: ""
```
1. `name`：輸入轉移設定檔的名稱。
1. `bucket`：輸入您要上傳和下載的 S3 儲存貯體的名稱。您的管理員應該已在中建立值區[建立 S3 儲存貯體](setting-up.md#setting-up-bucket)。
1. `region`：輸入您AWS 區域的存儲桶所在。
1. `profile`：輸入您的管理員在*步驟 4* 中創建的配置文件的名稱[設定 AWS CLI](setting-up.md#setting-up-cli)。此設定檔可讓您存取亞馬遜簡易儲存服務 (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 彈性擷取，則無法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`：限制File Transfer在`Max Age`時間值之後與目前時間之前建立或修改的檔案。單位表示為 **m** (分鐘)、**h** (小時)、**d** (天) 和 **w** (週)。如果未提供單位，則會以秒為單位指定該值。例如，在過去五天內建立或修改的**5d**傳輸檔案的輸入。在過去 350 秒內建立或修改的**350**傳輸檔案的輸入。
1. `accelerated`：啟用 S3 傳輸加速。根據預設，此為 `false`。最佳做法是保持關閉 S3 傳輸加速，因為它不需要實現高速傳輸File Transfer。如果值區在地理位置上離您很遠，請開啟此功能。如需詳細資訊，請參閱 [S3 傳輸加速]()。如果啟用此功能，可能需要支付額外費用。如需詳細資訊，請參閱 [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. 以您建立的*組態名稱取代遠端*組態。
1. 此命令會檢查您提供的AWS登入資料，例如 IAM 金鑰。此命令會檢查File Transfer是否能夠連線到 Amazon S3，並列出組態檔中指定的儲存貯體中的物件。
------
完成安裝和配置後，您現在就可以使用了File Transfer。