Trasferimento di file tramite l'interfaccia a riga di comando (CLI) - Trasferimento di file con Nimble Studio
Caricamento di fileConfigurazione delle hot folderScarica i file

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Trasferimento di file tramite l'interfaccia a riga di comando (CLI)

Le seguenti sezioni descrivono in dettaglio come caricare, scaricare e configurare le hot folder File Transfer con l'interfaccia a riga di comando (CLI).

Caricamento di file

I seguenti comandi sono per l'interfaccia a riga di comando (CLI). Con questi comandi, puoi scaricare i file dal bucket S3 corrispondente che hai impostato nel tuo file di configurazione. Puoi eseguire questi comandi da qualsiasi punto del computer. Tuttavia, consigliamo di eseguire questi comandi da root.

File Transferpreserva la struttura delle cartelle che gli viene assegnata. Ciò significa che la struttura delle cartelle rimane la stessa dopo aver raggiunto Amazon S3. Tuttavia, non puoi fornire File Transfer un percorso assoluto. Ciò significa che il percorso del file non può iniziare con una / (barra).

File Transfercaricamenti su tutte le classi di archiviazione S3. Per ulteriori informazioni sulle classi di storage, consulta Amazon S3 Storage Classes.

Nota

Ti consigliamo di disabilitare la modalità di sospensione sul tuo computer locale. Se il computer attiva la modalità di sospensione, i trasferimenti in corso potrebbero essere interrotti. In Impostazioni, attiva Disabilita sospensione (solo macOS).

Per avviare i caricamenti utilizzando la CLI

  1. Apri un terminale.

  2. (Consigliato) Passa alla cartella che contiene i file e le cartelle che desideri caricare.

  3. Esegui il seguente comando da qualsiasi punto del computer per caricare file dal computer locale su Amazon S3. 

    filetransfer upload [transfer profile] [relative path]

    1. Sostituisci [profilo di trasferimento] con il profilo di trasferimento che desideri utilizzare.

    2. Sostituisci [percorso relativo] con il percorso del file o della directory che desideri caricare.

      1. Un percorso relativo non inizia con una / (barra). Esempio: Users/username/Desktop/folder1

      2. Non utilizzare un percorso assoluto. Un percorso di file assoluto inizia con una / (barra). Esempio: /Users/username/Desktop/folder1

    3. Comando di esempio: filetransfer upload [transfer profile name] /Users/username/Desktop/folder1

File Transferesegue File Transferchecksum sui tuoi file. Il checksum viene utilizzato per un'ulteriore verifica dell'integrità dei file, per rilevare se un file è stato modificato in modo imprevisto. Una volta completati questi checksum, i trasferimenti iniziano. Se fornisci la tua Media Hash List (MHL), File Transfer puoi verificare che i tuoi file corrispondano al checksum definito nell'MHL. Il file MHL è un file XML che spesso viene fornito con riprese non elaborate da fotocamera.

Flag

Per eseguire determinate azioni, è possibile aggiungere contrassegni alla fine di un comando. L'uso delle bandiere è facoltativo.

Flag Descrizione Esempio

--help

Elenca i flag e i comandi disponibili.

filetransfer --help

--checksum-algorithm

Definisce quale calcolo del checksum viene eseguito. File Transfer Valori supportati:md5, XXHashXXHash64, e. XXH3

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

--enable-metadata-filter

Se utilizzato, File Transfer filtra automaticamente i file di metadati di sistema. Questi file includono Thumbs.db.DS_Store, e file che iniziano con ._.

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

--filter

Filtra i file che vengono trasferiti in base al loro formato. Il campo del filtro accetta espressioni regolari valide. Esempio: trasferisce ^.*\.(mov)$ solo i file che terminano con.mov. È possibile aggiungere filtri al file di configurazione per eseguire determinate azioni. Quando aggiungi filtri alla configurazione invece di usarli come flag su comandi specifici, File Transfer applica l'azione a tutti i trasferimenti.

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

Questo comando caricherà solo i file in .mov formato.

--force

Forza un trasferimento indipendentemente dai filtri o dai conflitti. Per impostazione predefinita, File Transfer non trasferisce file trasferiti in precedenza.

Il flag force fa sì che File Transfer vengano ignorati eventuali filtri o conflitti. Questa funzione è utile se hai cancellato accidentalmente un file che devi scaricare.

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

--max-age

Trasferisci solo i file che sono stati creati o modificati in una finestra temporale che termina all'ora corrente. Se non viene fornita alcuna unità, l'età massima sarà espressa in secondi. Ad esempio, 2d scaricherà i file degli ultimi due giorni e 3500 caricherà i file degli ultimi 3500 secondi.

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

Il comando precedente caricherà nel bucket S3 solo i file degli ultimi 2 giorni.

--retry-count

Se si verifica un errore, File Transfer tenterà di trasferire i file tante volte quanto il numero di tentativi.

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

--chunk-size

Dimensione del blocco in MB (impostazione predefinita 25)

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

--sintonizzazione automatica

Consenti allo strumento di decidere i migliori valori di configurazione per ottimizzare il trasferimento

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

--max-active-checksums

Numero massimo di checksum attivi (impostazione predefinita 1). Questo flag è valido solo per i caricamenti.

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

--max-active-transfers

Numero massimo di trasferimenti

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

--prefix

Percorso del prefisso S3 per caricamenti e download

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

--profile

AWS profilo denominato

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

--threads

Numero di thread per caricamento (impostazione predefinita 10)

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

FILETRANSFER_CONFIG_DIR

Sostituisce la cartella predefinita. .filetransfer

Questa variabile può definire qualsiasi directory in cui memorizzare il file di configurazione e il file di database. Se FILETRANSFER_CONFIG_DIR non è impostata, viene utilizzato il valore predefinito~/.filetransfer,. I file devono essere ancora denominati configuration.yaml oconfiguration.yaml, echecksum-cache.db. Se non esistono, vengono creati.

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

Configurazione delle hot folder

Per configurare l'hot folder di caricamento utilizzando la CLI.

  1. Apri il file di configurazione con qualsiasi software di modifica del testo presente sul tuo computer.

    1. Windows: accedi alla User/<your username> cartella sul tuo computer. Apri la .filetransfer cartella e apri il filetransfer.yaml file con un editor di testo.

    2. macOS: InvioCmd+Shift+G. Quindi entra~/.filetransfer. Apri il file filetransfer.yaml con un editor di testo.

    3. Linux: apri il filetransfer.yaml file utilizzando un editor di testo qualsiasi. Il file si trova in~/.filetransfer/configuration.yaml.

  2. Crea una nuova hot_folder sezione con i seguenti campi

    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. L'hot folder sarà attiva solo quando enabled è impostata su true.

  4. Sostituisci local_source_folder con la posizione della cartella che desideri monitorare. File Transfer Il percorso del file deve contenere il percorso completo: C:\path\to\upload-hot-folder (Windows) o (&). /path/to/upload-hot-folder Linux macOS

  5. Sottoremote_configurations:

    1. Sostituisci remote_configuration_name con il nome della configurazione remota che desideri utilizzare. Puoi trovare le tue configurazioni remote elencate sotto. protocols.s3.transfer_profiles

    2. (Facoltativo) Sostituisci s3_destination_folder con la cartella di destinazione S3 in cui desideri caricare i file. File Transfercreerà la cartella in Amazon S3 se non esiste già. I file verranno inseriti nella radice del bucket se il valore non è impostato.

    3. (Facoltativo) È possibile aggiungere qui tutte le voci di configurazione remota che si desidera e l'hot folder avvierà un caricamento utilizzando ciascuna configurazione remota. Ciò consente di impostare una singola hot folder da caricare su più bucket.

  6. L'esempio seguente è una configurazione di upload hot folder con più hot folder. In questo esempio, ci sono due hot folder.

    1. La prima hot folder è impostata per controllare la Media/drive cartella. Quando i file vengono aggiunti a questa cartella, verranno avviati due caricamenti, uno utilizzando la configurazione example1 remota e l'altro utilizzando la configurazione example2 remota. Ogni caricamento utilizzerà i rispettivis3_destination_folder.

    2. La seconda hot folder è impostata per controllare la /Users/user1/myhotfolder cartella. Quando i file vengono aggiunti a questa cartella, inizierà un singolo caricamento, utilizzando la configurazione another_configuration remota. Tutti i file verranno caricati nella example_folder cartella in Amazon S3.

    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. Salva il file di configurazione.

    Nota

    Quando si avvia il demone o quando vengono aggiunte/aggiornate le hot folder, verrà avviato un caricamento forzato automatico per l'intera cartella. Se non si preferisce questo comportamento, è possibile aprire la GUI e annullare il processo.

Scarica i file

Con i seguenti comandi, puoi scaricare i file dal bucket S3 corrispondente che hai impostato nel tuo file di configurazione. Puoi eseguire questi comandi da qualsiasi punto del computer. Ti consigliamo di eseguire questi comandi da root.

File Transfernon è possibile effettuare il download direttamente dalle classi di archiviazione Deep Archive o Glacier. Questo perché sono archiviate in un sistema diverso. Questi tipi di oggetti richiedono un metodo diverso per recuperare i file. Per ulteriori informazioni sul recupero di oggetti da sistemi diversi, vedere Ripristino di un oggetto archiviato. Per ulteriori informazioni sulle classi di storage, consulta Amazon S3 Storage Classes.

Nota

Ti consigliamo di disabilitare la modalità di sospensione sul tuo computer locale. Se il computer attiva la modalità di sospensione, i trasferimenti in corso potrebbero essere interrotti. In Impostazioni, attiva Disabilita sospensione (solo macOS).

Per avviare i download utilizzando la CLI

  1. Apri un terminale.

  2. (Consigliato) Accedere alla cartella in cui si desidera scaricare i file.

  3. Esegui il seguente comando da qualsiasi punto del tuo computer per scaricare file da Amazon S3 sul tuo computer. 

    filetransfer download [transfer profile]
                  [relative path]

    1. Sostituisci [profilo di trasferimento] con il profilo di trasferimento che desideri utilizzare.

    2. Sostituisci [percorso relativo] con il percorso in cui desideri scaricare i file.

      1. Un percorso relativo non inizia con una / (barra). Esempio: Users/username/Desktop/folder1

      2. Non utilizzare un percorso assoluto. Un percorso di file assoluto inizia con una / (barra). Esempio: /Users/username/Desktop/folder1

    3. Comando di esempio: filetransfer download [transfer profile name] /Users/username/Desktop/folder1

File Transfercontrolla il File Transfer database locale per verificare se il file selezionato è già stato scaricato.

Flag

È possibile aggiungere delle bandiere alla fine di un comando per eseguire determinate azioni. L'uso delle bandiere è facoltativo.

Flag Descrizione Esempio

--help

Elenca i flag e i comandi disponibili.

filetransfer --help

--checksum-algorithm

Definisce quale calcolo del checksum viene eseguito. File Transfer Valori supportati:md5, XXHashXXHash64, e. XXH3

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

--enable-metadata-filter

Se utilizzato, File Transfer filtra automaticamente i file di metadati di sistema. Questi file includono Thumbs.db.DS_Store, e file che iniziano con ._.

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

--filter

Filtra i file che vengono trasferiti in base al loro formato. Il campo del filtro accetta espressioni regolari valide. Esempio: trasferisce ^.*\.(mov)$ solo i file che terminano con.mov. È possibile aggiungere filtri al file di configurazione per eseguire determinate azioni. Quando aggiungi filtri alla configurazione invece di usarli come flag su comandi specifici, File Transfer applica l'azione a tutti i trasferimenti.

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

Questo comando scaricherà solo i file in .mov formato.

--force

Forza un trasferimento indipendentemente dai filtri o dai conflitti. Per impostazione predefinita, File Transfer non trasferisce file trasferiti in precedenza.

Il flag force fa sì che File Transfer vengano ignorati eventuali filtri o conflitti. Questa funzione è utile se hai cancellato accidentalmente un file che devi scaricare.

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

--max-age

Trasferisci solo i file che sono stati creati o modificati in una finestra temporale che termina all'ora corrente. Se non viene fornita alcuna unità, l'età massima sarà espressa in secondi. Ad esempio, 2d scaricherà i file degli ultimi due giorni e 3500 caricherà i file degli ultimi 3500 secondi.

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

Il comando precedente scaricherà solo i file nel bucket S3 degli ultimi 2 giorni.

--retry-count

Se si verifica un errore, File Transfer tenterà di trasferire i file tante volte quanto il numero di tentativi.

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

--chunk-size

Dimensione del blocco in MB (impostazione predefinita 25)

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

--sintonizzazione automatica

Consenti allo strumento di decidere i migliori valori di configurazione per ottimizzare il trasferimento

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

--max-active-checksums

Numero massimo di checksum attivi (impostazione predefinita 1)

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

--max-active-transfers

Numero massimo di trasferimenti

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

--prefix

Percorso del prefisso S3 per caricamenti e download

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

--profile

AWS profilo denominato

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

--threads

Numero di thread per download (impostazione predefinita 10)

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

FILETRANSFER_CONFIG_DIR

Sostituisce la cartella predefinita. .filetransfer

Questa variabile può definire qualsiasi directory in cui memorizzare il file di configurazione e il file di database. Se FILETRANSFER_CONFIG_DIR non è impostata, viene utilizzato il valore predefinito~/.filetransfer,. I file devono essere ancora denominati configuration.yaml oconfiguration.yaml, echecksum-cache.db. Se non esistono, vengono creati.

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