Beispiel: Erstellen Sie einen Trigger AWS CodeCommit für eine bestehende AWS Lambda Funktion

Öffnen Sie einen Klartext-Editor und erstellen Sie eine JSON Datei, die den Namen der Lambda-Funktion, die Details des CodeCommit Repositorys und die Aktionen angibt, die Sie in Lambda zulassen möchten, ähnlich der folgenden:

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

Speichern Sie die Datei als JSON Datei mit einem Namen, den Sie sich leicht merken können (z. B.. json). AllowAccessfromMyDemoRepo

Führen Sie mithilfe der gerade erstellten JSON Datei im Terminal (Linux, macOS oder Unix) oder in der Befehlszeile (Windows) den aws lambda add-permissions Befehl aus, um der mit Ihrer Lambda-Funktion verknüpften Ressourcenrichtlinie eine Berechtigung hinzuzufügen:

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

Dieser Befehl gibt die JSON Richtlinienanweisung zurück, die Sie gerade hinzugefügt haben, ähnlich der folgenden:

{
    "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\"}"
}

Weitere Informationen zu Ressourcenrichtlinien für Lambda-Funktionen finden Sie unter AddPermissionund The Pull/Push Event Models im AWS Lambda Benutzerhandbuch.

Melden Sie sich bei der an AWS Management Console und öffnen Sie die IAM Konsole unter. https://console.aws.amazon.com/iam/

Wählen Sie im Navigationsbereich des Dashboards Rollen und dann in der Rollenliste die Option auslambda_basic_execution.

Wählen Sie auf der Zusammenfassungsseite für die Rolle die Registerkarte Permissions (Berechtigungen) aus und wählen Sie unter Inline Policies (Eingebundene Richtlinien) die Option Create Role Policy (Rollenrichtlinie erstellen) aus.

Wählen Sie auf der Seite Set Permissions (Berechtigungen festlegen) die Option Policy Generator (Richtliniengenerator) und dann Select (Auswählen) aus.

Führen Sie auf der Seite Edit Permissions die folgenden Schritte aus:

Wählen Sie Add Statement und anschließend Next Step aus.

Wählen Sie auf der Seite Review Policy (Richtlinie überprüfen) die Option Apply Policy (Richtlinie anwenden) aus.

Die Richtlinienanweisung sollte dann dem folgenden Beispiel ähneln:

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

Öffnen Sie die CodeCommit Konsole unter https://console.aws.amazon.com/codesuite/codecommit/home.

Wählen Sie unter Repositories (Repositorys) das Repository aus, in dem Sie Auslöser für Repository-Ereignisse erstellen möchten.

Wählen Sie im Navigationsbereich für das Repository Settings (Einstellungen) und anschließend Triggers (Auslöser).

Wählen Sie Create trigger.

Gehen Sie in Create trigger (Auslöser erstellen) wie folgt vor:

(Optional) Wählen Sie Test trigger (Auslöser testen). Damit wird die Funktion mit Beispieldaten zu Ihrem Repository, einschließlich der neuesten Commit-ID für das Repository, aufgerufen. (Falls kein Commit-Verlauf vorhanden ist, werden stattdessen aus Nullen bestehende Beispielwerte generiert.) Auf diese Weise können Sie überprüfen, ob Sie den Zugriff zwischen CodeCommit und der Lambda-Funktion korrekt konfiguriert haben.

Wählen Sie Create trigger (Auslöser erstellen), um die Erstellung des Auslösers abzuschließen.

Erstellen Sie einen Commit und übertragen Sie ihn per Push an das Repository, für das Sie den Auslöser konfiguriert haben, um die Funktion des Auslösers zu überprüfen. Sie sollten eine Antwort der Lambda-Funktion auf der Registerkarte Überwachung für diese Funktion in der Lambda-Konsole sehen.

Öffnen Sie einen Klartext-Editor und erstellen Sie eine JSON Datei, die Folgendes spezifiziert:

Speichern Sie die Datei.

Wenn Sie beispielsweise einen Trigger für ein Repository mit dem Namen erstellen möchtenMyDemoRepo, der alle Repository-Ereignisse in einer Lambda-Funktion veröffentlicht, die MyCodeCommitFunction nach zwei Branches benannt ist, main undpreprod:

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

Für jeden Trigger eines Repositorys muss ein Triggerblock enthalten sein. JSON Um mehr als einen Trigger für ein Repository zu erstellen, fügen Sie zusätzliche Blöcke in den einJSON. Beachten Sie, dass alle in dieser Datei erstellten Auslöser für das angegebene Repository gelten. Sie können keine Trigger für mehrere Repositorys in einer einzigen JSON Datei erstellen. Wenn Sie beispielsweise zwei Trigger für ein Repository erstellen möchten, können Sie eine JSON Datei mit zwei Triggerblöcken erstellen. Im folgenden Beispiel sind im zweiten Auslöserblock keine Branches angegeben, daher gilt dieser Auslöser für alle 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"
            ]
        }
    ]
}

Sie können Auslöser für bestimmte Ereignisse erstellen, z. B. wenn ein Commit per Push an ein Repository übertragen wird. Zu den Ereignistypen zählen:

Geben Sie im Terminal oder in der Eingabeaufforderung aws codecommit put-repository-triggers help ein, um eine vollständige Liste der gültigen Ereignistypen anzuzeigen.

Darüber hinaus können Sie eine Zeichenfolge hinzufügen customData (z. B. einen IRC Kanalnamen, den Entwickler verwenden, wenn sie über die Entwicklung in diesem Repository sprechen). Dies ist ein Zeichenfolgenfeld. Es kann nicht zur Übergabe dynamischer Parameter verwendet werden. Diese Zeichenfolge wird als Attribut an die als Antwort auf den Trigger CodeCommit JSON zurückgegebene Zeichenfolge angehängt.

(Optional) Führen Sie an einem Terminal oder an einer Eingabeaufforderung den Befehl test-repository-triggers aus. Mit dem Folgenden wird beispielsweise getestet, ob die angegebene JSON Datei gültig trigger.json ist und die Lambda-Funktion auslösen CodeCommit kann. Dieser Test verwendet Beispieldaten, um die Funktion auszulösen, wenn keine echten Daten vorhanden sind.

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

Bei erfolgreicher Ausführung gibt dieser Befehl etwa wie folgt aussehende Informationen zurück:

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

Führen Sie in einem Terminal oder einer Eingabeaufforderung den Befehl put-repository-triggers aus, um den Auslöser in CodeCommit zu erstellen. Um beispielsweise eine JSON Datei mit dem Namen zu verwenden, trigger.json um den Trigger zu erstellen:

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

Dieser Befehl gibt eine Konfigurations-ID wie die folgende zurück:

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

Führen Sie zum Anzeigen der Konfiguration des Auslösers den Befehl get-repository-triggers aus und geben Sie dabei den Namen des Repositorys an:

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

Dieser Befehl gibt die Struktur aller Auslöser zurück, die für das Repository konfiguriert sind, ähnlich folgendem Beispiel:

{
    "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"
        }
    ]
}

Erstellen Sie einen Commit und übertragen Sie ihn per Push an das Repository, für das Sie den Auslöser konfiguriert haben, um die Funktion des Auslösers zu prüfen. Sie sollten eine Antwort der Lambda-Funktion auf der Registerkarte Überwachung für diese Funktion in der Lambda-Konsole sehen.