사전 조건 1단계: File Transfer 설치 2단계: File Transfer 구성

Nimble Studio File Transfer 시작하기

이 자습서에서는 File Transfer를 시작하고 구성하는 방법을 보여줍니다. 다음 단계를 시작하기 전에 관리자가 Nimble Studio File Transfer 설정 자습서의 단계를 완료했는지 확인합니다.

이 자습서의 단계를 수행하는 동안 문제가 발생하는 경우 Nimble Studio File Transfer 지원 페이지를 참조하세요.

주제

사전 조건
1단계: File Transfer 설치
2단계: File Transfer 구성

사전 조건

File Transfer를 설치 및 구성하기 전에 Nimble Studio File Transfer 설정 섹션을 완료합니다.

하드웨어 구성

File Transfer는 다음 요구 사항을 충족하는 컴퓨터에서 실행하는 것이 좋습니다. 전송 속도를 높이는 방법에 대한 자세한 내용은 성능 최적화 섹션을 참조하세요.

8개의 논리적 CPU 코어
8GB RAM

전송 속도는 하드웨어, 네트워크 구성, 대역폭에 따라 달라집니다. File Transfer는 네트워크 및 하드웨어가 허용하는 한 파일을 전송할 수 있습니다. 예를 들어 컴퓨터에 500Mbps의 네트워크 대역폭이 할당된 경우 File Transfer에서 전송을 완료할 수 있는 가장 빠른 속도는 500Mbps입니다.

1단계: File Transfer 설치

File Transfer 설치 프로그램이 설치 과정을 안내하고 컴퓨터에 따라 올바른 스레드와 청크 크기를 설정합니다.

File Transfer 클라이언트에서 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를 사용하여 파일을 전송하려면 먼저 원격 구성을 추가해야 합니다. 원격 구성은 파일을 다른 버킷과 디렉터리로 전송하는 데 사용할 수 있는 다양한 구성으로 취급됩니다.

원격 구성을 추가하려면

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. 전송 자동 조정이 활성화된 경우 파일 전송에 사용할 스레드 수와 청크 크기가 동적으로 설정됩니다. 이는 기본값으로 사용 설정되어 있습니다. 이 옵션을 항상 활성화해 놓는 것이 좋습니다.
  
  스레드 수
  
  각 개별 파일을 전송하는 데 사용되는 개별 스레드 수입니다.
  
  청크 크기
  
  각 스레드에서 전달한 청크 크기(메가바이트 단위)입니다.
9. S3 Transfer Acceleration 사용을 활성화하면 대용량 파일의 전송 속도가 향상됩니다. File Transfer의 고속 전송에는 S3 Transfer Acceleration 기능이 필요하지 않으므로 S3 Transfer Acceleration을 사용하지 않는 것이 좋습니다. 버킷이 지리적으로 멀리 떨어져 있는 경우 이 기능을 켭니다. 자세한 내용은 S3 Transfer Acceleration을 참조하세요. 이 기능을 활성화하면 추가 요금이 부과될 수 있습니다. 자세한 내용은 Amazon S3 요금을 참조하세요.
10. 메타데이터 필터 활성화를 사용하면 시스템 메타데이터 파일이 자동으로 필터링됩니다. 이러한 파일에는 ._, thumbs.db 및 .DS_Store로 시작하는 파일이 포함됩니다.
저장을 선택합니다.

스튜디오 ID를 추가하려면

File Transfer를 엽니다.
1. 시작 메뉴로 이동하여 File Transfer를 검색합니다.
2. 목록에서 Nimble Studio File Transfer를 선택합니다.
드롭다운 메뉴( )에서 설정을 선택합니다.
Nimble Studio에서 스튜디오 설정 자습서에서 찾은 스튜디오 ID를 입력합니다.
저장을 선택합니다.

CLI

이제 File Transfer 설치가 완료되었으니 구성 파일을 편집합니다.

구성 파일을 편집하려면

컴퓨터에 있는 텍스트 편집 소프트웨어를 사용하여 구성 파일을 엽니다.
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: 동시에 처리되는 개별 파일 수를 입력합니다.

구성 파일에 하나 이상의 원격 구성을 정의합니다. 원격 구성의 필수 값은 채워지지 않으므로 수동으로 입력해야 합니다. 각 원격 구성에 대해 다음 변수를 정의합니다.


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(S3)에 액세스할 수 있습니다. 구성된 프로필 목록을 가져오려면 터미널 창에 다음 명령을 실행합니다. aws configure list
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 스토리지 클래스를 참조하세요.
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입니다. File Transfer의 고속 전송에는 S3 Transfer Acceleration 기능이 필요하지 않으므로 S3 Transfer Acceleration을 사용하지 않는 것이 좋습니다. 버킷이 지리적으로 멀리 떨어져 있는 경우 이 기능을 켭니다. 자세한 내용은 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에 연결할 수 있는지 확인하고, 구성 파일에 지정된 버킷의 객체를 나열합니다.

설치 및 구성을 완료했으므로 이제 File Transfer를 사용할 수 있습니다.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

설정

GUI 사용