Exemple : créer un déclencheur AWS CodeCommit pour une AWS Lambda fonction existante

Ouvrez un éditeur de texte brut et créez un JSON fichier qui spécifie le nom de la fonction Lambda, les détails du CodeCommit référentiel et les actions que vous souhaitez autoriser dans Lambda, comme suit :

{
    "FunctionName": "MyCodeCommitFunction", 
    "StatementId": "1", 
    "Action": "lambda:InvokeFunction", 
    "Principal": "codecommit.amazonaws.com", 
    "SourceArn": "arn:aws:codecommit:us-east-1:111122223333:MyDemoRepo", 
    "SourceAccount": "111122223333"
}

Enregistrez le fichier sous forme de JSON fichier avec un nom facile à mémoriser (par exemple, AllowAccessfromMyDemoRepo.json).

À l'aide du JSON fichier que vous venez de créer, sur le terminal (Linux, macOS ou Unix) ou sur la ligne de commande (Windows), exécutez la aws lambda add-permissions commande pour ajouter une autorisation à la politique de ressources associée à votre fonction Lambda :

aws lambda add-permission --cli-input-json file://AllowAccessfromMyDemoRepo.json

Cette commande renvoie la déclaration JSON de politique que vous venez d'ajouter, comme suit :

{
    "Statement": "{\"Condition\":{\"StringEquals\":{\"AWS:SourceAccount\":\"111122223333\"},\"ArnLike\":{\"AWS:SourceArn\":\"arn:aws:codecommit:us-east-1:111122223333:MyDemoRepo\"}},\"Action\":[\"lambda:InvokeFunction\"],\"Resource\":\"arn:aws:lambda:us-east-1:111122223333:function:MyCodeCommitFunction\",\"Effect\":\"Allow\",\"Principal\":{\"Service\":\"codecommit.amazonaws.com\"},\"Sid\":\"1\"}"
}

Pour plus d'informations sur les politiques de ressources pour les fonctions Lambda, consultez la section Les modèles AddPermissiond'événements Pull/Push du guide de l'utilisateur.AWS Lambda

Connectez-vous à la IAM console AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/iam/.

Dans le volet de navigation du tableau de bord, sélectionnez Rôles, puis dans la liste des rôles, sélectionnez lambda_basic_execution.

Sur la page récapitulative pour le rôle, sélectionnez l'onglet Autorisations, et dans Stratégies en ligne, choisissez Créer une stratégie de rôle.

Sur la page Réglez les permissions, choisissez Générateur de stratégies, puis Sélectionner.

Sur la page Edit Permissions, procédez comme suit :

Cliquez sur Ajouter une instruction, puis sur Étape suivante.

Sur la page Review Policy (Réviser la stratégie), sélectionnez Apply Policy (Appliquer la stratégie).

Votre déclaration de stratégie doit être similaire à l'exemple suivant :

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "Stmt11111111",
            "Effect": "Allow",
            "Action": [
                "codecommit:GetRepository"
            ],
            "Resource": [
                "arn:aws:codecommit:us-east-1:111122223333:MyDemoRepo"
            ]
        }
    ]
}

Ouvrez la CodeCommit console sur https://console.aws.amazon.com/codesuite/codecommit/home.

Dans Référentiels, sélectionnez le référentiel dans lequel vous souhaitez créer des déclencheurs pour des événements de référentiel.

Dans le volet de navigation pour le référentiel, choisissez Paramètres, puis Déclencheurs.

Choisissez Create trigger.

Sur la page Créer un déclencheur, procédez comme suit :

(Facultatif) Choisissez Test trigger (Tester le déclencheur). Cette option essaie d'appeler la fonction avec des exemples de données sur votre référentiel, notamment l'ID de la validation la plus récente pour le référentiel. (Si aucun historique n'existe, des exemples de valeurs constitués de zéros sont générés à la place.) Cela vous permet de vérifier que vous avez correctement configuré l'accès entre CodeCommit et la fonction Lambda.

Choisissez Create trigger (Créer un déclencheur) afin de finaliser la création du déclencheur.

Pour vérifier les fonctionnalités du déclencheur, créez une validation et transmettez-la vers le référentiel où vous avez configuré le déclencheur. Vous devriez voir une réponse de la fonction Lambda dans l'onglet Surveillance pour cette fonction dans la console Lambda.

Ouvrez un éditeur de texte brut et créez un JSON fichier qui spécifie :

Enregistrez le fichier.

Par exemple, si vous souhaitez créer un déclencheur pour un référentiel nommé MyDemoRepo qui publie tous les événements du référentiel dans une fonction Lambda nommée MyCodeCommitFunction pour deux succursales, main and preprod:

{
    "repositoryName": "MyDemoRepo",
    "triggers": [
        {
            "name": "MyLambdaFunctionTrigger",
            "destinationArn": "arn:aws:lambda:us-east-1:111122223333:function:MyCodeCommitFunction",
            "customData": "",
            "branches": [
                "main", "preprod"
            ],
            "events": [
                "all"
            ]
        }
    ]
}

Il doit y avoir un bloc de déclenchement dans le déclencheur JSON pour chaque déclencheur d'un référentiel. Pour créer plusieurs déclencheurs pour un référentiel, incluez des blocs supplémentaires dans leJSON. N'oubliez pas que tous les déclencheurs créés dans ce fichier sont pour le référentiel spécifié. Vous ne pouvez pas créer de déclencheurs pour plusieurs référentiels dans un seul JSON fichier. Par exemple, si vous souhaitez créer deux déclencheurs pour un référentiel, vous pouvez créer un JSON fichier avec deux blocs de déclencheurs. Dans l'exemple suivant, aucune branche n'est spécifiée dans le deuxième bloc de déclencheur ; le déclencheur s'applique donc à toutes les branches :

{
    "repositoryName": "MyDemoRepo",
    "triggers": [
        {
            "name": "MyLambdaFunctionTrigger",
            "destinationArn": "arn:aws:lambda:us-east-1:111122223333:function:MyCodeCommitFunction",
            "customData": "",
            "branches": [
                "main", "preprod"
            ],
            "events": [
                "all"
            ]
        },
        {
            "name": "MyOtherLambdaFunctionTrigger",
            "destinationArn": "arn:aws:lambda:us-east-1:111122223333:function:MyOtherCodeCommitFunction",
            "customData": "",
            "branches": [],
            "events": [
                "updateReference", "deleteReference"
            ]
        }
    ]
}

Vous pouvez créer des déclencheurs pour les événements que vous spécifiez, par exemple si une validation est transmise vers un référentiel. Les types d'événements comprennent :

Pour afficher la liste complète des types d'événement valides, depuis le terminal ou l'invite de commande, saisissez aws codecommit put-repository-triggers help.

En outre, vous pouvez inclure une chaîne customData (par exemple, un nom de IRC canal que les développeurs utilisent lorsqu'ils discutent du développement dans ce référentiel). Ce champ est une chaîne. Celle-ci ne peut pas être utilisée pour transmettre des paramètres dynamiques. Cette chaîne est ajoutée en tant qu'attribut à la chaîne CodeCommit JSON renvoyée en réponse au déclencheur.

(Facultatif) Depuis un terminal ou l'invite de commande, exécutez la commande test-repository-triggers. Par exemple, ce qui suit est utilisé pour vérifier que le JSON fichier nommé trigger.json est valide et CodeCommit peut déclencher la fonction Lambda. Ce test utilise des exemples de données pour déclencher la fonction si aucune donnée réelle n'est disponible.

aws codecommit test-repository-triggers --cli-input-json file://trigger.json

Si elle aboutit, cette commande renvoie des informations similaires à ce qui suit :

{
    "successfulExecutions": [
        "MyLambdaFunctionTrigger"
    ],
    "failedExecutions": []
}

Sur un terminal ou une invite de commande, exécutez la put-repository-triggers commande pour créer le déclencheur dans CodeCommit. Par exemple, pour utiliser un JSON fichier nommé trigger.json pour créer le déclencheur :

aws codecommit put-repository-triggers --cli-input-json file://trigger.json

Cette commande renvoie un ID de configuration semblable à ce qui suit :

{
    "configurationId": "0123456-I-AM-AN-EXAMPLE"
}

Pour afficher la configuration du déclencheur, exécutez la commande get-repository-triggers en spécifiant le nom du référentiel :

aws codecommit get-repository-triggers --repository-name MyDemoRepo

Cette commande renvoie la structure de tous les déclencheurs configurés pour le référentiel, similaire à ce qui suit :

{
    "configurationId": "0123456-I-AM-AN-EXAMPLE",
    "triggers": [
        {
            "events": [
                "all"
            ],
            "destinationArn": "arn:aws:lambda:us-east-1:111122223333:MyCodeCommitFunction",
            "branches": [
                "main",
                "preprod"
            ],
            "name": "MyLambdaFunctionTrigger",
            "customData": "Project ID 12345"
        }
    ]
}

Pour tester les fonctionnalités du déclencheur, créez une validation et transmettez-la vers le référentiel où vous avez configuré le déclencheur. Vous devriez voir une réponse de la fonction Lambda dans l'onglet Surveillance pour cette fonction dans la console Lambda.