명령줄 인터페이스(CLI)를 사용한 파일 전송 - Nimble Studio File Transfer
파일 업로드핫 폴더 구성파일 다운로드

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

명령줄 인터페이스(CLI)를 사용한 파일 전송

다음 섹션에서는 명령줄 인터페이스 (CLI) 를 사용하여 핫 폴더를 업로드, 다운로드 및 구성하는 방법을 자세히 설명합니다. File Transfer

파일 업로드

다음은 명령줄 인터페이스(CLI)용 명령입니다. 이러한 명령을 사용하면 구성 파일에 설정한 해당 S3 버킷에서 파일을 다운로드할 수 있습니다. 컴퓨터의 어느 위치에서든 이러한 명령을 실행할 수 있습니다. 하지만 이러한 명령은 루트에서 실행하는 것이 좋습니다.

File Transfer는 지정한 폴더 구조를 보존합니다. 즉, Amazon S3에 도달한 후에도 폴더 구조는 동일하게 유지됩니다. 하지만 File Transfer에 절대 경로를 제공할 수는 없습니다. 즉, 파일 경로는 /(슬래시)로 시작할 수 없습니다.

모든 S3 스토리지 클래스에 File Transfer를 통해 업로드할 수 있습니다. 스토리지 클래스에 대한 자세한 내용은 Amazon S3 스토리지 클래스를 참조하세요.

참고

로컬 컴퓨터에서 절전 모드를 비활성화하는 것이 좋습니다. 컴퓨터에 절전 모드가 활성화되면 진행 중인 전송이 중단될 수 있습니다. 설정에서 잠자기 모드 비활성화(macOS만 해당)를 전환합니다.

CLI를 사용하여 업로드를 시작하려면

  1. 터미널을 엽니다.

  2. (권장) 업로드할 파일과 폴더가 포함된 폴더로 이동합니다.

  3. 컴퓨터의 어느 위치에서든 다음 명령을 실행하여 로컬 시스템에서 Amazon S3로 파일을 업로드합니다.

    filetransfer upload [transfer profile] [relative path]

    1. [전송 프로필]을 사용하려는 전송 프로필로 대체합니다.

    2. [상대 경로]를 업로드하려는 파일 또는 디렉터리의 경로로 대체합니다.

      1. 상대 경로는 /(슬래시)로 시작하지 않습니다. 예제: Users/username/Desktop/folder1

      2. 절대 경로를 사용하지 마세요. 절대 파일 경로는 /(슬래시)로 시작합니다. 예제: /Users/username/Desktop/folder1

    3. 명령 예: filetransfer upload [transfer profile name] /Users/username/Desktop/folder1

File Transfer는 파일에서 File Transfer 체크섬를 수행합니다. 체크섬은 파일이 예기치 않게 수정되었는지 감지하기 위한 추가 파일 무결성 검증에 사용됩니다. 체크섬이 완료되면 전송이 시작됩니다. 자체 미디어 해시 목록(MHL)을 제공하면 File Transfer는 파일이 MHL에 정의된 체크섬과 일치하는지 확인할 수 있습니다. MHL은 원본 카메라 영상과 함께 제공되기도 하는 XML 파일입니다.

플래그

특정 작업을 수행하려면 명령 끝에 플래그를 추가할 수 있습니다. 플래그 사용은 선택 사항입니다.

플래그 설명 예

--help

사용 가능한 플래그와 명령을 나열합니다.

filetransfer --help

--checksum-algorithm

File Transfer가 수행하는 체크섬 계산을 정의합니다. 지원되는 값: md5, XXHash, XXHash64 및 XXH3.

filetransfer upload [remote configuration] [relative path] –-checksum-algorithm xxhash64

--enable-metadata-filter

사용 시 File Transfer는 시스템 메타데이터 파일을 자동으로 필터링합니다. 이러한 파일에는 Thumbs.db, .DS_Store 그리고 ._.로 시작하는 파일이 포함됩니다.

filetransfer upload [remote configuration] [relative path] --enable-metadata-filter

--filter

형식에 따라 전송 중인 파일을 필터링합니다. 필터 필드에는 유효한 정규 표현식을 입력할 수 있습니다. 예: ^.*\.(mov)$는 .mov로 끝나는 파일만 전송합니다. 구성 파일에 필터를 추가하여 특정 작업을 수행할 수 있습니다. 필터를 특정 명령의 플래그로 사용하는 대신 구성에 필터를 추가하면 모든 File Transfer 전송에 해당 작업이 적용됩니다.

filetransfer upload [remote configuration] [relative path] --filter "^.*\.(mov)$"

이 명령은 .mov 형식이 지정된 파일만 업로드합니다.

--force

필터나 충돌에 상관없이 전송을 강제 실행합니다. 기본적으로 File Transfer는 이전에 전송한 파일은 전송하지 않습니다.

강제 플래그는 File Transfer가 모든 필터 또는 충돌을 무시하도록 합니다. 이 기능은 다운로드해야 할 파일을 실수로 삭제한 경우에 유용합니다.

filetransfer upload [remote configuration] [relative path] --force

--max-age

현재 시간으로 끝나는 기간 내에 생성 또는 수정된 파일만 전송합니다. 단위가 제공되지 않는 경우 최대 기간은 초 단위입니다. 예를 들어, 2d 는 지난 2일 동안의 파일을 다운로드하고 3500는 지난 3500초 동안의 파일을 업로드합니다.

filetransfer upload [remote configuration] [relative path] --max-age “2d”

위 명령은 지난 2일 동안의 파일만 S3 버킷에 업로드합니다.

--retry-count

오류가 발생하면 File Transfer는 재시도 횟수만큼 파일 전송을 시도합니다.

filetransfer upload [remote configuration] [relative path] --retry-count 4

--chunk-size

MB 단위의 청크 크기(기본값 25)

filetransfer upload [remote configuration] [relative path] --chunk-size 50

--auto-tuning

도구가 전송을 최적화하기 위한 최상의 구성 값을 결정하도록 허용

filetransfer upload [remote configuration] [relative path] --auto-tuning true

--max-active-checksums

최대 활성 체크섬 수 (기본값 1) 이 플래그는 업로드에만 유효합니다.

filetransfer upload [remote configuration] [relative path] --max-active-checksums 5

--max-active-transfers

최대 전송 횟수

filetransfer upload [remote configuration] [relative path] --max-active-transfers 10

--prefix

업로드 및 다운로드를 위한 S3 접두사 경로

filetransfer upload [remote configuration] [relative path] --prefix my/s3/path

--profile

AWS 이름이 지정된 프로필

filetransfer upload [remote configuration] [relative path] --profile my_named_profile

--threads

업로드당 스레드 수(기본값 10)

filetransfer upload [remote configuration] [relative path] --threads 10

FILETRANSFER_CONFIG_DIR

기본 .filetransfer 폴더를 재정의합니다.

이 변수는 구성 파일과 데이터베이스 파일을 저장할 모든 디렉터리를 정의할 수 있습니다. FILETRANSFER_CONFIG_DIR에 대한 값이 설정되지 않았을 경우 기본값 ~/.filetransfer가 사용됩니다. 파일 이름은 여전히 configuration.yaml 또는 configuration.yaml 그리고 checksum-cache.db로 지정해야 합니다. 파일이 없으면 새로 만들어집니다.

FILETRANSFER_CONFIG_DIR=Desktop/config1 filetransfer upload [remote configuration] [relative path]

핫 폴더 구성

CLI를 사용하여 업로드 핫 폴더를 구성하려면,

  1. 컴퓨터에 있는 텍스트 편집 소프트웨어를 사용하여 구성 파일을 엽니다.

    1. Windows: 컴퓨터에서 User/<your username> 폴더로 이동합니다. .filetransfer 폴더를 열고 텍스트 편집기로 filetransfer.yaml 파일을 엽니다.

    2. macOS: Cmd+Shift+G를 입력합니다. 그런 다음 ~/.filetransfer를 입력합니다. 텍스트 편집기로 filetransfer.yaml 파일을 엽니다.

    3. Linux: 텍스트 편집기를 사용하여 filetransfer.yaml 파일을 엽니다. 파일은 ~/.filetransfer/configuration.yaml에 있습니다.

  2. 다음 필드를 사용하여 새 hot_folder 섹션을 생성합니다.

    hot folders:
              - enabled: true
              local_source_folder: /Users/user/myhotfolder
              name: my_hot_folder
              remote_configurations:
                - remote_configuration_name: example_configuration
                  s3_destination_folder: my/s3/prefix

  3. enabled가 true로 설정된 경우에만 핫 폴더가 활성화됩니다.

  4. File Transfer를 사용하여 모니터링하려는 폴더 위치로 local_source_folder를 바꿉니다. 파일 경로에는 전체 경로[C:\path\to\upload-hot-folder(Windows) 또는 /path/to/upload-hot-folder(Linux 및 macOS)]가 포함되어야 합니다.

  5. remote_configurations에서

    1. remote_configuration_name을 사용할 원격 구성의 이름으로 바꿉니다. 원격 구성은 protocols.s3.transfer_profiles 아래에 나열되어 있습니다.

    2. (선택 사항) s3_destination_folder를 파일을 업로드하려는 S3 대상 폴더로 바꿉니다. 해당 폴더가 아직 없으면 File Transfer가 Amazon S3에 폴더를 생성합니다. 값이 설정되지 않은 경우 파일은 버킷의 루트에 배치됩니다.

    3. (선택 사항) 여기에 원하는 만큼 원격 구성 항목을 추가할 수 있습니다. 그러면 핫 폴더가 각 원격 구성을 사용하여 업로드를 시작합니다. 이를 통해 여러 버킷에 업로드할 단일 핫 폴더를 설정할 수 있습니다.

  6. 다음은 여러 핫 폴더를 포함한 업로드 핫 폴더 구성의 예입니다. 이 예에는 핫 폴더가 두 개 있습니다.

    1. 첫 번째 핫 폴더는 Media/drive 폴더를 감시하도록 설정됩니다. 이 폴더에 파일이 추가되면 두 번의 업로드가 시작됩니다. 하나는 example1 원격 구성을 사용하고 다른 하나는 example2 원격 구성을 사용합니다. 각 업로드에는 해당 s3_destination_folder가 사용됩니다.

    2. 두 번째 핫 폴더는 /Users/user1/myhotfolder 폴더를 감시하도록 설정됩니다. 이 폴더에 파일이 추가되면 another_configuration 원격 구성을 사용하여 단일 업로드가 시작됩니다. 모든 파일은 Amazon S3의 example_folder 폴더에 업로드됩니다.

    hot folders: 
        - enabled: true
          local_source_folder: /Media/drive
          name: my_hot_folder
          remote_configurations:
                - remote_configuration_name: example1
                  s3_destination_folder: my/s3/folder
                - remote_configuration_name: example2
                  s3_destination_folder: second/folder
        - enabled: true
          local_source_folder: /Users/user1/my_hot_folder
          name: another_hot_folder
          remote_configurations:
                - remote_configuration_name: another_configuration
                  s3_destination_folder: example/folder

  7. 구성 파일을 저장합니다.

    참고

    대몬(daemon)을 시작하거나 핫 폴더가 추가/업데이트되면 전체 폴더에 대해 자동 강제 업로드가 시작됩니다. 이 동작을 원하지 않는 경우 GUI를 열고 작업을 취소할 수 있습니다.

파일 다운로드

다음 명령을 사용하여 구성 파일에 설정한 해당 S3 버킷에서 파일을 다운로드할 수 있습니다. 컴퓨터의 어느 위치에서든 이러한 명령을 실행할 수 있습니다. 루트에서 이 명령을 실행하는 것이 좋습니다.

File Transfer는 Deep Archive 또는 Glacier 스토리지 클래스에서는 직접 다운로드할 수 없습니다. 다른 시스템에 저장되어 있기 때문입니다. 이러한 유형의 객체는 다른 방법으로 파일을 검색해야 합니다. 다양한 시스템에서 객체를 검색하는 방법에 대한 자세한 내용은 아카이브된 객체 복원을 참조하세요. 스토리지 클래스에 대한 자세한 내용은 Amazon S3 스토리지 클래스를 참조하세요.

참고

로컬 컴퓨터에서 절전 모드를 비활성화하는 것이 좋습니다. 컴퓨터에 절전 모드가 활성화되면 진행 중인 전송이 중단될 수 있습니다. 설정에서 잠자기 모드 비활성화(macOS만 해당)를 전환합니다.

CLI를 사용하여 다운로드를 시작하려면

  1. 터미널을 엽니다.

  2. (권장) 파일을 다운로드할 폴더로 이동합니다.

  3. 컴퓨터의 원하는 위치에서 다음 명령을 실행하여 Amazon S3에서 컴퓨터로 파일을 다운로드합니다.

    filetransfer download [transfer profile]
                  [relative path]

    1. [전송 프로필]을 사용하려는 전송 프로필로 대체합니다.

    2. [상대 경로]를 파일을 다운로드할 경로로 대체합니다.

      1. 상대 경로는 /(슬래시)로 시작하지 않습니다. 예제: Users/username/Desktop/folder1

      2. 절대 경로를 사용하지 마세요. 절대 파일 경로는 /(슬래시)로 시작합니다. 예제: /Users/username/Desktop/folder1

    3. 명령 예: filetransfer download [transfer profile name] /Users/username/Desktop/folder1

File Transfer는 로컬 File Transfer 데이터베이스를 검사하여 선택한 파일이 이미 다운로드되었는지 확인합니다.

플래그

명령 끝에 플래그를 추가하여 특정 작업을 수행할 수 있습니다. 플래그 사용은 선택 사항입니다.

플래그 설명 예

--help

사용 가능한 플래그와 명령을 나열합니다.

filetransfer --help

--checksum-algorithm

File Transfer가 수행하는 체크섬 계산을 정의합니다. 지원되는 값: md5, XXHash, XXHash64 및 XXH3.

filetransfer download [remote configuration] [relative path] –-checksum-algorithm xxhash64

--enable-metadata-filter

사용 시 File Transfer는 시스템 메타데이터 파일을 자동으로 필터링합니다. 이러한 파일에는 Thumbs.db, .DS_Store 그리고 ._.로 시작하는 파일이 포함됩니다.

filetransfer download [remote configuration] [relative path] --enable-metadata-filter

--filter

형식에 따라 전송 중인 파일을 필터링합니다. 필터 필드에는 유효한 정규 표현식을 입력할 수 있습니다. 예: ^.*\.(mov)$는 .mov로 끝나는 파일만 전송합니다. 구성 파일에 필터를 추가하여 특정 작업을 수행할 수 있습니다. 필터를 특정 명령의 플래그로 사용하는 대신 구성에 필터를 추가하면 모든 File Transfer 전송에 해당 작업이 적용됩니다.

filetransfer download [remote configuration] [relative path] --filter "^.*\.(mov)$"

이 명령은 .mov 형식이 지정된 파일만 다운로드합니다.

--force

필터나 충돌에 상관없이 전송을 강제 실행합니다. 기본적으로 File Transfer는 이전에 전송한 파일은 전송하지 않습니다.

강제 플래그는 File Transfer가 모든 필터 또는 충돌을 무시하도록 합니다. 이 기능은 다운로드해야 할 파일을 실수로 삭제한 경우에 유용합니다.

filetransfer download [remote configuration] [relative path] --force

--max-age

현재 시간으로 끝나는 기간 내에 생성 또는 수정된 파일만 전송합니다. 단위가 제공되지 않는 경우 최대 기간은 초 단위입니다. 예를 들어, 2d 는 지난 2일 동안의 파일을 다운로드하고 3500는 지난 3500초 동안의 파일을 업로드합니다.

filetransfer download [remote configuration] [relative path] --max-age “2d”

위 명령은 지난 2일 동안의 파일만 S3 버킷으로 다운로드합니다.

--retry-count

오류가 발생하면 File Transfer는 재시도 횟수만큼 파일 전송을 시도합니다.

filetransfer download [remote configuration] [relative path] --retry-count 4

--chunk-size

MB 단위의 청크 크기(기본값 25)

filetransfer download [remote configuration] [relative path] --chunk-size 50

--auto-tuning

도구가 전송을 최적화하기 위한 최상의 구성 값을 결정하도록 허용

filetransfer download [remote configuration] [relative path] --auto-tuning true

--max-active-checksums

최대 활성 체크섬 수(기본값 1)

filetransfer download [remote configuration] [relative path] --max-active-checksums 5

--max-active-transfers

최대 전송 횟수

filetransfer download [remote configuration] [relative path] --max-active-transfers 10

--prefix

업로드 및 다운로드를 위한 S3 접두사 경로

filetransfer download [remote configuration] [relative path] --prefix my/s3/path

--profile

AWS 이름이 지정된 프로필

filetransfer download [remote configuration] [relative path] --profile my_named_profile

--threads

다운로드당 스레드 수(기본값 10)

filetransfer download [remote configuration] [relative path] --threads 10

FILETRANSFER_CONFIG_DIR

기본 .filetransfer 폴더를 재정의합니다.

이 변수는 구성 파일과 데이터베이스 파일을 저장할 모든 디렉터리를 정의할 수 있습니다. FILETRANSFER_CONFIG_DIR에 대한 값이 설정되지 않았을 경우 기본값 ~/.filetransfer가 사용됩니다. 파일 이름은 여전히 configuration.yaml 또는 configuration.yaml 그리고 checksum-cache.db로 지정해야 합니다. 파일이 없으면 새로 만들어집니다.

FILETRANSFER_CONFIG_DIR=Desktop/config1 filetransfer download [remote configuration] [relative path]