例: 既存の AWS Lambda 関数 AWS CodeCommit のトリガーを で作成する

プレーンテキストエディタを開き、Lambda 関数名、 CodeCommit リポジトリの詳細、Lambda で許可するアクションを指定するJSONファイルを作成します。次に例を示します。

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

覚えやすい名前 (.json など) でJSONファイルとして保存しますAllowAccessfromMyDemoRepo。

先ほど作成した JSON ファイルを使用して、ターミナル (Linux、macOS、または Unix) またはコマンドライン (Windows) で aws lambda add-permissions コマンドを実行し、Lambda 関数に関連付けられたリソースポリシーにアクセス許可を追加します。

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

このコマンドは、次のように、追加したポリシーステートメントJSONの を返します。

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

Lambda 関数のリソースポリシーの詳細については、AddPermission「」および「 AWS Lambda ユーザーガイド」の「プル/プッシュイベントモデル」を参照してください。

にサインイン AWS Management Console し、 で IAMコンソールを開きますhttps://console.aws.amazon.com/iam/。

ダッシュボードナビゲーションペインでロールを選択し、ロールのリストで を選択しますlambda_basic_execution。

ロールの [Summary] ページで、[Permissions (アクセス許可)] タブを選択し、[Inline Policies (インラインポリシー)] セクションで、[Create Role Policy (ロールポリシーの作成)] を選択します。

[Set Permissions (アクセス許可の設定)] ページで、[Custom Generator (カスタムジェネレーター)] を選択し、次に [選択] をクリックします。

[Edit Permissions] ページで、以下を実行します。

[Add Statement]、[Next Step] の順に選択します。

[Review Policy] ページで、[Apply Policy] を選択します。

ポリシーステートメントは、次の例のようになります。

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

https://console.aws.amazon.com/codesuite/codecommit/home で CodeCommit コンソールを開きます。

リポジトリで、リポジトリイベントのトリガーを作成するリポジトリを選択します。

リポジトリのナビゲーションペインで、[設定] を選択し、[トリガー] を選択します。

[Create trigger (トリガーの作成)] を選択します。

[Create trigger (トリガーの作成)] で、以下の操作を行います。

(オプション) [トリガーのテスト] を選択します。このオプションでは、リポジトリの最新コミット ID など、リポジトリに関するサンプルデータを使用して、関数を呼び出します。(コミット履歴が存在しない場合は、ゼロで構成されるサンプル値が生成されます。) これにより、 CodeCommit と Lambda 関数間のアクセスが正しく設定されていることを確認できます。

[Create trigger (トリガーを作成する)] を選択して、トリガーの作成を完了します。

トリガーの機能を検証するには、コミットを作成し、トリガーを設定したリポジトリに対してプッシュします。Lambda コンソールで、Lambda 関数からの応答がその関数の [モニタリング] タブに表示されます。

プレーンテキストエディタを開き、以下を指定するJSONファイルを作成します。

ファイルを保存します。

例えば、2 つのブランチ、 mainおよび に対して、すべてのリポジトリイベントを という名前の Lambda 関数に発行MyDemoRepoする という名前のリポジトリMyCodeCommitFunctionのトリガーを作成するとしますpreprod。

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

リポジトリのトリガーJSONごとに、 にトリガーブロックが必要です。リポジトリに複数のトリガーを作成するには、 に追加のブロックを含めますJSON。このファイルに作成されたすべてのトリガーは指定されたリポジトリであることに注意してください。1 つのJSONファイルに複数のリポジトリのトリガーを作成することはできません。たとえば、リポジトリに 2 つのトリガーを作成する場合は、2 つのトリガーブロックを持つJSONファイルを作成できます。次の例では、2 番目のトリガーブロックに指定されているブランチはないため、トリガーはすべてのブランチに適用されます。

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

たとえば、コミットがリポジトリにプッシュされたときは、指定したイベントのトリガーを作成できます。イベントタイプは次のとおりです。

有効なイベントタイプのリストを一覧表示するには、ターミナルまたはコマンドプロンプトで、「aws codecommit put-repository-triggers help」と入力します。

さらに、 に文字列を含めることができます customData (たとえば、開発者がこのリポジトリで開発について話し合うときに使用する IRCチャネル名）。このフィールドは文字列です。これは動的パラメータを渡すために使用することはできません。この文字列は、トリガーに応答して返される CodeCommit JSONに属性として追加されます。

(オプション) ターミナルまたはコマンドラインプロンプトで、test-repository-triggers コマンドを実行することもできます。例えば、 という名前のJSONファイルが有効trigger.jsonで、Lambda 関数をトリガー CodeCommit できるかどうかをテストするには、以下を使用します。利用できる実際のデータがない場合、このテストでは、サンプルデータを使用して関数をトリガーします。

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

成功した場合、このコマンドは次のような情報を返します。

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

ターミナルまたはコマンドプロンプトで、put-repository-triggers コマンドを実行して CodeCommit にトリガーを作成します。たとえば、 という名前のJSONファイルを使用してトリガーtrigger.jsonを作成するには、次のようにします。

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

このコマンドでは、次のような設定 ID が返されます。

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

トリガーの設定を表示するには、get-repository-triggers コマンドを実行して、リポジトリの名前を指定します。

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

このコマンドは、リポジトリ用に構成されたすべてのトリガーの構造を、次のように戻します。

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

トリガーの機能を確認するには、コミットを作成し、トリガーを設定したリポジトリに対してプッシュします。Lambda コンソールで、Lambda 関数からの応答がその関数の [モニタリング] タブに表示されます。