Esempio: creare un trigger AWS CodeCommit per una AWS Lambda funzione esistente

Apri un editor di testo semplice e crea un JSON file che specifichi il nome della funzione Lambda, i dettagli del CodeCommit repository e le azioni che desideri consentire in Lambda, in modo simile al seguente:

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

Salva il file come JSON file con un nome facile da ricordare (ad esempio, .json). AllowAccessfromMyDemoRepo

Utilizzando il JSON file appena creato, dal terminale (Linux, macOS o Unix) o dalla riga di comando (Windows), esegui il aws lambda add-permissions comando per aggiungere un'autorizzazione alla politica delle risorse associata alla tua funzione Lambda:

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

Questo comando restituisce JSON l'informativa sulla politica appena aggiunta, simile alla seguente:

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

Per ulteriori informazioni sulle politiche delle risorse per le funzioni Lambda, vedere AddPermissione The Pull/Push Event Models nella Guida per l'utente.AWS Lambda

Accedi a AWS Management Console e apri la console all'IAMindirizzo. https://console.aws.amazon.com/iam/

Nel riquadro di navigazione della Dashboard, scegli Ruoli e nell'elenco dei ruoli selezionalambda_basic_execution.

Nella pagina di riepilogo del ruolo, scegliere la scheda Permissions (Autorizzazioni) e, in Inline Policies (Policy inline), scegliere Create Role Policy (Crea policy ruolo).

Nella pagina Set Permissions (Imposta autorizzazioni), scegliere Policy Generator (Generatore di policy), quindi Select (Seleziona).

Nella pagina Edit Permissions (Modifica autorizzazioni), procedere nel modo seguente:

Selezionare Add Statement (Aggiungi istruzione), quindi Next Step (Fase successiva).

Nella pagina Review Policy (Revisiona policy), scegliere Apply Policy (Applica policy).

La dichiarazione relativa alla policy dovrebbe essere simile all'esempio seguente:

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

Apri la CodeCommit console su https://console.aws.amazon.com/codesuite/codecommit/home.

In Repository, selezionare il repository in cui si desidera creare i trigger per gli eventi del repository.

Nel riquadro di navigazione per il repository, scegliere Settings (Impostazioni), quindi Triggers (Trigger).

Selezionare Create trigger (Crea trigger).

In Create trigger (Crea trigger), eseguire quanto segue:

(Facoltativo) Scegliere Test trigger (Esegui test trigger). Questa opzione tenta di invocare la funzione con i dati di esempio relativi al repository, incluso l'ID commit più recente. Se non esiste una cronologia dei commit, vengono generati valori di esempio costituiti da zero. Questo ti aiuta a confermare di aver configurato correttamente l'accesso tra CodeCommit e la funzione Lambda.

Scegliere Create trigger (Crea trigger) per completare la creazione del trigger.

Per verificare la funzionalità del trigger, creare ed effettuare il push di un commit nel repository in cui è stato configurato il trigger. Dovresti vedere una risposta dalla funzione Lambda nella scheda Monitoraggio per quella funzione nella console Lambda.

Apri un editor di testo semplice e crea un JSON file che specifichi:

Salvare il file.

Ad esempio, se desideri creare un trigger per un repository denominato MyDemoRepo che pubblica tutti gli eventi del repository in una funzione Lambda denominata MyCodeCommitFunction per due rami e: main preprod

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

Deve essere presente un blocco di attivazione JSON per ogni trigger di un repository. Per creare più di un trigger per un repository, includi blocchi aggiuntivi in. JSON Tenere presente che tutti i trigger creati in questo file si riferiscono al repository specificato. Non è possibile creare trigger per più repository in un singolo file. JSON Ad esempio, se desideri creare due trigger per un repository, puoi creare un JSON file con due blocchi trigger. Nell'esempio che segue non sono specificati rami nel secondo blocco di trigger, pertanto il trigger viene applicato a tutti i rami:

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

È possibile creare trigger per eventi specifici, ad esempio quando viene eseguito il push di un commit in un repository. I tipi di eventi includono:

Per visualizzare l'elenco completo dei tipi di evento validi, dal terminale o dal prompt dei comandi, immettere aws codecommit put-repository-triggers help.

Inoltre, puoi includere una stringa customData (ad esempio, il nome di un IRC canale utilizzato dagli sviluppatori quando discutono dello sviluppo in questo repository). Questo campo è una stringa e non può essere utilizzato per passare parametri dinamici. Questa stringa viene aggiunta come attributo al valore CodeCommit JSON restituito in risposta al trigger.

(Facoltativo) Da un terminale o dal prompt dei comandi, eseguire il comando test-repository-triggers. Ad esempio, quanto segue viene utilizzato per verificare che il JSON file denominato trigger.json sia valido e che CodeCommit possa attivare la funzione Lambda. Questo test utilizza i dati di esempio per attivare la funzione se non sono disponibili dati reali.

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

Se il comando viene eseguito correttamente, restituisce informazioni simili alle seguenti:

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

Da un terminale o dal prompt dei comandi, eseguire il comando put-repository-triggers per creare il trigger in CodeCommit. Ad esempio, per utilizzare un JSON file denominato trigger.json per creare il trigger:

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

Questo comando restituisce un ID di configurazione, simile al seguente:

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

Per visualizzare la configurazione del trigger, eseguire il comando get-repository-triggers specificando il nome del repository:

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

Questo comando restituisce la struttura di tutti i trigger configurati per il repository, producendo un output simile al seguente:

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

Per verificare la funzionalità del trigger, creare ed effettuare il push di un commit nel repository in cui è stato configurato il trigger. Dovresti vedere una risposta dalla funzione Lambda nella scheda Monitoraggio per quella funzione nella console Lambda.