Création d'un flux de travail - AWS Transfer Family
Configuration et exécution d'un flux de travailAfficher les détails du flux de travail

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.

Création d'un flux de travail

Vous pouvez créer un flux de travail géré à l'aide du AWS Management Console, comme décrit dans cette rubrique. Pour faciliter au maximum le processus de création du flux de travail, des panneaux d'aide contextuels sont disponibles pour la plupart des sections de la console.

Un flux de travail comporte deux types d'étapes :

  • Étapes nominales — Les étapes nominales sont des étapes de traitement de fichiers que vous souhaitez appliquer aux fichiers entrants. Si vous sélectionnez plusieurs étapes nominales, chaque étape est traitée selon une séquence linéaire.

  • Étapes de gestion des exceptions — Les gestionnaires d'exceptions sont des étapes de traitement de fichiers qui AWS Transfer Family s'exécutent en cas d'échec d'une étape nominale ou d'erreur de validation.

Création d'un flux de travail

  1. Ouvrez la AWS Transfer Family console à l'adresse https://console.aws.amazon.com/transfer/.

  2. Dans le volet de navigation de gauche, sélectionnez Workflows.

  3. Sur la page Flux de travail, choisissez Créer un flux de travail.

  4. Sur la page Créer un flux de travail, entrez une description. Cette description apparaît sur la page Workflows.

  5. Dans la section Étapes nominales, choisissez Ajouter une étape. Ajoutez une ou plusieurs étapes.

    1. Choisissez un type d'étape parmi les options disponibles. Pour plus d'informations sur les différents types d'étapes, consultezUtiliser des étapes prédéfinies.

    2. Choisissez Next, puis configurez les paramètres de l'étape.

    3. Choisissez Next, puis passez en revue les détails de l'étape.

    4. Choisissez Créer une étape pour ajouter l'étape et continuer.

    5. Continuez à ajouter des étapes selon vos besoins. Le nombre maximal d'étapes d'un flux de travail est de 8.

    6. Après avoir ajouté toutes les étapes nominales nécessaires, faites défiler la page vers le bas jusqu'à la section Gestionnaires d'exceptions — facultatif, puis choisissez Ajouter une étape.

      Note

      Pour être informé des défaillances en temps réel, nous vous recommandons de configurer des gestionnaires d'exceptions et des étapes à exécuter en cas d'échec de votre flux de travail.

  6. Pour configurer les gestionnaires d'exceptions, ajoutez des étapes de la même manière que celle décrite précédemment. Si un fichier entraîne le lancement d'une exception par une étape, vos gestionnaires d'exceptions sont invoqués un par un.

  7. (Facultatif) Faites défiler la page jusqu'à la section Balises et ajoutez des balises pour votre flux de travail.

  8. Passez en revue la configuration, puis choisissez Créer un flux de travail.

    Important

    Une fois que vous avez créé un flux de travail, vous ne pouvez pas le modifier. Veillez donc à examiner attentivement la configuration.

Configuration et exécution d'un flux de travail

Avant de pouvoir exécuter un flux de travail, vous devez l'associer à un serveur Transfer Family.

Pour configurer Transfer Family afin d'exécuter un flux de travail sur les fichiers téléchargés

  1. Ouvrez la AWS Transfer Family console à l'adresse https://console.aws.amazon.com/transfer/.

  2. Dans le volet de navigation de gauche, choisissez Servers.

    • Pour ajouter le flux de travail à un serveur existant, choisissez le serveur que vous souhaitez utiliser pour votre flux de travail.

    • Vous pouvez également créer un nouveau serveur et y ajouter le flux de travail. Pour de plus amples informations, veuillez consulter Configuration d'un point SFTP de FTPS terminaison ou d'FTPun serveur.

  3. Sur la page de détails du serveur, faites défiler la page vers le bas jusqu'à la section Détails supplémentaires, puis choisissez Modifier.

    Note

    Par défaut, aucun flux de travail n'est associé aux serveurs. Vous utilisez la section Détails supplémentaires pour associer un flux de travail au serveur sélectionné.

  4. Sur la page Modifier les informations supplémentaires, dans la section Flux de travail gérés, sélectionnez un flux de travail à exécuter sur tous les téléchargements.

    Note

    Si vous n'avez pas encore de flux de travail, choisissez Créer un nouveau flux de travail pour en créer un.

    1. Choisissez l'ID de flux de travail à utiliser.

    2. Choisissez un rôle d'exécution. C'est le rôle que Transfer Family assume lors de l'exécution des étapes du flux de travail. Pour de plus amples informations, veuillez consulter IAMpolitiques relatives aux flux de travail. Choisissez Save (Enregistrer).

Note

Si vous ne souhaitez plus qu'un flux de travail soit associé au serveur, vous pouvez supprimer l'association. Pour plus de détails, consultez Supprimer un flux de travail d'un serveur Transfer Family.

Pour exécuter un flux de travail

Pour exécuter un flux de travail, vous devez télécharger un fichier sur un serveur Transfer Family que vous avez configuré avec un flux de travail associé.

Note

Chaque fois que vous supprimez un flux de travail d'un serveur et que vous le remplacez par un nouveau, ou que vous mettez à jour la configuration du serveur (ce qui a un impact sur le rôle d'exécution d'un flux de travail), vous devez attendre environ 10 minutes avant d'exécuter le nouveau flux de travail. Le serveur Transfer Family met en cache les détails du flux de travail et met 10 minutes au serveur pour actualiser son cache.

En outre, vous devez vous déconnecter de toutes les SFTP sessions actives, puis vous reconnecter après la période d'attente de 10 minutes pour voir les modifications.

# Execute a workflow
> sftp bob@s-1234567890abcdef0.server.transfer.us-east-1.amazonaws.com

Connected to s-1234567890abcdef0.server.transfer.us-east-1.amazonaws.com.
sftp> put doc1.pdf
Uploading doc1.pdf to /DOC-EXAMPLE-BUCKET/home/users/bob/doc1.pdf
doc1.pdf                                                                    100% 5013KB 601.0KB/s   00:08    
sftp> exit
>

Une fois que votre fichier a été chargé, l'action définie est exécutée sur votre fichier. Par exemple, si votre flux de travail contient une étape de copie, le fichier est copié à l'emplacement que vous avez défini à cette étape. Vous pouvez utiliser Amazon CloudWatch Logs pour suivre les étapes exécutées et leur statut d'exécution.

Afficher les détails du flux de travail

Vous pouvez consulter les détails relatifs aux flux de travail créés précédemment ou aux exécutions de flux de travail. Pour afficher ces informations, vous pouvez utiliser la console ou le AWS Command Line Interface (AWS CLI).

Console
Afficher les détails du flux de travail

  1. Ouvrez la AWS Transfer Family console à l'adresse https://console.aws.amazon.com/transfer/.

  2. Dans le volet de navigation de gauche, sélectionnez Workflows.

  3. Sur la page Flux de travail, choisissez un flux de travail.

    La page des détails du flux de travail s'ouvre.

CLI

Pour afficher les détails du flux de travail, utilisez la describe-workflow CLI commande, comme indiqué dans l'exemple suivant. Remplacez l'ID du flux w-1234567890abcdef0 de travail par votre propre valeur. Pour plus d'informations, voir describe-workflow dans la référence des AWS CLI commandes.

# View Workflow details
> aws transfer describe-workflow --workflow-id w-1234567890abcdef0
{
    "Workflow": {
        "Arn": "arn:aws:transfer:us-east-1:111122223333:workflow/w-1234567890abcdef0",
        "WorkflowId": "w-1234567890abcdef0",
        "Name": "Copy file to shared_files",
        "Steps": [
            {
                "Type": "COPY",
                "CopyStepDetails": {
                "Name": "Copy to shared",
                "FileLocation": {
                    "S3FileLocation": {
                        "Bucket": "DOC-EXAMPLE-BUCKET",
                        "Key": "home/shared_files/"
                    }
                }
                }
            }
        ],
        "OnException": {}
    }
}

Si votre flux de travail a été créé dans le cadre d'une AWS CloudFormation pile, vous pouvez le gérer à l'aide de la AWS CloudFormation console (https://console.aws.amazon.com/cloudformation).