Contoh: Buat pemicu AWS CodeCommit untuk AWS Lambda fungsi yang ada

Buka editor teks biasa dan buat JSON file yang menentukan nama fungsi Lambda, detail repositori, dan tindakan yang ingin Anda izinkan di Lambda, mirip dengan yang berikut ini: CodeCommit

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

Simpan file sebagai JSON file dengan nama yang mudah diingat (misalnya, AllowAccessfromMyDemoRepo .json).

Menggunakan JSON file yang baru saja Anda buat, di terminal (Linux, macOS, atau Unix) atau baris perintah (Windows), jalankan aws lambda add-permissions perintah untuk menambahkan izin ke kebijakan sumber daya yang terkait dengan fungsi Lambda Anda:

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

Perintah ini mengembalikan pernyataan kebijakan yang baru saja Anda tambahkan, mirip dengan yang berikut ini: 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\"}"
}

Untuk informasi selengkapnya tentang kebijakan sumber daya untuk fungsi Lambda, lihat AddPermissiondan Model Peristiwa Tarik/Dorong di Panduan Pengguna.AWS Lambda

Masuk ke AWS Management Console dan buka IAM konsol di https://console.aws.amazon.com/iam/.

Di panel navigasi Dasbor, pilih Peran, dan dalam daftar peran, pilihlambda_basic_execution.

Pada halaman ringkasan untuk peran tersebut, pilih tab Izin, dan di Kebijakan inline, pilih Buat Kebijakan Peran.

Pada halaman Atur Izin, pilih Generator Kebijakan, dan kemudian pilih Pilih.

Di halaman Edit Izin, lakukan hal berikut:

Pilih Tambah Pernyataan, dan kemudian pilih Langkah Selanjutnya.

Pada halaman Tinjau kebijakan, pilih Terapkan Kebijakan.

Pernyataan kebijakan Anda akan terlihat serupa dengan contoh berikut:

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

Buka CodeCommit konsol di https://console.aws.amazon.com/codesuite/codecommit/home.

Di Repositori, pilih repositori tempat Anda ingin membuat pemicu untuk peristiwa repositori.

Di panel navigasi untuk repositori, pilih Pengaturan, lalu pilih Pemicu.

Pilih Buat pemicu.

Di Buat pemicu, lakukan hal berikut:

(Opsional) Pilih Pemicu uji. Opsi ini mencoba untuk memanggil fungsi dengan data sampel tentang repositori Anda, termasuk terbaru ID commit untuk repositori. (Jika tidak ada riwayat commit, nilai sampel yang terdiri dari nol dihasilkan sebagai gantinya.) Ini membantu Anda mengonfirmasi bahwa Anda telah mengonfigurasi akses dengan benar antara CodeCommit dan fungsi Lambda.

Pilih Buat pemicu untuk menyelesaikan pembuatan pemicu.

Untuk memverifikasi fungsi pemicu, buat dan doronglah commit ke repositori di mana Anda mengkonfigurasi pemicu. Anda akan melihat respons dari fungsi Lambda pada tab Pemantauan untuk fungsi di konsol Lambda.

Buka editor teks biasa dan buat JSON file yang menentukan:

Simpan file tersebut.

Misalnya, jika Anda ingin membuat pemicu untuk repositori bernama MyDemoRepo yang menerbitkan semua peristiwa repositori ke fungsi Lambda yang diberi nama untuk dua cabang, dan: MyCodeCommitFunction main preprod

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

Harus ada blok pemicu di JSON untuk setiap pemicu untuk repositori. Untuk membuat lebih dari satu pemicu untuk repositori, sertakan blok tambahan di file. JSON Ingat bahwa semua pemicu yang dibuat dalam file ini adalah untuk repositori yang telah ditentukan. Anda tidak dapat membuat pemicu untuk beberapa repositori dalam satu file. JSON Misalnya, jika Anda ingin membuat dua pemicu untuk repositori, Anda dapat membuat JSON file dengan dua blok pemicu. Pada contoh berikut, tidak ada cabang yang ditentukan di blok pemicu kedua, sehingga pemicu berlaku untuk semua cabang:

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

Anda dapat membuat pemicu untuk peristiwa yang Anda tentukan, seperti ketika commit didorong ke repositori. Jenis-jenis peristiwa meliputi:

Untuk menampilkan daftar lengkap jenis peristiwa yang valid, pada terminal atau prompt perintah, masukkan aws codecommit put-repository-triggers help.

Selain itu, Anda dapat menyertakan string customData (misalnya, nama IRC saluran yang digunakan pengembang saat mendiskusikan pengembangan di repositori ini). Bidang ini adalah string. Ini tidak dapat digunakan untuk melewati parameter dinamis. String ini ditambahkan sebagai atribut ke yang CodeCommit JSON dikembalikan sebagai respons terhadap pemicu.

(Opsional) Pada terminal atau prompt perintah, jalankan perintah test-repository-triggers. Misalnya, berikut ini digunakan untuk menguji apakah JSON file bernama trigger.json valid dan yang CodeCommit dapat memicu fungsi Lambda. Uji ini menggunakan data sampel untuk memicu fungsi jika tidak ada data nyata tersedia.

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

Jika berhasil, perintah ini menampilkan informasi yang serupa dengan yang berikut:

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

Pada terminal atau command prompt, jalankan put-repository-triggers perintah untuk membuat pemicu di CodeCommit. Misalnya, untuk menggunakan JSON file bernama trigger.json untuk membuat pemicu:

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

Perintah ini mengembalikan ID konfigurasi, yang serupa dengan yang berikut ini:

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

Untuk menampilkan konfigurasi pemicu, jalankan perintah get-repository-triggers, dengan menentukan nama repositori:

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

Perintah ini mengembalikan struktur semua pemicu dikonfigurasi untuk repositori, yang serupa dengan berikut ini:

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

Untuk menguji fungsi pemicu, buat dan doronglah sebuah commit ke repositori di mana Anda mengkonfigurasi pemicu tersebut. Anda akan melihat respons dari fungsi Lambda pada tab Pemantauan untuk fungsi di konsol Lambda.