Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Referensi struktur aturan Bagian ini adalah referensi untuk konfigurasi aturan saja. Untuk gambaran konseptual dari struktur pipa, lihat[CodePipeline referensi struktur pipa](reference-pipeline-structure.md). Setiap penyedia aturan CodePipeline menggunakan satu set bidang konfigurasi wajib dan opsional dalam struktur pipa. Bagian ini memberikan informasi referensi berikut oleh penyedia aturan: + Nilai yang valid untuk `RuleType` bidang yang termasuk dalam blok aturan struktur pipa, seperti `Owner` dan`Provider`. + Deskripsi dan informasi referensi lainnya untuk `Configuration` parameter (wajib dan opsional) termasuk dalam bagian aturan struktur pipa. + Contoh bidang konfigurasi aturan JSON dan YAMAL yang valid. Informasi referensi tersedia untuk penyedia aturan berikut: **Topics** + [CloudWatchAlarm](rule-reference-CloudWatchAlarm.md) + [CodeBuild aturan](rule-reference-CodeBuild.md) + [Commands](rule-reference-Commands.md) + [DeploymentWindow](rule-reference-DeploymentWindow.md) + [LambdaInvoke](rule-reference-LambdaInvoke.md) + [VariableCheck](rule-reference-VariableCheck.md) # CloudWatchAlarm Saat Anda membuat kondisi, Anda dapat menambahkan `CloudWatchAlarm` aturan. Bagian ini memberikan referensi untuk parameter aturan. Untuk informasi selengkapnya tentang aturan dan ketentuan, lihat[Bagaimana kondisi panggung bekerja?](concepts-how-it-works-conditions.md). Anda harus sudah membuat alarm di Amazon CloudWatch sebagai sumber daya terpisah. **Topics** + [Jenis aturan](#rule-reference-CloudWatchAlarm-type) + [Parameter konfigurasi](#rule-reference-CloudWatchAlarm-config) + [Contoh konfigurasi aturan](#rule-reference-CloudWatchAlarm-example) + [Lihat juga](#rule-reference-CloudWatchAlarm-links) ## Jenis aturan + Kategori: `Rule` + Pemilik: `AWS` + Penyedia: `CloudWatchAlarm` + Versi: `1` ## Parameter konfigurasi **AlarmName** Wajib: Ya Nama CloudWatch alarm. Ini adalah sumber daya terpisah yang dibuat di CloudWatch. **AlarmStates** Wajib: Tidak CloudWatch Alarm yang diinginkan menyatakan aturan untuk dipantau. Nilai yang valid adalah ALARM, OK, dan INSUFFICIENT\$1DATA. **WaitTime** Wajib: Tidak Waktu tunggu dalam hitungan menit untuk memungkinkan perubahan status sebelum menjalankan hasil aturan. Misalnya, konfigurasikan 20 menit untuk menunggu status alarm berubah menjadi OK sebelum menerapkan hasil aturan. ## Contoh konfigurasi aturan ------ #### [ YAML ] ``` rules: - name: MyMonitorRule ruleTypeId: category: Rule owner: AWS provider: CloudWatchAlarm version: '1' configuration: AlarmName: CWAlarm WaitTime: '1' inputArtifacts: [] region: us-east-1 ``` ------ #### [ JSON ] ``` "rules": [ { "name": "MyMonitorRule", "ruleTypeId": { "category": "Rule", "owner": "AWS", "provider": "CloudWatchAlarm", "version": "1" }, "configuration": { "AlarmName": "CWAlarm", "WaitTime": "1" }, "inputArtifacts": [], "region": "us-east-1" } ] } ``` ------ ## Lihat juga Sumber daya terkait berikut dapat membantu Anda saat Anda bekerja dengan aturan ini. + [Menciptakan kondisi Kegagalan](stage-conditions.md#stage-conditions-onfailure)— Bagian ini memberikan langkah-langkah untuk membuat kondisi On Failure dengan aturan alarm. # CodeBuild aturan Saat Anda membuat kondisi, Anda dapat menambahkan CodeBuild aturan. Bagian ini memberikan referensi untuk parameter aturan. Untuk informasi selengkapnya tentang aturan dan ketentuan, lihat[Bagaimana kondisi panggung bekerja?](concepts-how-it-works-conditions.md). Anda dapat menggunakan CodeBuild aturan untuk membuat kondisi di mana keberhasilan menjalankan proyek build Anda memenuhi kriteria aturan, seperti build run yang berhasil untuk kondisi beforeEntry. **catatan** Untuk kondisi beforeEntry yang dikonfigurasi dengan hasil **Lewati**, hanya aturan berikut yang tersedia: `LambdaInvoke` dan. `VariableCheck` **Topics** + [Izin kebijakan peran layanan](#rule-reference-Commands-policy) + [Jenis aturan](#rule-reference-Commands-type) + [Parameter konfigurasi](#rule-reference-Commands-config) + [Contoh konfigurasi aturan](#rule-reference-Commands-example) + [Lihat juga](#rule-reference-Commands-links) ## Izin kebijakan peran layanan Untuk izin aturan ini, tambahkan berikut ini ke pernyataan kebijakan peran CodePipeline layanan Anda. Cakupan izin ke tingkat sumber daya. ``` { "Effect": "Allow", "Action": [ "codebuild:BatchGetBuilds", "codebuild:StartBuild" ], "Resource": "resource_ARN" }, ``` ## Jenis aturan + Kategori: `Rule` + Pemilik: `AWS` + Penyedia: `CodeBuild` + Versi: `1` ## Parameter konfigurasi **ProjectName** Wajib: Ya `ProjectName`adalah nama proyek pembangunan di CodeBuild. **PrimarySource** Diperlukan: Kondisional Nilai `PrimarySource` parameter harus menjadi nama salah satu artefak input untuk tindakan. CodeBuild mencari file buildspec dan menjalankan perintah buildspec di direktori yang berisi versi unzip artefak ini. Parameter ini diperlukan jika beberapa artefak masukan ditentukan untuk suatu CodeBuild tindakan. Ketika hanya ada satu artefak sumber untuk aksi, artefak default ke `PrimarySource` artefak itu. **BatchEnabled** Wajib: Tidak Nilai Boolean dari `BatchEnabled` parameter memungkinkan tindakan untuk menjalankan beberapa build dalam eksekusi build yang sama. Ketika opsi ini diaktifkan, `CombineArtifacts` opsi tersedia. Untuk contoh pipeline dengan build batch diaktifkan, lihat [CodePipeline integrasi dengan CodeBuild dan build batch](https://docs.aws.amazon.com/codebuild/latest/userguide/sample-pipeline-batch.html). **CombineArtifacts** Wajib: Tidak Nilai Boolean `CombineArtifacts` parameter menggabungkan semua artefak build dari build batch menjadi file artefak tunggal untuk aksi build. Untuk menggunakan opsi ini, `BatchEnabled` parameter harus diaktifkan. **EnvironmentVariables** Wajib: Tidak Nilai parameter ini digunakan untuk mengatur variabel lingkungan untuk CodeBuild tindakan di pipeline Anda. Nilai untuk `EnvironmentVariables` parameter mengambil bentuk array JSON dari objek variabel lingkungan. Lihat parameter contoh di[Deklarasi tindakan (CodeBuild contoh)](action-reference-CodeBuild.md#action-reference-CodeBuild-example). Setiap objek memiliki tiga bagian, yang semuanya adalah string: + `name`: Nama atau kunci variabel lingkungan. + `value`: Nilai variabel lingkungan. Saat menggunakan `SECRETS_MANAGER` tipe `PARAMETER_STORE` atau, nilai ini harus berupa nama parameter yang telah Anda simpan di AWS Systems Manager Parameter Store atau rahasia yang telah Anda simpan di AWS Secrets Manager, masing-masing. **catatan** Kami sangat tidak menyarankan penggunaan variabel lingkungan untuk menyimpan nilai sensitif, terutama AWS kredensyal. Saat Anda menggunakan CodeBuild konsol atau AWS CLI, variabel lingkungan ditampilkan dalam teks biasa. Untuk nilai sensitif, kami sarankan Anda menggunakan `SECRETS_MANAGER` tipe sebagai gantinya. + `type`: (Opsional) Jenis variabel lingkungan. Nilai yang valid adalah `PARAMETER_STORE`, `SECRETS_MANAGER`, atau `PLAINTEXT`. Ketika tidak ditentukan, ini default ke. `PLAINTEXT` Saat Anda memasukkan`name`,`value`, dan `type` untuk konfigurasi variabel lingkungan Anda, terutama jika variabel lingkungan berisi sintaks variabel CodePipeline keluaran, jangan melebihi batas 1000 karakter untuk bidang nilai konfigurasi. Kesalahan validasi dikembalikan ketika batas ini terlampaui. Untuk informasi selengkapnya, lihat [ EnvironmentVariable](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_EnvironmentVariable.html)di Referensi AWS CodeBuild API. Untuk contoh CodeBuild tindakan dengan variabel lingkungan yang menyelesaikan ke nama GitHub cabang, lihat. [Contoh: Gunakan BranchName variabel dengan variabel CodeBuild lingkungan](actions-variables.md#actions-variables-examples-env-branchname) ## Contoh konfigurasi aturan ------ #### [ YAML ] ``` name: codebuild-rule ruleTypeId: category: Rule owner: AWS provider: CodeBuild version: '1' configuration: ProjectName: my-buildproject EnvironmentVariables: '[{"name":"VAR1","value":"variable","type":"PLAINTEXT"}]' inputArtifacts: - name: SourceArtifact region: us-east-1 ``` ------ #### [ JSON ] ``` { "name": "codebuild-rule", "ruleTypeId": { "category": "Rule", "owner": "AWS", "provider": "CodeBuild", "version": "1" }, "configuration": { "ProjectName": "my-buildproject" }, "inputArtifacts": [ { "name": "SourceArtifact", "EnvironmentVariables": "[{\"name\":\"VAR1\",\"value\":\"variable\",\"type\":\"PLAINTEXT\"}]" } ], "region": "us-east-1" } ``` ------ ## Lihat juga Sumber daya terkait berikut dapat membantu Anda saat Anda bekerja dengan aturan ini. + Untuk informasi selengkapnya tentang aturan dan ketentuan, lihat [Kondisi [RuleTypeId](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleTypeId.html)](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_Condition.html), dan [RuleExecution](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleExecution.html)di *Panduan CodePipeline API*. # Commands Saat Anda membuat kondisi, Anda dapat menambahkan `Commands` aturan. Bagian ini memberikan referensi untuk parameter aturan. Untuk informasi selengkapnya tentang aturan dan ketentuan, lihat[Bagaimana kondisi panggung bekerja?](concepts-how-it-works-conditions.md). Anda dapat menggunakan `Commands` aturan untuk membuat kondisi di mana perintah berhasil memenuhi kriteria aturan, seperti output dan jalur file untuk perintah yang berhasil untuk kondisi beforeEntry. **catatan** Untuk kondisi beforeEntry yang dikonfigurasi dengan hasil **Lewati**, hanya aturan berikut yang tersedia: `LambdaInvoke` dan. `VariableCheck` **Topics** + [Pertimbangan untuk aturan Perintah](#rule-reference-Commands-considerations) + [Izin kebijakan peran layanan](#rule-reference-Commands-policy) + [Jenis aturan](#rule-reference-Commands-type) + [Parameter konfigurasi](#rule-reference-Commands-config) + [Contoh konfigurasi aturan](#rule-reference-Commands-example) + [Lihat juga](#rule-reference-Commands-links) ## Pertimbangan untuk aturan Perintah Pertimbangan berikut berlaku untuk aturan Perintah. + Aturan perintah menggunakan CodeBuild sumber daya yang mirip dengan CodeBuild tindakan, sementara mengizinkan perintah lingkungan shell dalam instance komputasi virtual tanpa perlu mengaitkan atau membuat proyek build. **catatan** Menjalankan aturan perintah akan dikenakan biaya terpisah di AWS CodeBuild. + Karena aturan Command CodePipeline menggunakan CodeBuild resource, build yang dijalankan oleh action akan dikaitkan dengan batas build untuk akun Anda. CodeBuild Build yang dijalankan oleh aturan Command akan dihitung terhadap batas build bersamaan seperti yang dikonfigurasi untuk akun tersebut. + Batas waktu untuk build dengan aturan Command adalah 55 menit, berdasarkan CodeBuild build. + Instance komputasi menggunakan lingkungan build yang terisolasi di CodeBuild. **catatan** Karena lingkungan build terisolasi digunakan di tingkat akun, instance dapat digunakan kembali untuk eksekusi pipeline lainnya. + Semua format didukung kecuali format multi-baris. Anda harus menggunakan format satu baris saat memasukkan perintah. + Untuk aturan ini, CodePipeline akan mengambil peran layanan pipeline dan menggunakan peran itu untuk memungkinkan akses ke sumber daya saat runtime. Disarankan untuk mengonfigurasi peran layanan sehingga izin dicakup ke tingkat tindakan. + Izin yang ditambahkan ke peran CodePipeline layanan dirinci dalam[Menambahkan izin ke peran CodePipeline layanan](how-to-custom-role.md#how-to-update-role-new-services). + Izin yang diperlukan untuk melihat log di konsol dirinci di[Izin diperlukan untuk melihat log komputasi di konsol](security-iam-permissions-console-logs.md). Di layar contoh berikut, gunakan tautan **Log** untuk melihat log agar aturan Command berhasil di CloudWatch log. ![\[Halaman Status untuk pipeline dengan aturan Commands\]](http://docs.aws.amazon.com/id_id/codepipeline/latest/userguide/images/commands-rule-status.png) ![\[Halaman Log CloudWatch untuk pipeline dengan aturan Commands\]](http://docs.aws.amazon.com/id_id/codepipeline/latest/userguide/images/commands-rule-logs.png) + Tidak seperti tindakan lain di CodePipeline, Anda tidak menyetel bidang dalam konfigurasi tindakan; Anda mengatur bidang konfigurasi tindakan di luar konfigurasi tindakan. ## Izin kebijakan peran layanan Saat CodePipeline menjalankan aturan, CodePipeline buat grup log menggunakan nama pipeline sebagai berikut. Ini memungkinkan Anda untuk mengurangi izin untuk mencatat sumber daya menggunakan nama pipeline. ``` /aws/codepipeline/MyPipelineName ``` Jika Anda menggunakan peran layanan yang ada, untuk menggunakan tindakan Perintah, Anda perlu menambahkan izin berikut untuk peran layanan. + log: CreateLogGroup + log: CreateLogStream + log: PutLogEvents Dalam pernyataan kebijakan peran layanan, cakupkan izin ke tingkat pipeline seperti yang ditunjukkan pada contoh berikut. ``` { "Effect": "Allow", "Action": [ "logs:CreateLogGroup", "logs:CreateLogStream", "logs:PutLogEvents" ], "Resource": "arn:aws:logs:*:YOUR_AWS_ACCOUNT_ID:log-group:/aws/codepipeline/YOUR_PIPELINE_NAME:*" } ``` Untuk melihat log di konsol menggunakan halaman dialog detail tindakan, izin untuk melihat log harus ditambahkan ke peran konsol. Untuk informasi selengkapnya, lihat contoh kebijakan izin konsol di[Izin diperlukan untuk melihat log komputasi di konsol](security-iam-permissions-console-logs.md). ## Jenis aturan + Kategori: `Rule` + Pemilik: `AWS` + Penyedia: `Commands` + Versi: `1` ## Parameter konfigurasi **Commands** Wajib: Ya Anda dapat memberikan perintah shell untuk menjalankan `Commands` aturan. Di konsol, perintah dimasukkan pada baris terpisah. Di CLI, perintah dimasukkan sebagai string terpisah. Format multi-baris tidak didukung dan akan menghasilkan pesan kesalahan. Format baris tunggal harus digunakan untuk memasukkan perintah di bidang **Perintah**. Rincian berikut memberikan komputasi default yang digunakan untuk aturan Command. Untuk informasi selengkapnya, lihat [Mode komputasi lingkungan build dan referensi tipe](https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-compute-types.html) di Panduan CodeBuild Pengguna. + **CodeBuild gambar: aws/codebuild/amazonlinux 2-x86\$164-standar:** 5.0 + **Jenis komputasi:** Linux Kecil + **Nilai ComputeType Lingkungan: BUILD\$1 \$1SMALL** GENERAL1 + **Nilai tipe lingkungan:** LINUX\$1CONTAINER ## Contoh konfigurasi aturan ------ #### [ YAML ] ``` result: FAIL rules: - name: CommandsRule ruleTypeId: category: Rule owner: AWS provider: Commands version: '1' configuration: {} commands: - ls - printenv inputArtifacts: - name: SourceArtifact region: us-east-1 ``` ------ #### [ JSON ] ``` { "result": "FAIL", "rules": [ { "name": "CommandsRule", "ruleTypeId": { "category": "Rule", "owner": "AWS", "provider": "Commands", "version": "1" }, "configuration": {}, "commands": [ "ls", "printenv" ], "inputArtifacts": [ { "name": "SourceArtifact" } ], "region": "us-east-1" } ] } ``` ------ ## Lihat juga Sumber daya terkait berikut dapat membantu Anda saat Anda bekerja dengan aturan ini. + Untuk informasi selengkapnya tentang aturan dan ketentuan, lihat [Kondisi [RuleTypeId](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleTypeId.html)](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_Condition.html), dan [RuleExecution](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleExecution.html)di *Panduan CodePipeline API*. # DeploymentWindow Saat Anda membuat kondisi, Anda dapat menambahkan `DeploymentWindow` aturan. Bagian ini memberikan referensi untuk parameter aturan. Untuk informasi selengkapnya tentang aturan dan ketentuan, lihat[Bagaimana kondisi panggung bekerja?](concepts-how-it-works-conditions.md). **Topics** + [Jenis aturan](#rule-reference-DeploymentWindow-type) + [Parameter konfigurasi](#rule-reference-DeploymentWindow-config) + [Contoh konfigurasi aturan](#rule-reference-DeploymentWindow-example) + [Lihat juga](#rule-reference-DeploymentWindow-links) ## Jenis aturan + Kategori: `Rule` + Pemilik: `AWS` + Penyedia: `DeploymentWindow` + Versi: `1` ## Parameter konfigurasi **Cron** Wajib: Ya Ekspresi yang mendefinisikan hari dan waktu ketika penerapan akan diizinkan. Ekspresi cron terdiri dari 6 bidang wajib dan satu bidang opsional dipisahkan oleh spasi putih. Bidang ekspresi cron memungkinkan Anda menentukan pola jadwal dengan ekspresi cron sebagai berikut. **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/codepipeline/latest/userguide/rule-reference-DeploymentWindow.html) + Karakter '\$1' digunakan untuk menentukan semua nilai. Misalnya, “\$1” di bidang menit berarti “setiap menit”. + Yang '?' karakter diperbolehkan untuk day-of-month dan day-of-week bidang. Ini digunakan untuk menentukan 'tidak ada nilai spesifik'. Ini berguna ketika Anda perlu menentukan sesuatu di salah satu dari dua bidang, tetapi tidak yang lain. + Karakter '-' digunakan untuk menentukan rentang Misalnya “10-12" di bidang jam berarti “jam 10, 11 dan 12". + Karakter ',' digunakan untuk menentukan nilai tambahan. Misalnya “MON, WED, FRI” di day-of-week lapangan berarti “hari-hari Senin, Rabu, dan Jumat”. + Karakter '/' digunakan untuk menentukan kenaikan. Misalnya “0/15" di bidang detik berarti “detik 0, 15, 30, dan 45". Dan “5/15" di bidang detik berarti “detik 5, 20, 35, dan 50". Menentukan '\$1' sebelum '/' setara dengan menentukan 0 adalah nilai untuk memulai. + Karakter 'L' diperbolehkan untuk day-of-week bidang day-of-month dan. Karakter ini pendek untuk “terakhir”, tetapi memiliki arti yang berbeda di masing-masing dari dua bidang. Misalnya, nilai “L” di day-of-month lapangan berarti “hari terakhir bulan” - hari 31 untuk Januari, hari 28 untuk Februari pada tahun non-kabisat. Jika digunakan di day-of-week lapangan dengan sendirinya, itu berarti “7" atau “SAT”. Tetapi jika digunakan di day-of-week bidang setelah nilai lain, itu berarti “hari terakhir bulan” - misalnya “6L” berarti “Jumat terakhir setiap bulan”. Anda juga dapat menentukan offset dari hari terakhir bulan itu, seperti “L-3" yang berarti third-to-last hari bulan kalender. + Karakter 'W' diperbolehkan untuk day-of-month bidang tersebut. Karakter ini digunakan untuk menentukan hari kerja (Senin-Jumat) terdekat hari yang diberikan. Sebagai contoh, jika Anda menentukan “15W” sebagai nilai untuk day-of-month bidang, artinya adalah: “hari kerja terdekat dengan tanggal 15 bulan”. Jadi jika tanggal 15 adalah hari Sabtu, pemicunya akan menyala pada hari Jumat tanggal 14. Jika tanggal 15 adalah hari Minggu, pemicunya akan menyala pada hari Senin tanggal 16. Jika tanggal 15 adalah hari Selasa, maka akan menyala pada hari Selasa tanggal 15. + Karakter 'L' dan 'W' juga dapat digabungkan untuk day-of-month ekspresi menghasilkan 'LW', yang diterjemahkan menjadi “hari kerja terakhir bulan ini”. + Karakter '\$1' diperbolehkan untuk day-of-week bidang. Karakter ini digunakan untuk menentukan hari “ke-n” dalam sebulan. Misalnya, nilai “6 \$13" di day-of-week lapangan berarti Jumat ketiga setiap bulan (hari 6 = Jumat dan "\$13" = yang ke-3 dalam sebulan). + Karakter hukum dan nama bulan dan hari dalam seminggu tidak peka huruf besar/kecil. **TimeZone** Wajib: Tidak Zona waktu untuk jendela penyebaran. Ekspresi reguler cocok dengan pola dalam format berikut: + **Format Wilayah/Kota**. Nilai cocok dengan zona waktu dalam format Region/City atau Region/City\$1City. Misalnya, `America/New_York` atau `Europe/Berlin`. + **Format UTC**. Nilai cocok dengan string UTC opsional diikuti oleh offset dalam format\$1HH: MM atau -HH: MM. Sebagai contoh,,, atau. `UTC` `UTC+05:30` `UTC-03:00` Ini adalah format default jika parameter tidak diatur sebaliknya. + **Format singkatan**. Nilai cocok dengan singkatan 3 hingga 5 karakter untuk zona waktu. Misalnya, `EST` atau `IST`. Untuk tabel nilai TimeZone ID yang valid, lihat [https://docs.oracle.com/middleware/1221/ .html wcs/tag-ref/MISC/TimeZones](https://docs.oracle.com/middleware/1221/wcs/tag-ref/MISC/TimeZones.html). Perhatikan bahwa singkatan tertentu adalah singkatan duplikat, seperti CST untuk Waktu Standar Tengah, Waktu Standar Tiongkok, dan Waktu Standar Kuba. ## Contoh konfigurasi aturan ------ #### [ YAML ] ``` - name: MyDeploymentRule ruleTypeId: category: Rule owner: AWS provider: DeploymentWindow version: '1' configuration: Cron: 0 0 9-17 ? * MON-FRI * TimeZone: PST inputArtifacts: [] region: us-east-1 ``` ------ #### [ JSON ] ``` [ { "name": "MyDeploymentRule", "ruleTypeId": { "category": "Rule", "owner": "AWS", "provider": "DeploymentWindow", "version": "1" }, "configuration": { "Cron": "0 0 9-17 ? * MON-FRI *", "TimeZone": "PST" }, "inputArtifacts": [], "region": "us-east-1" } ] ``` ------ ## Lihat juga Sumber daya terkait berikut dapat membantu Anda saat Anda bekerja dengan aturan ini. + [Menciptakan kondisi Sukses](stage-conditions.md#stage-conditions-onsuccess)— Bagian ini menyediakan langkah-langkah untuk membuat kondisi On Success dengan aturan jendela penerapan. + Untuk informasi selengkapnya tentang aturan dan ketentuan, lihat [Kondisi [RuleTypeId](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleTypeId.html)](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_Condition.html), dan [RuleExecution](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleExecution.html)di *Panduan CodePipeline API*. # LambdaInvoke Saat Anda membuat kondisi, Anda dapat menambahkan `LambdaInvoke` aturan. Bagian ini memberikan referensi untuk parameter aturan. Untuk informasi selengkapnya tentang aturan dan ketentuan, lihat[Bagaimana kondisi panggung bekerja?](concepts-how-it-works-conditions.md). Anda harus sudah membuat fungsi di Lambda sebagai sumber daya terpisah. **Topics** + [Jenis aturan](#rule-reference-CloudWatchAlarm-type) + [Parameter konfigurasi](#rule-reference-LambdaInvoke-config) + [Contoh konfigurasi aturan](#rule-reference-LambdaInvoke-example) + [Lihat juga](#rule-reference-LambdaInvoke-links) ## Jenis aturan + Kategori: `Rule` + Pemilik: `AWS` + Penyedia: `LambdaInvoke` + Versi: `1` ## Parameter konfigurasi **FunctionName** Wajib: Ya Nama fungsi Lambda. **UserParameters** Wajib: Tidak Ini adalah parameter yang disediakan sebagai input untuk fungsi dalam format pasangan nilai kunci. ## Contoh konfigurasi aturan ------ #### [ YAML ] ``` - name: MyLambdaRule ruleTypeId: category: Rule owner: AWS provider: LambdaInvoke version: '1' configuration: FunctionName: my-function inputArtifacts: - name: SourceArtifact region: us-east-1 ``` ------ #### [ JSON ] ``` [ { "name": "MyLambdaRule", "ruleTypeId": { "category": "Rule", "owner": "AWS", "provider": "LambdaInvoke", "version": "1" }, "configuration": { "FunctionName": "my-function" }, "inputArtifacts": [ { "name": "SourceArtifact" } ], "region": "us-east-1" } ] ``` ------ ## Lihat juga Sumber daya terkait berikut dapat membantu Anda saat Anda bekerja dengan aturan ini. + [Menciptakan kondisi Kegagalan](stage-conditions.md#stage-conditions-onfailure)— Bagian ini memberikan langkah-langkah untuk membuat kondisi On Failure dengan aturan alarm. # VariableCheck Saat Anda membuat kondisi, Anda dapat menambahkan `VariableCheck` aturan. Bagian ini memberikan referensi untuk parameter aturan. Untuk informasi selengkapnya tentang aturan dan ketentuan, lihat[Bagaimana kondisi panggung bekerja?](concepts-how-it-works-conditions.md). Anda dapat menggunakan `VariableCheck` aturan untuk membuat kondisi di mana variabel output diperiksa terhadap ekspresi yang disediakan. Aturan melewati pemeriksaan ketika nilai variabel memenuhi kriteria aturan, seperti nilai yang sama atau lebih besar dari variabel output tertentu. **Topics** + [Jenis aturan](#rule-reference-VariableCheck-type) + [Parameter konfigurasi](#rule-reference-VariableCheck-config) + [Contoh konfigurasi aturan](#rule-reference-VariableCheck-example) + [Lihat juga](#rule-reference-VariableCheck-links) ## Jenis aturan + Kategori: `Rule` + Pemilik: `AWS` + Penyedia: `VariableCheck` + Versi: `1` ## Parameter konfigurasi **Operator** Wajib: Ya Operator yang menunjukkan operasi mana yang harus dilakukan untuk pemeriksaan variabel. Dalam contoh berikut, variabel output untuk nama repositori akan diperiksa apakah sama dengan. `MyDemoRepo` ``` "configuration": { "Variable": "#{SourceVariables.RepositoryName}", "Value": "MyDemoRepo", "Operator": "EQ" }, ``` Operator berikut tersedia untuk membuat ekspresi sebagai berikut. + **Sama dengan** - Pilih operator ini untuk memeriksa apakah variabel sama dengan nilai string. **Parameter CLI:** `EQ` + **Berisi** - Pilih operator ini untuk memeriksa apakah variabel berisi nilai string sebagai substring. **Parameter CLI:** `CONTAINS` + **Cocokkan** - Pilih operator ini untuk memeriksa apakah variabel cocok dengan ekspresi regex yang diberikan sebagai nilai string. Semua ekspresi reguler CodePipeline sesuai dengan sintaks regex Java. [Untuk deskripsi komprehensif tentang sintaks regex Java dan konstruksinya, lihat java.util.Regex.Pattern.](https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/util/regex/Pattern.html) **Parameter CLI:** `MATCHES` + **Tidak sama** - Pilih operator ini untuk memeriksa apakah variabel tidak sama dengan nilai string. **Parameter CLI:** `NE` **Variabel** Wajib: Ya Variabel pipeline untuk diperiksa. **Nilai** Wajib: Ya Nilai untuk ekspresi untuk memeriksa terhadap. Dalam contoh berikut, variabel output untuk nama repositori akan diperiksa apakah sama dengan. `MyDemoRepo` ``` "configuration": { "Variable": "#{SourceVariables.RepositoryName}", "Value": "MyDemoRepo", "Operator": "EQ" }, ``` Dalam contoh JSON berikut, dua aturan terpisah didefinisikan, satu untuk pernyataan `EQ` (sama) yang memeriksa repositori dan nama cabang diformat sebagai \$1 \$1. SourceVariables RepositoryName\$1 dan satu untuk `CONTAINS` itu memeriksa variabel keluaran pesan komit yang diformat sebagai \$1 \$1SourceVariables. CommitMessage\$1 terhadap nilai yang diberikan “pembaruan.” ``` "beforeEntry": { "conditions": [ { "result": "FAIL", "rules": [ { "name": "MyVarCheckRule", "ruleTypeId": { "category": "Rule", "owner": "AWS", "provider": "VariableCheck", "version": "1" }, "configuration": { "Operator": "EQ", "Value": "MyDemoRepo", "Variable": "#{SourceVariables.RepositoryName}" }, "inputArtifacts": [], "region": "us-east-1" }, { "name": "MyVarCheckRuleContains", "ruleTypeId": { "category": "Rule", "owner": "AWS", "provider": "VariableCheck", "version": "1" }, "configuration": { "Operator": "CONTAINS", "Value": "update", "Variable": "#{SourceVariables.CommitMessage}" }, "inputArtifacts": [], "region": "us-east-1" } ] } ] } } ], ``` ## Contoh konfigurasi aturan ------ #### [ YAML ] ``` - name: MyVariableCheck ruleTypeId: category: Rule owner: AWS provider: VariableCheck version: '1' configuration: Variable: "#{SourceVariables.RepositoryName}" Value: MyDemoRepo Operator: EQ inputArtifacts: [] region: us-west-2 ``` ------ #### [ JSON ] ``` "rules": [ { "name": "MyVariableCheck", "ruleTypeId": { "category": "Rule", "owner": "AWS", "provider": "VariableCheck", "version": "1" }, "configuration": { "Variable": "#{SourceVariables.RepositoryName}", "Value": "MyDemoRepo", "Operator": "EQ" }, "inputArtifacts": [], "region": "us-west-2" } ] ``` ------ ## Lihat juga Sumber daya terkait berikut dapat membantu Anda saat Anda bekerja dengan aturan ini. + [Tutorial: Buat aturan pemeriksaan variabel untuk pipeline sebagai kondisi entri](tutorials-varcheckrule.md)- Bagian ini menyediakan tutorial dengan langkah-langkah untuk membuat kondisi On Entry dengan aturan pemeriksaan variabel. + [Referensi variabel](reference-variables.md)— Bagian ini memberikan informasi referensi dan contoh untuk variabel pipeline. + Untuk informasi selengkapnya tentang aturan dan ketentuan, lihat [Kondisi [RuleTypeId](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleTypeId.html)](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_Condition.html), dan [RuleExecution](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleExecution.html)di *Panduan CodePipeline API*.