View a markdown version of this page

Création d'une EventBridge règle pour une source Amazon S3 (console) - AWS CodePipeline

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'une EventBridge règle pour une source Amazon S3 (console)

Avant de configurer une règle dans EventBridge, vous devez créer une AWS CloudTrail trace. Pour plus d'informations, consultez Création d'un journal de suivi dans la console.

Important

Si vous utilisez la console pour créer ou modifier votre pipeline, votre EventBridge règle et votre AWS CloudTrail historique sont créés pour vous.

Pour créer un journal de suivi

  1. Ouvrez la AWS CloudTrail console.

  2. Dans le panneau de navigation, choisissez Journaux d'activité.

  3. Choisissez Créer un journal d'activité). Pour Trail name (Nom du journal de suivi), entrez un nom pour votre journal de suivi.

  4. Sous Storage location (Emplacement de stockage), créez ou spécifiez le compartiment à utiliser pour stocker les fichiers journaux. Par défaut, les objets et les compartiments Amazon S3 sont privés. Seul le propriétaire de la ressource (le AWS compte qui a créé le bucket) peut accéder au bucket et à ses objets. Le compartiment doit disposer d'une politique de ressources AWS CloudTrail qui autorise l'accès aux objets du compartiment.

  5. Sous Compartiment et dossier du journal Trail, spécifiez un compartiment Amazon S3 et le préfixe de l'objet (nom du dossier) pour enregistrer les événements liés aux données pour tous les objets du dossier. Pour chaque journal de suivi, vous pouvez ajouter jusqu'à 250 objets Amazon S3. Complétez les informations de clé de chiffrement requises et choisissez Suivant.

  6. Pour Type d'événement, choisissez Gestion des événements.

  7. Pour Gestion des événements, choisissez Écrire. Le journal enregistre l'activité de l'API Amazon S3 au niveau de l'objet (par exemple, GetObject etPutObject) sur le compartiment et le préfixe spécifiés.

  8. Choisissez Write (Écrire).

  9. Si vous êtes satisfait du parcours, choisissez Créer un parcours.

Pour créer une EventBridge règle qui cible votre pipeline avec une source Amazon S3

  1. Ouvrez la EventBridge console Amazon à l'adresse https://console.aws.amazon.com/events/.

  2. Dans le panneau de navigation, choisissez Rules. Laissez le bus par défaut sélectionné ou choisissez un bus d'événements. Choisissez Créer une règle.

  3. Dans Nom, entrez le nom de votre règle.

  4. Sous Type de règle, choisissez Règle avec un modèle d'événement. Choisissez Suivant.

  5. Sous Source de l'événement, choisissez AWS des événements ou des événements EventBridge partenaires.

  6. Dans Exemple de type d'événement, choisissez AWS événements.

  7. Dans Exemples d'événements, saisissez S3 comme mot clé sur lequel filtrer. Choisissez AWS l'appel API via CloudTrail.

  8. Sous Méthode de création, choisissez Customer pattern (éditeur JSON).

    Collez le modèle d'événement fourni ci-dessous. Assurez-vous d'ajouter le nom du compartiment et la clé d'objet S3 (ou nom de clé) qui identifient de manière unique l'objet du compartiment comme étantrequestParameters. Dans cet exemple, une règle est créée pour un compartiment nommé amzn-s3-demo-source-bucket et une clé d'objet demy-files.zip. Lorsque vous utilisez la fenêtre Modifier pour spécifier les ressources, votre règle est mise à jour pour utiliser un modèle événement personnalisé.

    Vous trouverez ci-dessous un exemple de modèle d'événement à copier et coller :

    {
    "source": [
        "aws.s3"
    ],
    "detail-type": [
        "AWS API Call via CloudTrail"
    ],
    "detail": {
        "eventSource": [
            "s3.amazonaws.com"
        ],
        "eventName": [
            "CopyObject",
            "CompleteMultipartUpload",
            "PutObject"
        ],
        "requestParameters": {
            "bucketName": [
                "amzn-s3-demo-source-bucket"
            ],
            "key": [
                "my-files.zip"
            ]
        }
    }
}

  9. Choisissez Suivant.

  10. Dans Types de cibles, choisissez AWS service.

  11. Dans Sélectionnez une cible, choisissez CodePipeline. Dans Pipeline ARN, entrez l'ARN du pipeline pour le pipeline à démarrer selon cette règle.

    Note

    Pour l'obtenir l'ARN de pipeline, exécutez la commande get-pipeline. L'ARN de pipeline apparaît dans la sortie. Il est créé dans ce format :

    arn:aws:codepipeline : : : region account pipeline-name

    Exemple d'ARN de pipeline :

    arn:aws:codepipeline:us-east- 2:80398 EXAMPLE:MyFirstPipeline

  12. Pour créer ou spécifier un rôle de service IAM qui accorde EventBridge des autorisations pour appeler la cible associée à votre EventBridge règle (dans ce cas, la cible est CodePipeline) :

    • Choisissez Créer un nouveau rôle pour cette ressource spécifique afin de créer un rôle de service qui donne EventBridge les autorisations nécessaires pour démarrer les exécutions de votre pipeline.

    • Choisissez Utiliser le rôle existant pour saisir un rôle de service qui autorise EventBridge le démarrage des exécutions de votre pipeline.

  13. (Facultatif) Pour spécifier des remplacements de source avec un ID d'image spécifique, utilisez le transformateur d'entrée pour transmettre les données sous forme de paramètres JSON. Vous pouvez également utiliser le transformateur d'entrée pour transmettre les variables du pipeline.

    • Développer Additional settings (Paramètres supplémentaires).

      Sous Configurer l'entrée cible, choisissez Configurer le transformateur d'entrée.

      Dans la fenêtre de dialogue, choisissez Enter my own. Dans la zone Chemin d'entrée, tapez les paires clé-valeur suivantes.

      {"revisionValue": "$.detail.object.version-id"}

    • Dans la zone Modèle, tapez les paires clé-valeur suivantes.

      
                                
                                {
    "sourceRevisions": [
        {
            "actionName": "Source",
            "revisionType": "S3_OBJECT_VERSION_ID",
            "revisionValue": "<revisionValue>"
        }
    ],
     "variables": [
        {
            "name": "Variable_Name",
            "value": "Variable_Value"
        }
    ]
}

    • Choisissez Confirmer.

  14. Choisissez Suivant.

  15. Sur la page Tags, choisissez Next.

  16. Sur la page Réviser et créer, passez en revue la configuration des règles. Si la règle vous convient, choisissez Créer une règle.