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

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

{
    "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 file JSON dengan nama yang mudah diingat (misalnya, AllowAccessfromMyDemoRepo.json).

Dengan menggunakan file JSON yang baru saja Anda buat, di terminal (Linux, MacOS, atau Unix) atau baris perintah (Windows), jalankan perintah aws lambda add-permissions 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 JSON dari pernyataan kebijakan Anda hanya menambahkan, yang serupa dengan berikut ini:

{
    "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 konsol IAM di https://console.aws.amazon.com/iam/.

Di panel navigasi Dasbor, pilih Peran, dan di daftar peran, pilih lambda_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 buatlah file JSON yang menentukan:

Simpan file tersebut.

Misalnya, jika Anda ingin membuat pemicu untuk repositori bernama yang menerbitkan semua peristiwa repositori ke fungsi Lambda MyDemoRepoyang diberi nama MyCodeCommitFunctionuntuk dua cabang, main dan 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 sebuah repositori. Untuk membuat lebih dari satu pemicu untuk repositori, termasuk blok tambahan di 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 file JSON tunggal. Misalnya, jika Anda ingin membuat dua pemicu untuk repositori, Anda dapat membuat file JSON 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 sebuah string dalam customData (misalnya, developer nama saluran IRC digunakan saat membahas pengembangan di repositori ini). Bidang ini adalah string. Ini tidak dapat digunakan untuk melewati parameter dinamis. String ini ditambahkan sebagai atribut ke CodeCommit JSON yang dikembalikan sebagai respons terhadap pemicu.

(Opsional) Pada terminal atau prompt perintah, jalankan perintah test-repository-triggers. Misalnya, berikut ini digunakan untuk menguji bahwa file JSON bernama trigger.json valid dan yang dapat memicu fungsi CodeCommit 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 file JSON yang 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:

{
    "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.