Transférer des fichiers à l'aide de l'interface de ligne de commande (CLI) - Transfert de fichiers Nimble Studio
Chargement de fichiersConfiguration des hot foldersTélécharger des fichiers

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Transférer des fichiers à l'aide de l'interface de ligne de commande (CLI)

Les sections suivantes expliquent comment charger, télécharger et configurer des hot folders à l'File Transferaide de l'interface de ligne de commande (CLI).

Chargement de fichiers

Les commandes suivantes concernent l'interface de ligne de commande (CLI). Ces commandes vous permettent de télécharger des fichiers depuis le compartiment S3 correspondant que vous avez configuré dans votre fichier de configuration. Vous pouvez exécuter ces commandes depuis n'importe quel emplacement de votre ordinateur. Cependant, nous vous recommandons d'exécuter ces commandes depuis root.

File Transferpréserve la structure de dossiers que vous lui donnez. Cela signifie que la structure du dossier reste la même une fois qu'il atteint Amazon S3. Cependant, vous ne pouvez pas donner de chemin File Transfer absolu. Cela signifie que le chemin du fichier ne peut pas commencer par une / (barre oblique).

File Transfertéléchargements vers toutes les classes de stockage S3. Pour plus d'informations sur les classes de stockage, consultez Classes de stockage Amazon S3.

Note

Nous vous recommandons de désactiver le mode veille sur votre ordinateur local. Si votre ordinateur active le mode veille, les transferts en cours peuvent être interrompus. Dans Réglages, activez l'option Désactiver le mode veille (macOS uniquement).

Pour démarrer les téléchargements à l'aide de la CLI

  1. Ouvrez un terminal .

  2. (Recommandé) Accédez au dossier contenant les fichiers et dossiers que vous souhaitez télécharger.

  3. Exécutez la commande suivante depuis n'importe où sur votre ordinateur pour télécharger des fichiers depuis votre machine locale vers Amazon S3. 

    filetransfer upload [transfer profile] [relative path]

    1. Remplacez [profil de transfert] par le profil de transfert que vous souhaitez utiliser.

    2. Remplacez [chemin relatif] par le chemin du fichier ou du répertoire que vous souhaitez télécharger.

      1. Un chemin relatif ne commence pas par une / (barre oblique). Exemple : Users/username/Desktop/folder1

      2. N'utilisez pas de chemin absolu. Un chemin de fichier absolu commence par une / (barre oblique). Exemple : /Users/username/Desktop/folder1

    3. Exemple de commande : filetransfer upload [transfer profile name] /Users/username/Desktop/folder1

File Transferfonctionne File Transfersommes de contrôle sur vos fichiers. La somme de contrôle est utilisée pour une vérification supplémentaire de l'intégrité des fichiers, afin de détecter si un fichier a été modifié de manière inattendue. Une fois ces checksums terminés, les transferts commencent. Si vous fournissez votre propre liste de hachage multimédia (MHL), vous File Transfer pouvez vérifier que vos fichiers correspondent à la somme de contrôle définie dans la MHL. Le MHL est un fichier XML qui contient souvent des séquences de caméra brutes.

Indicateurs

Pour effectuer certaines actions, vous pouvez ajouter des drapeaux à la fin d'une commande. L'utilisation de drapeaux est facultative.

Indicateur Description Exemple

--help

Répertoriez les drapeaux et les commandes disponibles.

filetransfer --help

--checksum - algorithme

Définissez le calcul File Transfer de la somme de contrôle effectué. Valeurs prises en charge : md5XXHash,XXHash64, etXXH3.

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

--enable-metadata-filter

Lorsqu'il est utilisé, File Transfer filtre automatiquement les fichiers de métadonnées du système. Ces fichiers incluent Thumbs.db.DS_Store, et les fichiers commençant par ._.

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

--filtre

Filtrez les fichiers transférés en fonction de leur format. Le champ de filtre accepte les expressions régulières valides. Exemple : transfère ^.*\.(mov)$ uniquement les fichiers se terminant par.mov. Des filtres peuvent être ajoutés au fichier de configuration pour effectuer certaines actions. Lorsque vous ajoutez des filtres à la configuration au lieu de les utiliser comme indicateurs sur des commandes spécifiques, File Transfer applique l'action à tous les transferts.

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

Cette commande ne téléchargera que les fichiers au .mov format.

--force

Forcez un transfert indépendamment des filtres ou des conflits. Par défaut, les fichiers précédemment transférés File Transfer ne seront pas transférés.

Le drapeau de force fait File Transfer ignorer les filtres ou les conflits. Cette fonction est utile si vous avez accidentellement supprimé un fichier à télécharger.

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

--âge maximal

Transférez uniquement les fichiers créés ou modifiés au cours d'une période se terminant à l'heure actuelle. Si aucune unité n'est fournie, l'âge maximum sera exprimé en secondes. Par exemple, 2d téléchargera les fichiers des deux derniers jours et 3500 téléchargera les fichiers des 3500 dernières secondes.

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

La commande ci-dessus ne téléchargera dans le compartiment S3 que les fichiers des 2 derniers jours.

--nombre de réessais

En cas d'erreur, File Transfer tentera de transférer vos fichiers autant de fois que le nombre de nouvelles tentatives sera atteint.

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

--taille du morceau

Taille du morceau en Mo (25 par défaut)

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

--réglage automatique

Permettre à l'outil de déterminer les meilleures valeurs de configuration pour optimiser le transfert

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

--max-active-checksums

Nombre maximum de checksums actifs (1 par défaut). Ce drapeau n'est valable que pour les téléchargements.

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

--max-active-transfers

Nombre maximum de transferts

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

--préfixe

Chemin du préfixe S3 pour les chargements et les téléchargements

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

--profile

AWS profil nommé

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

--fils

Nombre de fils par téléchargement (10 par défaut)

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

FILETRANSFER_CONFIG_DIR

Remplace le .filetransfer dossier par défaut.

Cette variable peut définir n'importe quel répertoire pour stocker le fichier de configuration et le fichier de base de données. Si FILETRANSFER_CONFIG_DIR ce n'est pas le cas~/.filetransfer, la valeur par défaut est utilisée. Les fichiers doivent toujours être nommés configuration.yaml ouconfiguration.yaml, etchecksum-cache.db. S'ils n'existent pas, ils sont créés.

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

Configuration des hot folders

Pour configurer le hot folder de téléchargement à l'aide de la CLI.

  1. Ouvrez le fichier de configuration avec n'importe quel logiciel d'édition de texte installé sur votre ordinateur.

    1. Windows : accédez au User/<your username> dossier sur votre ordinateur. Ouvrez le .filetransfer dossier et ouvrez le filetransfer.yaml fichier dans un éditeur de texte.

    2. macOS: EntrezCmd+Shift+G. Entrez ensuite~/.filetransfer. Ouvrez le fichier filetransfer.yaml avec un éditeur de texte.

    3. Linux : ouvrez le filetransfer.yaml fichier à l'aide de n'importe quel éditeur de texte. Le fichier se trouve dans~/.filetransfer/configuration.yaml.

  2. Créez une nouvelle hot_folder section avec les champs suivants

    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. Le hot folder ne sera actif que enabled s'il est défini sur true.

  4. Remplacez local_source_folder par l'emplacement du dossier que vous souhaitez surveiller. File Transfer Le chemin du fichier doit contenir le chemin complet : C:\path\to\upload-hot-folder (Windows) ou /path/to/upload-hot-folder (Linux&macOS).

  5. Sous remote_configurations :

    1. Remplacez remote_configuration_name par le nom de la configuration distante que vous souhaitez utiliser. Vous trouverez les configurations de votre télécommande dans la liste ci-dessousprotocols.s3.transfer_profiles.

    2. (Facultatif) Remplacez s3_destination_folder par le dossier de destination S3 dans lequel vous souhaitez télécharger les fichiers. File Transfercréera le dossier dans Amazon S3 s'il n'existe pas déjà. Les fichiers seront placés à la racine du compartiment si la valeur n'est pas définie.

    3. (Facultatif) Vous pouvez ajouter ici autant d'entrées de configuration à distance que vous le souhaitez, et le hot folder lancera un téléchargement à l'aide de chaque configuration à distance. Cela vous permet de définir un seul hot folder qui sera chargé dans plusieurs compartiments.

  6. L'exemple suivant est une configuration de hot folder de téléchargement avec plusieurs hot folders. Dans cet exemple, il existe deux dossiers actifs.

    1. Le premier hot folder est configuré pour surveiller le Media/drive dossier. Lorsque des fichiers sont ajoutés à ce dossier, deux téléchargements démarrent, l'un utilisant la configuration example1 à distance et l'autre utilisant la configuration example2 à distance. Chaque téléchargement utilisera son équivalents3_destination_folder.

    2. Le deuxième hot folder est configuré pour surveiller le /Users/user1/myhotfolder dossier. Lorsque des fichiers sont ajoutés à ce dossier, un seul téléchargement est lancé, en utilisant la configuration another_configuration à distance. Tous les fichiers seront chargés dans le example_folder dossier d'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. Enregistrez le fichier de configuration.

    Note

    Lorsque vous démarrez le daemon ou lorsque des dossiers actifs sont ajoutés/mis à jour, un téléchargement forcé automatique est lancé pour l'ensemble du dossier. Si vous ne préférez pas ce comportement, vous pouvez ouvrir l'interface graphique et annuler la tâche.

Télécharger des fichiers

Les commandes suivantes vous permettent de télécharger des fichiers depuis le compartiment S3 correspondant que vous avez configuré dans votre fichier de configuration. Vous pouvez exécuter ces commandes depuis n'importe quel emplacement de votre ordinateur. Nous vous recommandons d'exécuter ces commandes depuis root.

File TransferImpossible de télécharger directement depuis les classes de stockage Deep Archive ou Glacier. Cela est dû au fait qu'ils sont stockés dans un système différent. Ces types d'objets nécessitent une méthode différente pour récupérer les fichiers. Pour plus d'informations sur la récupération d'objets provenant de différents systèmes, voir Restauration d'un objet archivé. Pour plus d'informations sur les classes de stockage, consultez Classes de stockage Amazon S3.

Note

Nous vous recommandons de désactiver le mode veille sur votre ordinateur local. Si votre ordinateur active le mode veille, les transferts en cours peuvent être interrompus. Dans Réglages, activez l'option Désactiver le mode veille (macOS uniquement).

Pour démarrer les téléchargements à l'aide de la CLI

  1. Ouvrez un terminal .

  2. (Recommandé) Accédez au dossier dans lequel vous souhaitez télécharger vos fichiers.

  3. Exécutez la commande suivante depuis n'importe où sur votre ordinateur pour télécharger des fichiers depuis Amazon S3 sur votre ordinateur. 

    filetransfer download [transfer profile]
                  [relative path]

    1. Remplacez [profil de transfert] par le profil de transfert que vous souhaitez utiliser.

    2. Remplacez [chemin relatif] par le chemin vers lequel vous souhaitez télécharger vos fichiers.

      1. Un chemin relatif ne commence pas par une / (barre oblique). Exemple : Users/username/Desktop/folder1

      2. N'utilisez pas de chemin absolu. Un chemin de fichier absolu commence par une / (barre oblique). Exemple : /Users/username/Desktop/folder1

    3. Exemple de commande : filetransfer download [transfer profile name] /Users/username/Desktop/folder1

File Transfervérifie dans la File Transfer base de données locale si le fichier que vous avez sélectionné a déjà été téléchargé.

Indicateurs

Des drapeaux peuvent être ajoutés à la fin d'une commande afin d'effectuer certaines actions. L'utilisation de drapeaux est facultative.

Indicateur Description Exemple

--help

Répertoriez les drapeaux et les commandes disponibles.

filetransfer --help

--checksum - algorithme

Définissez le calcul File Transfer de la somme de contrôle effectué. Valeurs prises en charge : md5XXHash,XXHash64, etXXH3.

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

--enable-metadata-filter

Lorsqu'il est utilisé, File Transfer filtre automatiquement les fichiers de métadonnées du système. Ces fichiers incluent Thumbs.db.DS_Store, et les fichiers commençant par ._.

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

--filtre

Filtrez les fichiers transférés en fonction de leur format. Le champ de filtre accepte les expressions régulières valides. Exemple : transfère ^.*\.(mov)$ uniquement les fichiers se terminant par.mov. Des filtres peuvent être ajoutés au fichier de configuration pour effectuer certaines actions. Lorsque vous ajoutez des filtres à la configuration au lieu de les utiliser comme indicateurs sur des commandes spécifiques, File Transfer applique l'action à tous les transferts.

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

Cette commande télécharge uniquement les fichiers .mov formatés.

--force

Forcez un transfert indépendamment des filtres ou des conflits. Par défaut, les fichiers précédemment transférés File Transfer ne seront pas transférés.

Le drapeau de force fait File Transfer ignorer les filtres ou les conflits. Cette fonction est utile si vous avez accidentellement supprimé un fichier à télécharger.

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

--âge maximal

Transférez uniquement les fichiers créés ou modifiés au cours d'une période se terminant à l'heure actuelle. Si aucune unité n'est fournie, l'âge maximum sera exprimé en secondes. Par exemple, 2d téléchargera les fichiers des deux derniers jours et 3500 téléchargera les fichiers des 3500 dernières secondes.

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

La commande ci-dessus téléchargera uniquement les fichiers des 2 derniers jours dans le compartiment S3.

--nombre de réessais

En cas d'erreur, File Transfer tentera de transférer vos fichiers autant de fois que le nombre de nouvelles tentatives sera atteint.

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

--taille du morceau

Taille du morceau en Mo (25 par défaut)

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

--réglage automatique

Permettre à l'outil de déterminer les meilleures valeurs de configuration pour optimiser le transfert

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

--max-active-checksums

Nombre maximum de checksums actifs (1 par défaut)

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

--max-active-transfers

Nombre maximum de transferts

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

--préfixe

Chemin du préfixe S3 pour les chargements et les téléchargements

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

--profile

AWS profil nommé

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

--fils

Nombre de fils par téléchargement (10 par défaut)

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

FILETRANSFER_CONFIG_DIR

Remplace le .filetransfer dossier par défaut.

Cette variable peut définir n'importe quel répertoire pour stocker le fichier de configuration et le fichier de base de données. Si FILETRANSFER_CONFIG_DIR ce n'est pas le cas~/.filetransfer, la valeur par défaut est utilisée. Les fichiers doivent toujours être nommés configuration.yaml ouconfiguration.yaml, etchecksum-cache.db. S'ils n'existent pas, ils sont créés.

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