Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Konfigurasikan kondisi untuk sebuah panggung
Anda dapat menentukan kondisi untuk tahap, seperti memeriksa variabel tertentu dalam proses pipeline, dan kemudian melibatkan hasil untuk kondisi tersebut, seperti melewatkan tahap atau gagal tahap. Pipeline dapat diatur untuk memeriksa kondisi tahap selama proses, di mana Anda menentukan pemeriksaan untuk tahap dan kemudian menentukan bagaimana tahap harus dilanjutkan ketika kondisi tertentu terpenuhi. Ketentuan berisi satu atau lebih aturan yang tersedia dalam daftar aturan di CodePipeline. Jika semua aturan dalam suatu kondisi berhasil, maka kondisinya terpenuhi. Anda dapat mengonfigurasi kondisi sehingga ketika kriteria tidak terpenuhi, hasil yang ditentukan akan terlibat.
Setiap kondisi memiliki set aturan yang merupakan seperangkat aturan yang diurutkan yang dievaluasi bersama. Karena itu, jika satu aturan gagal dalam kondisi tersebut, maka kondisinya gagal. Anda dapat mengganti kondisi aturan saat runtime pipeline.
Kondisi digunakan untuk jenis ekspresi tertentu dan masing-masing memiliki opsi khusus untuk hasil yang tersedia sebagai berikut:
+ **Entri** - Ketentuan untuk melakukan pemeriksaan yang, jika terpenuhi, memungkinkan masuk ke suatu panggung. Aturan terlibat dengan opsi hasil berikut: **Gagal** atau **Lewati**
+ **Pada Kegagalan** - Kondisi untuk melakukan pemeriksaan untuk tahap ketika gagal. Aturan terlibat dengan opsi hasil berikut: **Rollback**
+ **Tentang Sukses** - Kondisi untuk melakukan pemeriksaan untuk tahap ketika berhasil. **Aturan terlibat dengan opsi hasil berikut: **Rollback** atau Gagal**
Kondisi didukung oleh seperangkat *aturan* untuk setiap jenis kondisi.
Untuk setiap jenis kondisi, ada tindakan spesifik yang diatur oleh kondisi tersebut. Tindakan tersebut adalah hasil dari pemeriksaan kondisi yang berhasil atau gagal. Misalnya, kondisi untuk entri (kondisi entri) menemui alarm (aturan), maka cek berhasil dan hasil (tindakan) adalah entri tahap diblokir.
Anda juga dapat menggunakan AWS CodePipeline konsol atau AWS CLI untuk memutar kembali secara manual atau mencoba lagi tahap atau tindakan dalam satu tahap. Lihat [Konfigurasikan kondisi untuk sebuah panggung](#stage-conditions).
**Topics**
+ [Gunakan kasus untuk kondisi panggung](#stage-conditions-cases)
+ [Pertimbangan untuk hasil yang dikonfigurasi untuk kondisi panggung](#stage-conditions-considerations)
+ [Pertimbangan untuk aturan yang dikonfigurasi untuk kondisi panggung](#stage-conditions-considerations-rules)
+ [Membuat kondisi Entri](#stage-conditions-entry)
+ [Menciptakan kondisi Kegagalan](#stage-conditions-onfailure)
+ [Menciptakan kondisi Sukses](#stage-conditions-onsuccess)
+ [Menghapus kondisi panggung](#stage-conditions-delete)
+ [Kondisi panggung utama](#stage-conditions-override)
## Gunakan kasus untuk kondisi panggung
Kondisi panggung memiliki beberapa kasus penggunaan untuk mengatur pelepasan dan perubahan keamanan di saluran pipa. Berikut ini adalah contoh kasus penggunaan untuk kondisi panggung.
+ Gunakan kondisi Entri untuk menentukan kondisi yang akan memeriksa status CloudWatch alarm, yang kemudian akan memblokir perubahan jika lingkungan produksi tidak dalam keadaan sehat.
+ Gunakan kondisi Entri dengan waktu tunggu 60 untuk menentukan kondisi yang akan dievaluasi ketika semua tindakan dalam tahap telah berhasil diselesaikan, dan kemudian putar kembali perubahan jika CloudWatch alarm masuk ke status ALARM dalam waktu 60 menit.
+ Gunakan kondisi On Success untuk menentukan kondisi sehingga ketika tahap selesai dengan sukses, aturan akan memeriksa apakah waktu saat ini ada di jendela penerapan dan kemudian menyebarkan jika aturan berhasil.
## Pertimbangan untuk hasil yang dikonfigurasi untuk kondisi panggung
Pertimbangan untuk kondisi panggung adalah sebagai berikut:
+ Anda tidak dapat menggunakan percobaan ulang tahap otomatis dengan kondisi OnFailure.
+ Saat mengonfigurasi kondisi dengan hasil **Rollback**, tahap hanya dapat memutar kembali ke eksekusi sebelumnya jika tersedia dalam versi struktur pipa saat ini.
+ Saat mengonfigurasi kondisi dengan hasil **Rollback**, Anda tidak dapat memutar kembali ke ID eksekusi target yang merupakan tipe eksekusi rollback.
+ **Untuk kondisi Entri yang menggunakan hasil Lewati untuk melewati tahap jika kondisi gagal, hanya `VariableCheck` aturan `LambdaInvoke` dan yang didukung.**
+ Anda tidak dapat melakukan percobaan ulang tahap manual di panggung dalam status **Skipped**.
+ Anda tidak dapat melakukan rollback manual ke tahap dalam status **Skipped**.
+ Anda tidak dapat mengganti kondisi jika kondisi dikonfigurasi dengan hasil **Lewati**.
+ Dengan pengecualian hasil **Lewati**, Anda dapat mengganti kondisi tahap saat memulai eksekusi pipeline. Untuk kondisi tahap di mana override dilibatkan, eksekusi akan dilakukan seperti yang dijelaskan dalam tabel berikut.
+
****
[See the AWS documentation website for more details](http://docs.aws.amazon.com/id_id/codepipeline/latest/userguide/stage-conditions.html)
## Pertimbangan untuk aturan yang dikonfigurasi untuk kondisi panggung
Pertimbangan untuk aturan yang tersedia untuk kondisi tahap adalah sebagai berikut:
+ Untuk `LambdaInvoke` aturan, Anda harus terlebih dahulu mengkonfigurasi fungsi Lambda untuk digunakan dalam aturan. Siapkan fungsi Lambda ARN saat Anda mengonfigurasi aturan.
+ Untuk `CloudWatchAlarm` aturan, Anda harus terlebih dahulu mengkonfigurasi CloudWatch acara Acara yang akan digunakan dalam aturan. Siapkan acara ARN saat Anda mengonfigurasi aturan.
## Membuat kondisi Entri
Anda dapat mengonfigurasi kondisi Entri untuk panggung menggunakan konsol atau CLI. Anda akan mengonfigurasi aturan dan hasil yang sesuai untuk setiap kondisi. Untuk hasil rollback, pipeline hanya dapat memutar kembali ke eksekusi sebelumnya jika eksekusi sebelumnya dimulai dalam versi struktur pipa saat ini.
Langkah-langkah memberikan contoh kondisi Entri yang menggunakan aturan monitor.
Untuk informasi selengkapnya, 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*.
### Membuat kondisi Entri - contoh CloudWatchAlarm aturan (Konsol)
Anda dapat mengonfigurasi kondisi Entri untuk tahap, bersama dengan aturan dan hasil yang Anda inginkan untuk dilakukan tahapan saat kondisi terpenuhi.
**Konfigurasikan kondisi Entri (konsol)**
1. Lengkapi prasyarat apa pun, seperti membuat sumber daya dan ARN untuk aturan di mana sumber daya disediakan, seperti. **AWS CloudWatchAlarm**
1. Masuk ke Konsol Manajemen AWS dan buka CodePipeline konsol di [http://console.aws.amazon. com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home).
Nama dan status semua saluran pipa yang terkait dengan Anda Akun AWS ditampilkan.
1. Di **Nama**, pilih nama pipeline yang ingin Anda edit.
1. Pada halaman detail pipeline, pilih **Edit**.
1. Pada halaman **Edit**, untuk tindakan yang ingin Anda edit, pilih **Edit tahap**.
1. Pilih **Tambahkan kondisi entri**. Kartu **kondisi entri tahap Sebelum** ditampilkan dengan opsi **Gagal** yang tersedia untuk kondisi ini.
1. Pilih **Tambahkan aturan**, lalu selesaikan yang berikut ini.
1. Di **Nama aturan**, masukkan nama untuk aturan Anda. Untuk contoh ini, masukkan`MyAlarmRule`.
1. Di **Penyedia aturan, pilih penyedia** aturan yang telah dikonfigurasi sebelumnya untuk ditambahkan ke kondisi Anda. Untuk contoh ini, pilih **AWS CloudWatchAlarm**, lalu selesaikan langkah-langkah berikut.
1. Di **Wilayah**, pilih Wilayah untuk kondisi Anda atau biarkan default.
1. Dalam **nama Alarm**, pilih CloudWatch sumber daya yang akan digunakan untuk aturan. Anda harus sudah membuat sumber daya di akun Anda.
1. (Opsional) Dalam **Waktu tunggu**, masukkan jumlah waktu yang CodePipeline akan menunggu jika alarm dalam keadaan ALARM saat pertama kali dievaluasi. Jika alarm status OK ketika aturan pertama kali diperiksa, aturan akan segera berhasil.
1. (Opsional) Masukkan status alarm tertentu untuk dipantau, dan masukkan peran ARN jika sesuai.
1. Setelah selesai mengedit panggung, pilih **Selesai**. Pada halaman edit pipeline, pilih **Simpan**.
1. Setelah lari, lihat hasilnya.
### Membuat kondisi Entri dengan Lewati hasil dan `VariableCheck` aturan (konsol)
Anda dapat mengonfigurasi kondisi Entri untuk suatu tahap sehingga jika kondisi entri tidak terpenuhi, tahap dilewati Jika kondisi gagal, maka hasilnya terlibat dan tahap dilewati. Ketika sebuah panggung dilewati, status panggung **dilewati**, dan status tindakannya **tidak** dijalankan. Untuk pertimbangan kondisi panggung dengan hasil Lewati, lihat[Pertimbangan untuk hasil yang dikonfigurasi untuk kondisi panggung](#stage-conditions-considerations).
Dalam contoh berikut, aturan pemeriksaan variabel menemukan bahwa nilainya tidak cocok, dan tahap build dilewati.
**Konfigurasikan kondisi Entri dengan hasil **Lewati** (konsol)**
1. Lengkapi prasyarat apa pun, seperti membuat sumber daya dan ARN untuk aturan di mana sumber daya disediakan, seperti. **AWS CloudWatchAlarm**
1. Masuk ke Konsol Manajemen AWS dan buka CodePipeline konsol di [http://console.aws.amazon. com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home).
Nama dan status semua saluran pipa yang terkait dengan Anda Akun AWS ditampilkan.
1. Di **Nama**, pilih nama pipeline yang ingin Anda edit.
1. Pada halaman detail pipeline, pilih **Edit**.
1. Pada halaman **Edit**, untuk tindakan yang ingin Anda edit, pilih **Edit tahap**.
1. Pilih **Tambahkan kondisi entri**, lalu pilih **Lewati** sebagai hasilnya.
1. Pilih **Tambahkan aturan**, lalu selesaikan yang berikut ini.
1. Di **Nama aturan**, masukkan nama untuk aturan Anda. Untuk contoh ini, masukkan`MyAlarmRule`.
1. Di **Penyedia aturan, pilih penyedia** aturan yang telah dikonfigurasi sebelumnya untuk ditambahkan ke kondisi Anda. Untuk contoh ini, pilih **VariableCheck**, lalu selesaikan langkah-langkah berikut.
1. Di **Wilayah**, pilih Wilayah untuk kondisi Anda atau biarkan default.
1. Di **Variable**, pilih variabel yang akan dibandingkan, seperti `#{SourceVariables.FullRepositoryName}` untuk pipeline yang memiliki aksi sumber GitHub (via GitHub App). **Masukkan nama repositori dan pilih operator, seperti Equals.**
1. Setelah selesai mengedit panggung, pilih **Selesai**. Pada halaman edit pipeline, pilih **Simpan**.
1. Setelah lari, lihat hasilnya.
1. Untuk meninjau detail, pilih **Tinjau**. Detail dalam contoh berikut menunjukkan bahwa hasil yang dikonfigurasi untuk kondisi tersebut adalah **Lewati**, yang tidak dapat diganti. Status aturan **Gagal** karena kondisi tidak terpenuhi.
### Membuat kondisi Entri (CLI)
Untuk menggunakan AWS CLI untuk mengkonfigurasi kondisi Entri, gunakan perintah untuk membuat atau memperbarui pipeline seperti yang dijelaskan dalam [Buat pipeline, tahapan, dan tindakan](pipelines-create.md) dan[Edit pipa di CodePipeline](pipelines-edit.md).
**Konfigurasikan kondisi dan aturan atau aturan (CLI)**
+ Buka terminal (Linux, macOS, atau Unix) atau command prompt (Windows) dan gunakan AWS CLI untuk menjalankan `update-pipeline` perintah, menentukan kondisi kegagalan dalam struktur pipa. Contoh berikut mengonfigurasi kondisi Entri untuk nama bertahap: `Deploy`
```
{
"name": "Deploy",
"actions": [
{
"name": "Deploy",
"actionTypeId": {
"category": "Deploy",
"owner": "AWS",
"provider": "S3",
"version": "1"
},
"runOrder": 1,
"configuration": {
"BucketName": "MyBucket",
"Extract": "false",
"ObjectKey": "object.xml"
},
"outputArtifacts": [],
"inputArtifacts": [
{
"name": "SourceArtifact"
}
],
"region": "us-east-1",
"namespace": "DeployVariables"
}
],
{{ "beforeEntry": {
"conditions": [
{
"result": "FAIL",
"rules": [
{
"name": "MyAlarmRule",
"ruleTypeId": {
"category": "Rule",
"owner": "AWS",
"provider": "CloudWatchAlarm",
"version": "1"
},
"configuration": {
"AlarmName": "CWAlarm",
"WaitTime": "1"
},
"inputArtifacts": [],
"region": "us-east-1"
}
]
}
]
}}}
}
```
*Untuk informasi selengkapnya tentang mengonfigurasi kondisi keberhasilan untuk rollback tahap, lihat [SuccessConditions](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_SuccessConditions.html)di Referensi API. CodePipeline *
### Membuat kondisi Entri (CFN)
Untuk menggunakan CloudFormation untuk mengkonfigurasi kondisi Entri, gunakan `beforeEntry` parameter. Saat masuk, panggung akan menjalankan aturan dan melakukan hasilnya.
```
beforeEntry:
Result: FAIL
```
+ Perbarui template seperti yang ditunjukkan pada cuplikan berikut. Contoh berikut mengkonfigurasi kondisi Entri dengan aturan bernama`MyMonitorRule`:
```
Name: Deploy
Actions:
- Name: Deploy
ActionTypeId:
Category: Deploy
Owner: AWS
Provider: S3
Version: '1'
RunOrder: 1
Configuration:
BucketName: MyBucket
Extract: 'false'
ObjectKey: object.xml
OutputArtifacts: []
InputArtifacts:
- Name: SourceArtifact
Region: us-east-1
Namespace: DeployVariables
BeforeEntry:
Conditions:
- Result: FAIL
Rules:
- Name: MyMonitorRule
RuleTypeId:
Category: Rule
Owner: AWS
Provider: CloudWatchAlarm
Version: '1'
Configuration:
AlarmName: CWAlarm
WaitTime: '1'
InputArtifacts: []
Region: us-east-1
```
*Untuk informasi selengkapnya tentang mengonfigurasi kondisi beforeEntry, lihat [AWS::CodePipeline::Pipeline BeforeEntryConditions](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-codepipeline-pipeline-beforeentryconditions.html)`StageDeclaration`di bawah Panduan Pengguna.CloudFormation *
## Menciptakan kondisi Kegagalan
Anda dapat mengonfigurasi kondisi On Failure untuk panggung menggunakan konsol atau CLI. Anda akan mengonfigurasi aturan dan hasil yang sesuai untuk setiap kondisi. Untuk hasil rollback, pipeline hanya dapat memutar kembali ke eksekusi sebelumnya jika eksekusi sebelumnya dimulai dalam versi struktur pipa saat ini.
### Membuat kondisi On Failure (Konsol)
Anda dapat mengonfigurasi kondisi On Failure untuk sebuah panggung, bersama dengan aturan dan hasil yang Anda inginkan untuk dilakukan tahapan saat kondisi terpenuhi.
**Konfigurasikan kondisi On Failure (konsol)**
1. Lengkapi prasyarat apa pun, seperti membuat sumber daya dan ARN untuk aturan di mana sumber daya disediakan, seperti aturan. **LambdaInvoke**
1. Masuk ke Konsol Manajemen AWS dan buka CodePipeline konsol di [http://console.aws.amazon. com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home).
Nama dan status semua saluran pipa yang terkait dengan Anda Akun AWS ditampilkan.
1. Di **Nama**, pilih nama pipeline yang ingin Anda edit.
1. Pada halaman detail pipeline, pilih **Edit**.
1. Pada halaman **Edit**, untuk tindakan yang ingin Anda edit, pilih **Edit tahap**.
1. Pilih **Tambahkan kondisi kegagalan**. Kartu **kondisi Kegagalan** ditampilkan dengan opsi **Rollback** yang tersedia untuk kondisi ini.
1. Pilih **Tambahkan aturan**, lalu selesaikan yang berikut ini.
1. Di **Nama aturan**, masukkan nama untuk aturan Anda. Untuk contoh ini, masukkan`MyLambdaRule`.
1. Di **Penyedia aturan, pilih penyedia** aturan yang telah dikonfigurasi sebelumnya untuk ditambahkan ke kondisi Anda. Untuk contoh ini, pilih **AWS LambdaInvoke**, lalu selesaikan langkah-langkah berikut.
1. Di **Wilayah**, pilih Wilayah untuk kondisi Anda atau biarkan default.
1. Di **artefak Input**, pilih artefak sumber.
1. Di **nama Fungsi**, pilih sumber daya Lambda yang akan digunakan untuk aturan. Anda harus sudah membuat sumber daya di akun Anda.
1. (Opsional) Dalam **parameter Pengguna**, masukkan pasangan apa pun yang mewakili parameter untuk konfigurasi tambahan.
1. (Opsional) Di **Role Arn**, masukkan peran ARN jika dikonfigurasi.
1. (Opsional) Di **Timeout in Minutes**, masukkan waktu dalam menit yang harus ditunggu aturan sebelum batas waktu.
1. Setelah selesai mengedit panggung, pilih **Selesai**. Pada halaman edit pipeline, pilih **Simpan**.
### Membuat kondisi onFailure dengan contoh hasil Coba Ulang (Konsol)
Anda dapat mengonfigurasi kondisi onFailure untuk tahap sehingga jika kondisi entri tidak terpenuhi, tahap dicoba lagi. Sebagai bagian dari hasil ini, Anda mengonfigurasi mode coba lagi, menentukan apakah akan mencoba lagi tindakan yang gagal atau mencoba lagi tahap yang gagal.
**Konfigurasikan kondisi onFailure dengan hasil Coba Ulang (konsol)**
1. Lengkapi prasyarat apa pun, seperti membuat sumber daya dan ARN untuk aturan di mana sumber daya disediakan, seperti. **AWS CloudWatchAlarm**
1. Masuk ke Konsol Manajemen AWS dan buka CodePipeline konsol di [http://console.aws.amazon. com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home).
Nama dan status semua saluran pipa yang terkait dengan Anda Akun AWS ditampilkan.
1. Di **Nama**, pilih nama pipeline yang ingin Anda edit.
1. Pada halaman detail pipeline, pilih **Edit**.
1. Pada halaman **Edit**, untuk tindakan yang ingin Anda edit, pilih **Edit tahap**.
1. Di bagian bawah panggung, di bawah **Konfigurasi tahap otomatis:**, pilih **Aktifkan coba ulang otomatis pada kegagalan panggung**. Dalam **mode Coba lagi**, pilih salah satu **Coba lagi tahap gagal atau Coba** **lagi** tindakan yang gagal.
1. Pilih untuk menambahkan kondisi OnFailure dan kemudian pilih **Tambah aturan** dan masukkan aturan untuk kondisi tersebut.
1. Di **Nama aturan**, masukkan nama untuk aturan Anda. Untuk contoh ini, masukkan`MyAlarmRule`.
1. Di **Penyedia aturan, pilih penyedia** aturan yang telah dikonfigurasi sebelumnya untuk ditambahkan ke kondisi Anda. Untuk contoh ini, pilih **CloudWatchAlarm**, lalu selesaikan langkah-langkah berikut.
1. Di **Wilayah**, pilih Wilayah untuk kondisi Anda atau biarkan default.
1. Di **Nama Alarm**, pilih sumber daya yang dikonfigurasi untuk peringatan.
1. Setelah selesai mengedit panggung, pilih **Selesai**. Pada halaman edit pipeline, pilih **Simpan**.
1. Setelah lari, lihat hasilnya.
### Membuat kondisi Kegagalan (CLI)
Untuk menggunakan AWS CLI untuk mengkonfigurasi kondisi On Failure, gunakan perintah untuk membuat atau memperbarui pipeline seperti yang dijelaskan dalam [Buat pipeline, tahapan, dan tindakan](pipelines-create.md) dan[Edit pipa di CodePipeline](pipelines-edit.md).
**Konfigurasikan kondisi dan aturan atau aturan (CLI)**
+ Buka terminal (Linux, macOS, atau Unix) atau command prompt (Windows) dan gunakan AWS CLI untuk menjalankan `update-pipeline` perintah, menentukan kondisi kegagalan dalam struktur pipa. Contoh berikut mengonfigurasi kondisi On Failure untuk nama bertahap: `Deploy`
```
{
"name": "Deploy",
"actions": [
{
"name": "Deploy",
"actionTypeId": {
"category": "Deploy",
"owner": "AWS",
"provider": "S3",
"version": "1"
},
"runOrder": 1,
"configuration": {
"BucketName": "MyBucket",
"Extract": "false",
"ObjectKey": "object.xml"
},
"outputArtifacts": [],
"inputArtifacts": [
{
"name": "SourceArtifact"
}
],
"region": "us-east-1",
"namespace": "DeployVariables"
}
],
{{ "onFailure": {
"conditions": [
{
"result": "ROLLBACK",
"rules": [
{
"name": "MyLambdaRule",
"ruleTypeId": {
"category": "Rule",
"owner": "AWS",
"provider": "LambdaInvoke",
"version": "1"
},
"configuration": {
"FunctionName": "my-function"
},
"inputArtifacts": [
{
"name": "SourceArtifact"
}
],
"region": "us-east-1"
}
]
}
]
}}}
}
```
Untuk informasi selengkapnya tentang mengonfigurasi kondisi kegagalan, lihat [FailureConditions](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_FailureConditions.html)di *Referensi CodePipeline API*.
### Membuat kondisi Kegagalan (CFN)
Untuk menggunakan CloudFormation untuk mengkonfigurasi kondisi On Failure, gunakan `OnFailure` parameter. Pada kesuksesan, panggung akan menjalankan aturan dan melakukan hasilnya.
```
OnFailure:
Result: ROLLBACK
```
+ Perbarui template seperti yang ditunjukkan pada cuplikan berikut. Contoh berikut mengkonfigurasi OnFailure kondisi dengan aturan bernama`MyMonitorRule`:
```
name: Deploy
actions:
- name: Deploy
actionTypeId:
category: Deploy
owner: AWS
provider: S3
version: '1'
runOrder: 1
configuration:
BucketName: MyBucket
Extract: 'false'
ObjectKey: object.xml
outputArtifacts: []
inputArtifacts:
- name: SourceArtifact
region: us-east-1
namespace: DeployVariables
OnFailure:
conditions:
- result: ROLLBACK
rules:
- name: MyMonitorRule
ruleTypeId:
category: Rule
owner: AWS
provider: CloudWatchAlarm
version: '1'
configuration:
AlarmName: AlarmOnHelloWorldInvocation
AlarmStates: ALARM
WaitTime: '1'
inputArtifacts: []
region: us-east-1
```
Untuk informasi selengkapnya tentang mengonfigurasi kondisi kegagalan, lihat [OnFailure](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-codepipeline-pipeline-stagedeclaration.html#cfn-codepipeline-pipeline-stagedeclaration-onfailure)`StageDeclaration`di bawah *Panduan CloudFormation Pengguna*.
## Menciptakan kondisi Sukses
Anda dapat mengonfigurasi kondisi On Success untuk panggung menggunakan konsol atau CLI. Anda akan mengonfigurasi aturan dan hasil yang sesuai untuk setiap kondisi. Untuk hasil rollback, pipeline hanya dapat memutar kembali ke eksekusi sebelumnya jika eksekusi sebelumnya dimulai dalam versi struktur pipa saat ini.
Langkah-langkah tersebut memberikan contoh kondisi On Success yang menggunakan aturan jendela deployment.
Untuk informasi selengkapnya, 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*.
### Membuat kondisi Sukses (Konsol)
Anda dapat mengonfigurasi kondisi On Success untuk sebuah panggung, bersama dengan aturan dan hasil yang Anda inginkan untuk dilakukan panggung ketika kondisi terpenuhi.
**Konfigurasikan kondisi On Success (konsol)**
1. Lengkapi prasyarat apa pun, seperti membuat sumber daya dan ARN untuk aturan di mana sumber daya disediakan, seperti. AWS LambdaRule
1. Masuk ke Konsol Manajemen AWS dan buka CodePipeline konsol di [http://console.aws.amazon. com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home).
Nama dan status semua saluran pipa yang terkait dengan Anda Akun AWS ditampilkan.
1. Di **Nama**, pilih nama pipeline yang ingin Anda edit.
1. Pada halaman detail pipeline, pilih **Edit**.
1. Pada halaman **Edit**, untuk tindakan yang ingin Anda edit, pilih **Edit tahap**.
1. Pilih **Tambahkan kondisi sukses**. Kartu **kondisi sukses di atas panggung** ditampilkan. Pilih opsi **Rollback** atau **Fail** yang ditampilkan sebagai hasil yang tersedia untuk jenis kondisi ini.
1. Pilih **Tambahkan aturan**, lalu selesaikan yang berikut ini.
1. Di **Nama aturan**, masukkan nama untuk kondisi Anda. Untuk contoh ini, masukkan`MyDeploymentRule`.
1. Di **Penyedia aturan**, pilih aturan yang telah dikonfigurasi untuk ditambahkan ke kondisi Anda. Untuk contoh ini, pilih **AWS DeploymentWindow**, lalu selesaikan langkah-langkah berikut.
1. Di **Wilayah**, pilih Wilayah untuk kondisi Anda atau biarkan default.
1. **Di Cron**, masukkan ekspresi cron untuk jendela penerapan. Ekspresi cron mendefinisikan hari dan waktu ketika penerapan harus diizinkan. Untuk informasi referensi tentang ekspresi cron, lihat [Menggunakan ekspresi cron dan rate untuk menjadwalkan aturan](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-scheduled-rule-pattern.html#eb-cron-expressions).
1. (Opsional) Masuk **TimeZone**, masukkan zona waktu untuk jendela penyebaran.
1. Setelah lari, lihat hasilnya.
### Menciptakan kondisi Sukses (CLI)
Untuk menggunakan AWS CLI untuk mengkonfigurasi kondisi On Success, gunakan perintah untuk membuat atau memperbarui pipeline seperti yang dijelaskan dalam [Buat pipeline, tahapan, dan tindakan](pipelines-create.md) dan[Edit pipa di CodePipeline](pipelines-edit.md).
**Konfigurasikan kondisi dan aturan atau aturan (CLI)**
+ Buka terminal (Linux, macOS, atau Unix) atau command prompt (Windows) dan gunakan AWS CLI untuk menjalankan `update-pipeline` perintah, menentukan kondisi kegagalan dalam struktur pipa. Contoh berikut mengonfigurasi kondisi On Success untuk nama bertahap`Deploy`, di mana aturan diberi nama: `MyDeploymentRule`
```
{
"name": "Deploy",
"actions": [
{
"name": "Deploy",
"actionTypeId": {
"category": "Deploy",
"owner": "AWS",
"provider": "S3",
"version": "1"
},
"runOrder": 1,
"configuration": {
"BucketName": "MyBucket",
"Extract": "false",
"ObjectKey": "object.xml"
},
"outputArtifacts": [],
"inputArtifacts": [
{
"name": "SourceArtifact"
}
],
"region": "us-east-1",
"namespace": "DeployVariables"
}
],
{{ "onSuccess": {
"conditions": [
{
"result": "FAIL",
"rules": [
{
"name": "MyAlarmRule",
"ruleTypeId": {
"category": "Rule",
"owner": "AWS",
"provider": "CloudWatchAlarm",
"version": "1"
},
"configuration": {
"AlarmName": "CWAlarm",
"WaitTime": "1"
},
"inputArtifacts": [],
"region": "us-east-1"
}
]
}
]
}
}}}
```
Untuk informasi selengkapnya tentang mengonfigurasi kondisi keberhasilan, lihat [SuccessConditions](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_SuccessConditions.html)di *Referensi CodePipeline API*.
### Buat kondisi On Success (CFN)
Untuk menggunakan CloudFormation untuk mengkonfigurasi kondisi On Success, gunakan `OnSuccess` parameter. Pada kesuksesan, panggung akan menjalankan aturan dan melakukan hasilnya.
```
OnSuccess:
Result: ROLLBACK
```
+ Perbarui template seperti yang ditunjukkan pada cuplikan berikut. Contoh berikut mengkonfigurasi OnSuccess kondisi dengan aturan bernama`MyDeploymentWindowRule`:
```
name: Deploy
actions:
- name: Deploy
actionTypeId:
category: Deploy
owner: AWS
provider: S3
version: '1'
runOrder: 1
configuration:
BucketName: MyBucket
Extract: 'false'
ObjectKey: object.xml
outputArtifacts: []
inputArtifacts:
- name: SourceArtifact
region: us-east-1
namespace: DeployVariables{{
onSuccess:
conditions:
- result: FAIL
rules:
- name: MyMonitorRule
ruleTypeId:
category: Rule
owner: AWS
provider: CloudWatchAlarm
version: '1'
configuration:
AlarmName: CWAlarm
WaitTime: '1'
inputArtifacts: []
region: us-east-1
}}
```
*Untuk informasi selengkapnya tentang mengonfigurasi kondisi kegagalan untuk rollback tahap, lihat [OnFailure](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-codepipeline-pipeline-stagedeclaration.html#cfn-codepipeline-pipeline-stagedeclaration-onfailure)`StageDeclaration`di bawah Panduan Pengguna.CloudFormation *
## Menghapus kondisi panggung
Anda dapat menghapus kondisi tahap yang telah dikonfigurasi untuk pipeline Anda.
**Untuk menghapus kondisi panggung**
1. Masuk ke Konsol Manajemen AWS dan buka CodePipeline konsol di [http://console.aws.amazon. com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home).
Nama dan status semua saluran pipa yang terkait dengan Anda Akun AWS ditampilkan.
1. Di **Nama**, pilih nama pipeline yang ingin Anda edit.
1. Pada halaman detail pipeline, pilih **Edit**.
1. Pada halaman **Edit**, untuk kondisi yang ingin Anda edit, pilih **Edit tahap**.
1. Di samping kondisi yang ingin Anda hapus, pilih **Delete condition**.
## Kondisi panggung utama
Anda dapat mengganti kondisi panggung yang telah dikonfigurasi untuk pipeline Anda. Di konsol, saat tahap dan aturan berjalan, Anda dapat memilih untuk mengganti kondisi panggung. Ini menghasilkan tahapan berjalan
**Untuk mengesampingkan kondisi panggung**
1. Dalam contoh ini, tahap pipa berjalan dengan suatu kondisi. Tombol **Override** diaktifkan.
1. **Di samping kondisi yang ingin Anda ganti, pilih Override.**
1. Untuk meninjau detail, pilih **Tinjau**. Detail dalam contoh berikut menunjukkan bahwa hasil yang dikonfigurasi untuk kondisi tersebut adalah Gagal, yang telah diganti. Status aturan Ditinggalkan karena penggantian.
