Konfigurasikan kondisi untuk sebuah panggung - AWS CodePipeline
Gunakan kasus untuk kondisi panggungPertimbangan untuk hasil yang dikonfigurasi untuk kondisi panggungPertimbangan untuk aturan yang dikonfigurasi untuk kondisi panggungMembuat kondisi EntriMenciptakan kondisi KegagalanMenciptakan kondisi SuksesMenghapus kondisi panggungKondisi panggung utama

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.

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 ALARM status 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 onFailure kondisi.

  • 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.

  • Tipe Hasil yang dikonfigurasi pada kegagalan kondisi Status panggung Mengesampingkan perilaku
    Entry Gagal Sedang berlangsung Panggung berlangsung.
    Entry Lewati Dilewati Tidak berlaku.

    OnFailure

    		 Rollback Failed Panggung gagal.
    OnSuccess Rollback Berhasil Panggung berlangsung.

    OnSuccess

    		 Gagal Failed Panggung berlangsung.

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. ARNSiapkan fungsi Lambda saat Anda mengonfigurasi aturan.

  • Untuk CloudWatchAlarm aturan, Anda harus terlebih dahulu mengkonfigurasi CloudWatch acara Acara yang akan digunakan dalam aturan. ARNSiapkan acara saat Anda mengonfigurasi aturan.

Membuat kondisi Entri

Anda dapat mengonfigurasi kondisi Entri untuk panggung menggunakan konsol atauCLI. 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 lebih lanjut, lihat Kondisi RuleTypeId,, dan RuleExecutiondi CodePipeline APIPanduan.

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

  2. Masuk ke AWS Management Console dan buka CodePipeline konsol di http://console.aws.amazon. com/codesuite/codepipeline/home.

    Nama dan status semua saluran pipa yang terkait dengan Anda Akun AWS ditampilkan.

  3. Di Nama, pilih nama pipeline yang ingin Anda edit.

  4. Pada halaman detail pipeline, pilih Edit.

  5. Pada halaman Edit, untuk tindakan yang ingin Anda edit, pilih Edit tahap.

  6. Pilih Tambahkan kondisi entri. Kartu kondisi entri tahap Sebelum ditampilkan dengan opsi Gagal yang tersedia untuk kondisi ini.

  7. Pilih Tambahkan aturan, lalu selesaikan yang berikut ini.

    1. Di Nama aturan, masukkan nama untuk aturan Anda. Untuk contoh ini, masukkanMyAlarmRule.

    2. 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.

    3. Di Wilayah, pilih Wilayah untuk kondisi Anda atau biarkan default.

    4. Dalam nama Alarm, pilih CloudWatch sumber daya yang akan digunakan untuk aturan. Anda harus sudah membuat sumber daya di akun Anda.

    5. (Opsional) Dalam Waktu tunggu, masukkan jumlah waktu yang CodePipeline akan menunggu jika alarm dalam ALARM keadaan saat pertama kali dievaluasi. Jika alarm status OK ketika aturan pertama kali diperiksa, aturan akan segera berhasil.

    6. (Opsional) Masukkan status alarm tertentu untuk dipantau, dan masukkan peran ARN jika sesuai.

    7. Setelah selesai mengedit panggung, pilih Selesai. Pada halaman edit pipeline, pilih Simpan.

  8. 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, lihatPertimbangan untuk hasil yang dikonfigurasi untuk kondisi panggung.

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

  2. Masuk ke AWS Management Console dan buka CodePipeline konsol di http://console.aws.amazon. com/codesuite/codepipeline/home.

    Nama dan status semua saluran pipa yang terkait dengan Anda Akun AWS ditampilkan.

  3. Di Nama, pilih nama pipeline yang ingin Anda edit.

  4. Pada halaman detail pipeline, pilih Edit.

  5. Pada halaman Edit, untuk tindakan yang ingin Anda edit, pilih Edit tahap.

  6. Pilih Tambahkan kondisi entri, lalu pilih Lewati sebagai hasilnya.

  7. Pilih Tambahkan aturan, lalu selesaikan yang berikut ini.

    1. Di Nama aturan, masukkan nama untuk aturan Anda. Untuk contoh ini, masukkanMyAlarmRule.

    2. 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.

      Contoh proses rilis menggunakan CodePipeline.

    3. Di Wilayah, pilih Wilayah untuk kondisi Anda atau biarkan default.

    4. Di Variabel, pilih variabel yang akan dibandingkan, seperti #{SourceVariables.FullRepositoryName} untuk pipeline yang memiliki aksi sumber GitHub Versi 2. Masukkan nama repositori dan pilih operator, seperti Equals.

    5. Setelah selesai mengedit panggung, pilih Selesai. Pada halaman edit pipeline, pilih Simpan.

  8. Setelah lari, lihat hasilnya.

    Contoh proses rilis menggunakan CodePipeline.

  9. 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.

    Contoh halaman detail kondisi yang menunjukkan kondisi hasil Lewati di CodePipeline.

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 danEdit pipa di CodePipeline.

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 SuccessConditionsdi Referensi. CodePipeline API

Membuat kondisi Entri (CFN)

Untuk menggunakan AWS 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 bernamaMyMonitorRule: 

    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 beforeEntry kondisi, lihat AWS::CodePipeline: :Pipeline BeforeEntryConditions StageDeclaration di bawah AWS CloudFormation Panduan Pengguna.

Menciptakan kondisi Kegagalan

Anda dapat mengonfigurasi kondisi On Failure untuk panggung menggunakan konsol atauCLI. 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 Pada Kegagalan (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

  2. Masuk ke AWS Management Console dan buka CodePipeline konsol di http://console.aws.amazon. com/codesuite/codepipeline/home.

    Nama dan status semua saluran pipa yang terkait dengan Anda Akun AWS ditampilkan.

  3. Di Nama, pilih nama pipeline yang ingin Anda edit.

  4. Pada halaman detail pipeline, pilih Edit.

  5. Pada halaman Edit, untuk tindakan yang ingin Anda edit, pilih Edit tahap.

  6. Pilih Tambahkan kondisi kegagalan. Kartu kondisi Kegagalan ditampilkan dengan opsi Rollback yang tersedia untuk kondisi ini.

  7. Pilih Tambahkan aturan, lalu selesaikan yang berikut ini.

    1. Di Nama aturan, masukkan nama untuk aturan Anda. Untuk contoh ini, masukkanMyLambdaRule.

    2. 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.

    3. Di Wilayah, pilih Wilayah untuk kondisi Anda atau biarkan default.

    4. Di artefak Input, pilih artefak sumber.

    5. Di nama Fungsi, pilih sumber daya Lambda yang akan digunakan untuk aturan. Anda harus sudah membuat sumber daya di akun Anda.

    6. (Opsional) Dalam parameter Pengguna, masukkan pasangan apa pun yang mewakili parameter untuk konfigurasi tambahan.

    7. (Opsional) Di Role Arn, masukkan peran ARN jika dikonfigurasi.

    8. (Opsional) Di Timeout in Minutes, masukkan waktu dalam menit yang harus ditunggu aturan sebelum batas waktu.

    9. Setelah selesai mengedit panggung, pilih Selesai. Pada halaman edit pipeline, pilih Simpan.

Membuat onFailure kondisi dengan contoh hasil Coba Ulang (Konsol)

Anda dapat mengonfigurasi onFailure kondisi untuk suatu 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 onFailure kondisi 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

  2. Masuk ke AWS Management Console dan buka CodePipeline konsol di http://console.aws.amazon. com/codesuite/codepipeline/home.

    Nama dan status semua saluran pipa yang terkait dengan Anda Akun AWS ditampilkan.

  3. Di Nama, pilih nama pipeline yang ingin Anda edit.

  4. Pada halaman detail pipeline, pilih Edit.

  5. Pada halaman Edit, untuk tindakan yang ingin Anda edit, pilih Edit tahap.

  6. 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.

    Mengkonfigurasi mode coba lagi untuk tahap di. CodePipeline

  7. Pilih untuk menambahkan onFailure kondisi dan kemudian pilih Tambah aturan dan masukkan aturan untuk kondisi tersebut.

    1. Di Nama aturan, masukkan nama untuk aturan Anda. Untuk contoh ini, masukkanMyAlarmRule.

    2. 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.

    3. Di Wilayah, pilih Wilayah untuk kondisi Anda atau biarkan default.

    4. Di Nama Alarm, pilih sumber daya yang dikonfigurasi untuk peringatan.

    5. Setelah selesai mengedit panggung, pilih Selesai. Pada halaman edit pipeline, pilih Simpan.

  8. 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 danEdit pipa di CodePipeline.

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 FailureConditionsdi CodePipeline APIReferensi.

Membuat kondisi Kegagalan (CFN)

Untuk menggunakan AWS 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 bernamaMyMonitorRule: 

    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 OnFailureStageDeclarationdi bawah Panduan AWS CloudFormation Pengguna.

Menciptakan kondisi Sukses

Anda dapat mengonfigurasi kondisi On Success untuk panggung menggunakan konsol atauCLI. 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 lebih lanjut, lihat Kondisi RuleTypeId,, dan RuleExecutiondi CodePipeline APIPanduan.

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

  2. Masuk ke AWS Management Console dan buka CodePipeline konsol di http://console.aws.amazon. com/codesuite/codepipeline/home.

    Nama dan status semua saluran pipa yang terkait dengan Anda Akun AWS ditampilkan.

  3. Di Nama, pilih nama pipeline yang ingin Anda edit.

  4. Pada halaman detail pipeline, pilih Edit.

  5. Pada halaman Edit, untuk tindakan yang ingin Anda edit, pilih Edit tahap.

  6. 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.

  7. Pilih Tambahkan aturan, lalu selesaikan yang berikut ini.

    1. Di Nama aturan, masukkan nama untuk kondisi Anda. Untuk contoh ini, masukkanMyDeploymentRule.

    2. Di Penyedia aturan, pilih aturan yang telah dikonfigurasi untuk ditambahkan ke kondisi Anda. Untuk contoh ini, pilih AWS DeploymentWindow, lalu selesaikan langkah-langkah berikut.

    3. Di Wilayah, pilih Wilayah untuk kondisi Anda atau biarkan default.

    4. 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.

    5. (Opsional) Masuk TimeZone, masukkan zona waktu untuk jendela penyebaran.

  8. Setelah lari, lihat hasilnya.

    Contoh kondisi di CodePipeline.

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 danEdit pipa di CodePipeline.

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 bertahapDeploy, 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 SuccessConditionsdi CodePipeline APIReferensi.

Buat kondisi On Success (CFN)

Untuk menggunakan AWS 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 bernamaMyDeploymentWindowRule: 

    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 OnFailureStageDeclarationdi bawah Panduan Pengguna.AWS CloudFormation

Menghapus kondisi panggung

Anda dapat menghapus kondisi tahap yang telah dikonfigurasi untuk pipeline Anda.

Untuk menghapus kondisi panggung

  1. Masuk ke AWS Management Console dan buka CodePipeline konsol di http://console.aws.amazon. com/codesuite/codepipeline/home.

    Nama dan status semua saluran pipa yang terkait dengan Anda Akun AWS ditampilkan.

  2. Di Nama, pilih nama pipeline yang ingin Anda edit.

  3. Pada halaman detail pipeline, pilih Edit.

  4. Pada halaman Edit, untuk kondisi yang ingin Anda edit, pilih Edit tahap.

  5. 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 mengganti kondisi panggung

  1. Dalam contoh ini, tahap pipa berjalan dengan suatu kondisi. Tombol Override diaktifkan.

    Contoh kondisi di CodePipeline.

  2. Di samping kondisi yang ingin Anda ganti, pilih Override.

    Contoh kondisi di CodePipeline.

  3. 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.

    Contoh halaman detail kondisi yang menunjukkan kondisi yang diganti di. CodePipeline