手动配置权限 CodeCommit 以允许运行 Lambda 函数在 CodeCommit存储库（控制台）中为 Lambda 函数创建触发器为 CodeCommit存储库创建 Lambda 函数的触发器 () AWS CLI

示例：在 AWS CodeCommit 中为现有的 AWS Lambda 函数创建触发器

创建调用 Lambda 函数的触发器的最简单的方法是在 Lambda 控制台中创建该触发器。这种内置集成可确保 CodeCommit 拥有运行该函数所需的权限。要为现有 Lambda 函数添加触发器，请转到 Lambda 控制台，然后选择该函数。在该函数的触发器选项卡上，按照添加触发器中的步骤操作。这些步骤类似于创建 Lambda 函数中的步骤。

您还可以在存储库中为 Lambda 函数创建触发器。 CodeCommit 为此，您需要选择要调用的现有 Lambda 函数。它还要求您手动配置运行该函数 CodeCommit 所需的权限。

主题

手动配置权限 CodeCommit 以允许运行 Lambda 函数
在 CodeCommit存储库（控制台）中为 Lambda 函数创建触发器
为 CodeCommit存储库创建 Lambda 函数的触发器 () AWS CLI

手动配置权限 CodeCommit 以允许运行 Lambda 函数

如果您在中 CodeCommit 创建调用 Lambda 函数的触发器，则必须手动配置允许 CodeCommit 运行 Lambda 函数的权限。要避免进行此手动配置，可以考虑改为在 Lambda 控制台中为该函数创建触发器。

CodeCommit 允许运行 Lambda 函数

打开纯文本编辑器并创建一个 JSON 文件，该文件指定 Lambda 函数名称、 CodeCommit 存储库的详细信息以及您希望在 Lambda 中允许的操作，如下所示：


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

将文件另存为 JSON 文件，其名称便于您记住（例如 AllowAccessfromMyDemoRepo.json）。

在终端（Linux、macOS 或 Unix）或命令行 (Windows) 中，使用刚刚创建的 JSON 文件运行 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/。
在 Dashboard 导航窗格中，选择 Roles，然后在角色列表中选择 lambda_basic_execution。
在角色的摘要页面上，选择权限选项卡，然后在内联策略中选择创建角色策略。
在 Set Permissions 页面上，选择 Policy Generator，然后选择 Select。
在编辑权限页面上，执行以下操作：
- 在 Effect 中选择 Allow。
- 在 AWS 服务中，选择 AWS CodeCommit。
- 在操作中，选择GetRepository。
- 在 Amazon 资源名称 (ARN) 中输入存储库的 ARN（例如，arn:aws:codecommit:us-east-1:111122223333:MyDemoRepo）。
选择 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"
            ]
        }
    ]
}

在 CodeCommit存储库（控制台）中为 Lambda 函数创建触发器

创建 Lambda 函数后，您可以在中创建一个触发器 CodeCommit ，该触发器运行该函数以响应您指定的存储库事件。

注意

在成功测试或运行示例的触发器之前，必须配置允许 CodeCommit 调用函数和 Lambda 函数以获取存储库相关信息的策略。有关更多信息，请参阅 CodeCommit 允许运行 Lambda 函数。

为 Lambda 函数创建触发器

打开 CodeCommit 控制台，网址为 https://console.aws.amazon.com/codesuite/codecommit/home。
从存储库 中，选择要创建存储库事件触发器的存储库。
在存储库的导航窗格中，选择设置，然后选择触发器。
选择创建触发器。
在创建触发器中，执行以下操作：
- 在触发器名称中，输入触发器的名称（例如 MyLambdaFunctionTrigger）。
- 在事件中，选择触发 Lambda 函数的存储库事件。
  
  如果选择 All repository events，则无法选择任何其他事件。如果需要选择事件的子集，请清除 All repository events，然后从列表中选择所需的事件。例如，如果希望触发器只在用户在 CodeCommit 存储库中创建标签或分支时运行，请删除所有存储库事件，然后选择创建分支或标记。
- 如果您希望触发器应用于存储库中的所有分支，请在分支中，将选定内容保留为空，因为此默认选项会自动将触发器应用于所有分支。如果您希望此触发器仅应用于特定分支，请从存储库分支列表中选择最多 10 个分支名称。
- 在选择要使用的服务中，选择 AWS Lambda。
- 在 Lambda 函数中，从列表中选择函数名称，或输入函数的 ARN。
- （可选）在自定义数据中，输入要包含在 Lambda 函数中的信息（例如，开发人员用于讨论存储库中的开发工作的 IRC 通道的名称）。该字段是一个字符串。它不能用于传递任何动态参数。
（可选）选择测试触发器。该选项将尝试使用有关您的存储库的示例数据（包括存储库的最新提交 ID）调用该函数。（如果不存在提交历史记录，则将生成由零组成的示例值。）这有助于您确认您已正确配置 CodeCommit 和 Lambda 函数之间的访问权限。
选择创建触发器以完成触发器的创建操作。
要验证触发器的功能，请生成并向配置该触发器的存储库推送一个提交。在 Lambda 控制台中该函数的监控选项卡上，您应该会看到 Lambda 函数的响应。

为 CodeCommit存储库创建 Lambda 函数的触发器 () AWS CLI

您还可以使用命令行为 Lambda 函数创建触发器，以响应 CodeCommit 存储库事件，例如有人向您的仓库推送提交时。

为 Lambda 函数创建触发器

打开纯文本编辑器，创建一个 JSON 文件，在其中指定：
- Lambda 函数名称。
- 要用该触发器监控的存储库和分支。（如果没有指定任何分支，触发器将应用到存储库中的所有分支。）
- 激活该触发器的事件。
保存该文件。

例如，如果您要为名为 main 和 preprod 的存储库创建触发器 MyDemoRepo，该存储库将所有存储库事件发布到MyCodeCommitFunction为两个分支（main 和 preprod）命名的 Lambda 函数：
```
{
    "repositoryName": "MyDemoRepo",
    "triggers": [
        {
            "name": "MyLambdaFunctionTrigger",
            "destinationArn": "arn:aws:lambda:us-east-1:111122223333:function:MyCodeCommitFunction",
            "customData": "",
            "branches": [
                "main", "preprod"
            ],
            "events": [
                "all"
            ]
        }
    ]
}
```
存储库中的每个触发器在该 JSON 文件中都有一个对应的触发块。要为存储库创建多个触发器，请在 JSON 中包含更多的触发块。请记住，在该文件中创建的所有触发器都用于指定的存储库。不能在一个 JSON 文件中为多个存储库创建触发器。例如，如果要为某个存储库创建两个触发器，您可以创建一个包含两个触发块的 JSON 文件。在下面的示例中，第二个触发块中未指定任何分支，因此，该触发器将应用到所有分支：
```
{
    "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"
            ]
        }
    ]
}
```
您可以为指定的事件 (例如，向存储库推送提交时) 创建触发器。事件类型包括：
- all：指定存储库和分支中的所有事件。
- updateReference：向指定存储库和分支推送提交时。
- createReference：在指定存储库中创建新的分支或标签时。
- deleteReference：在指定存储库中删除分支或标签时。
注意
您可以在触发器中使用多种事件类型。但如果指定 all，就无法再指定其他事件。

要查看有效事件类型的完整列表，请在终端或命令提示符处输入 aws codecommit put-repository-triggers help。

此外，您还可以在 customData 中包含一个字符串 (例如，开发人员在讨论该存储库的开发时使用的 IRC 通道的名称)。该字段是一个字符串。它不能用于传递任何动态参数。此字符串作为属性附加到为响应触发器而返回的 CodeCommit JSON 中。
（可选）在终端或命令提示符处，运行 test-repository-triggers 命令。例如，以下内容用于测试名为 t rigger.json 的 JSON 文件是否有效以及该文件是否 CodeCommit 可以触发 Lambda 函数。如果没有实际数据可用，该测试使用示例数据来触发函数。
```
aws codecommit test-repository-triggers --cli-input-json file://trigger.json
```
如果成功，该命令返回类似以下内容的信息：
```
{
    "successfulExecutions": [
        "MyLambdaFunctionTrigger"
    ],
    "failedExecutions": []
}
```
在终端或命令提示符中，运行 put-repository-triggers 命令在 CodeCommit 中创建触发器。例如，要使用名为 trigger.json 的 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 函数的响应。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

为 Lambda 函数创建触发器

编辑存储库的触发器