Exemplo: criar um gatilho AWS CodeCommit para uma AWS Lambda função existente

Abra um editor de texto simples e crie um JSON arquivo que especifique o nome da função Lambda, os detalhes do repositório e CodeCommit as ações que você deseja permitir no Lambda, semelhante ao seguinte:

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

Salve o JSON arquivo como um arquivo com um nome fácil de lembrar (por exemplo, AllowAccessfromMyDemoRepo.json).

Usando o JSON arquivo que você acabou de criar, no terminal (Linux, macOS ou Unix) ou na linha de comando (Windows), execute o aws lambda add-permissions comando para adicionar uma permissão à política de recursos associada à sua função Lambda:

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

Esse comando retorna a declaração JSON de política que você acabou de adicionar, semelhante à seguinte:

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

Para obter mais informações sobre políticas de recursos para funções Lambda, consulte AddPermissionThe Pull/Push Event Models no Guia do usuário.AWS Lambda

Faça login no AWS Management Console e abra o IAM console em https://console.aws.amazon.com/iam/.

No painel de navegação do Painel, escolha Funções e, na lista de funções, selecione lambda_basic_execution.

Na página de resumo da função, escolha a guia Permissions (Permissões) e, em Inline Policies (Políticas em linha), selecione Create Role Policy (Criar política de função).

Na página Set Permissions, selecione Policy Generator e Select.

Na página Edit Permissions (Editar permissões), faça o seguinte:

Escolha Add Statement (Adicionar instrução) e Next Step (Próxima etapa).

Na página Review Policy, selecione Apply Policy.

O relatório de políticas será semelhante ao seguinte exemplo:

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

Abra o CodeCommit console em https://console.aws.amazon.com/codesuite/codecommit/home.

Em Repositories (Repositórios), escolha o repositório onde deseja criar gatilhos de eventos de repositório.

No painel de navegação do repositórios, selecione Settings (Configurações) e gatilhos (Gatilhos).

Escolha Criar acionador.

Em Create gatilho (Criar gatilho), faça o seguinte:

(Opcional) Selecione Test gatilho (Testar gatilho). Essa opção tenta chamar a função com os dados de exemplo sobre o seu repositório, incluindo o ID de confirmação mais recente dele. (Se não houver histórico de confirmações, serão gerados valores de exemplo que consistem em zeros.) Isso ajuda você a confirmar se você configurou corretamente o acesso entre CodeCommit e a função Lambda.

Selecione Create gatilho (Criar gatilho) para concluir a criação do gatilho.

Para verificar a funcionalidade do gatilho, crie e envie uma confirmação por push para o repositório onde você o configurou. Você verá uma resposta da função do Lambda na guia Monitoramento da função no console do Lambda.

Abra um editor de texto sem formatação e crie um JSON arquivo que especifique:

Salve o arquivo.

Por exemplo, se você quiser criar um gatilho para um repositório chamado MyDemoRepo que publica todos os eventos do repositório em uma função Lambda chamada MyCodeCommitFunction para duas filiais, main e preprod:

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

Deve haver um bloco de gatilho no JSON para cada gatilho de um repositório. Para criar mais de um gatilho para um repositório, inclua blocos adicionais noJSON. Lembre-se de que todos os gatilhos criados no arquivo são para o repositório especificado. Você não pode criar acionadores para vários repositórios em um único arquivo. JSON Por exemplo, se você quiser criar dois gatilhos para um repositório, você pode criar um JSON arquivo com dois blocos acionadores. No exemplo a seguir, não há ramificação especificada no segundo bloco de gatilhos, então ele se aplica a todas as ramificações:

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

É possível criar gatilhos para eventos que você especifica, como quando uma confirmação é enviada por push para um repositório. Os tipos de eventos incluem:

Para ver a lista completa dos tipos de eventos válidos em um terminal ou prompt de comando, insira aws codecommit put-repository-triggers help.

Além disso, você pode incluir uma string customData (por exemplo, um nome de IRC canal que os desenvolvedores usam ao discutir o desenvolvimento neste repositório). Este campo é uma string. Ele não pode ser usado para passar nenhum parâmetro dinâmico. Essa string é anexada como um atributo ao CodeCommit JSON retornado em resposta ao gatilho.

(Opcional) No terminal ou no aviso de comando, execute o comando test-repository-triggers. Por exemplo, o seguinte é usado para testar se o JSON arquivo chamado trigger.json é válido e CodeCommit pode acionar a função Lambda. Esse teste usa dados de amostra para funcionar se não houver dados reais disponíveis.

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

Se houver êxito, o comando retornará informações semelhantes às seguintes:

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

Em um terminal ou prompt de comando, execute o put-repository-triggers comando para criar o gatilho em CodeCommit. Por exemplo, para usar um JSON arquivo chamado trigger.json para criar o gatilho:

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

Esse comando retorna um ID de configuração semelhante ao seguinte:

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

Para visualizar a configuração do gatilho, execute o comando get-repository-triggers, especificando o nome do repositório:

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

Esse comando retorna a estrutura de todos os gatilhos configurados para o repositório semelhante à seguinte::

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

Para testar a funcionalidade do gatilho, crie e envie uma confirmação por push para o repositório onde você o configurou. Você verá uma resposta da função do Lambda na guia Monitoramento da função no console do Lambda.