기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 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)
## 사전 조건
File Transfer를 설치 및 구성하기 전에 [Nimble Studio File Transfer 설정](setting-up.md) 섹션을 완료합니다.
### 하드웨어 구성
File Transfer는 다음 요구 사항을 충족하는 컴퓨터에서 실행하는 것이 좋습니다. 전송 속도를 높이는 방법에 대한 자세한 내용은 [성능 최적화](performance-optimization.md) 섹션을 참조하세요.
+ 8개의 논리적 CPU 코어
+ 8GB RAM
전송 속도는 하드웨어, 네트워크 구성, 대역폭에 따라 달라집니다. File Transfer는 네트워크 및 하드웨어가 허용하는 한 파일을 전송할 수 있습니다. 예를 들어 컴퓨터에 500Mbps의 네트워크 대역폭이 할당된 경우 File Transfer에서 전송을 완료할 수 있는 가장 빠른 속도는 500Mbps입니다.
## 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/ko_kr/nimble-studio/latest/filetransfer-guide/images/filetransfer-file-order-list-console.png.png)
1. **전송 자동 조정**이 활성화된 경우 파일 전송에 사용할 스레드 수와 청크 크기가 동적으로 설정됩니다. 이는 기본값으로 사용 설정되어 있습니다. 이 옵션을 항상 활성화해 놓는 것이 좋습니다.
**스레드 수**
각 개별 파일을 전송하는 데 사용되는 개별 스레드 수입니다.
**청크 크기**
각 스레드에서 전달한 청크 크기(메가바이트 단위)입니다.
1. **S3 Transfer Acceleration 사용**을 활성화하면 대용량 파일의 전송 속도가 향상됩니다. File Transfer의 고속 전송에는 S3 Transfer Acceleration 기능이 필요하지 않으므로 S3 Transfer Acceleration을 사용하지 않는 것이 좋습니다. 버킷이 지리적으로 멀리 떨어져 있는 경우 이 기능을 켭니다. 자세한 내용은 [S3 Transfer Acceleration]()을 참조하세요. 이 기능을 활성화하면 추가 요금이 부과될 수 있습니다. 자세한 내용은 [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/ko_kr/nimble-studio/latest/filetransfer-guide/images/icon-three-horizontal.png))에서 **설정**을 선택합니다.
1. [Nimble Studio에서 스튜디오 설정](setting-up.md#setting-up-nimble-studio) 자습서에서 찾은 스튜디오 ID를 입력합니다.
1. **저장**을 선택합니다.
------
#### [ 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. 구성 파일에 하나 이상의 원격 구성을 정의합니다. 원격 구성의 필수 값은 채워지지 않으므로 수동으로 입력해야 합니다. 각 원격 구성에 대해 다음 변수를 정의합니다.
```
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(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`입니다. File Transfer의 고속 전송에는 S3 Transfer Acceleration 기능이 필요하지 않으므로 S3 Transfer Acceleration을 사용하지 않는 것이 좋습니다. 버킷이 지리적으로 멀리 떨어져 있는 경우 이 기능을 켭니다. 자세한 내용은 [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를 사용할 수 있습니다.