Amazon CodeCatalyst tidak lagi terbuka untuk pelanggan baru. Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Lihat informasi yang lebih lengkap di [Cara bermigrasi dari CodeCatalyst](migration.md).
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Memerlukan persetujuan pada alur kerja berjalan
Anda dapat mengonfigurasi alur kerja untuk meminta persetujuan sebelum dapat dilanjutkan. Untuk mencapai ini, Anda harus menambahkan [gerbang](workflows-gates.md) **Persetujuan** ke alur kerja. *Gerbang Persetujuan* mencegah alur kerja berjalan hingga pengguna atau kumpulan pengguna mengirimkan satu atau beberapa persetujuan di konsol. CodeCatalyst Setelah semua persetujuan diberikan, gerbang 'tidak terkunci' dan alur kerja dijalankan diizinkan untuk dilanjutkan.
Gunakan gerbang **Persetujuan** dalam alur kerja Anda untuk memberi kesempatan kepada tim pengembangan, operasi, dan kepemimpinan Anda untuk meninjau perubahan Anda sebelum diterapkan ke khalayak yang lebih luas.
Untuk informasi selengkapnya tentang alur kerja berjalan, lihat[Menjalankan alur kerja](workflows-working-runs.md).
**Topics**
+ [Bagaimana cara membuka gerbang persetujuan?](#workflows-approval-conditions)
+ [Kapan menggunakan gerbang 'Persetujuan'](#workflows-approval-when)
+ [Siapa yang bisa memberikan persetujuan?](#workflows-approval-who)
+ [Bagaimana cara memberi tahu pengguna bahwa persetujuan diperlukan?](#workflows-approval-notify-methods)
+ [Dapatkah saya menggunakan gerbang 'Persetujuan' untuk mencegah alur kerja berjalan?](#workflows-approval-prevent)
+ [Bagaimana cara kerja persetujuan alur kerja dengan mode lari antrian, digantikan, dan paralel?](#workflows-approval-run-mode)
+ [Contoh: Gerbang 'Persetujuan'](workflows-approval-example.md)
+ [Menambahkan gerbang 'Persetujuan'](workflows-approval-add.md)
+ [Mengkonfigurasi pemberitahuan persetujuan](workflows-approval-notify.md)
+ [Menyetujui atau menolak alur kerja](workflows-approval-approve.md)
+ [Gerbang 'Persetujuan' YAMAL](approval-ref.md)
## Bagaimana cara membuka gerbang persetujuan?
Untuk membuka gerbang **Persetujuan**, *semua* ketentuan berikut harus dipenuhi:
+ **Kondisi 1**: Jumlah persetujuan yang diperlukan harus diserahkan. Jumlah persetujuan yang diperlukan dapat dikonfigurasi, dan setiap pengguna diizinkan untuk mengirimkan satu persetujuan.
+ **Kondisi 2**: Semua persetujuan harus diserahkan sebelum waktu gerbang habis. Waktu gerbang habis 14 hari setelah diaktifkan. Periode ini tidak dapat dikonfigurasi.
+ **Kondisi 3**: Tidak ada yang harus menolak alur kerja yang dijalankan. Penolakan tunggal akan menyebabkan alur kerja berjalan gagal.
+ **Kondisi 4**: (Hanya berlaku jika Anda menggunakan mode lari yang digantikan.) Lari tidak boleh digantikan oleh lari nanti. Untuk informasi selengkapnya, lihat [Bagaimana cara kerja persetujuan alur kerja dengan mode lari antrian, digantikan, dan paralel?](#workflows-approval-run-mode).
Jika salah satu kondisi tidak terpenuhi, CodeCatalyst hentikan alur kerja dan atur status run ke **Gagal** (dalam kasus **Kondisi 1** hingga **3**) atau **Digantikan** (dalam kasus **Kondisi** 4).
## Kapan menggunakan gerbang 'Persetujuan'
Biasanya, Anda akan menggunakan gerbang **Persetujuan** dalam alur kerja yang menyebarkan aplikasi dan sumber daya lainnya ke server produksi atau lingkungan di mana standar kualitas harus divalidasi. Dengan menempatkan gerbang sebelum penyebaran ke produksi, Anda memberi pengulas kesempatan untuk memvalidasi revisi perangkat lunak baru Anda sebelum tersedia untuk umum.
## Siapa yang bisa memberikan persetujuan?
Setiap pengguna yang merupakan anggota proyek Anda dan yang memiliki peran **Kontributor** atau **administrator Proyek** dapat memberikan persetujuan. Pengguna dengan peran **administrator Space** yang termasuk dalam ruang proyek Anda juga dapat memberikan persetujuan.
**catatan**
Pengguna dengan peran **Peninjau** tidak dapat memberikan persetujuan.
## Bagaimana cara memberi tahu pengguna bahwa persetujuan diperlukan?
Untuk memberi tahu pengguna bahwa persetujuan diperlukan, Anda harus:
+ CodeCatalyst Kirimi mereka pemberitahuan Slack. Untuk informasi selengkapnya, lihat [Mengkonfigurasi pemberitahuan persetujuan](workflows-approval-notify.md).
+ Buka halaman di CodeCatalyst konsol tempat tombol **Setujui** dan **Tolak** berada, dan tempel URL halaman itu ke aplikasi email atau pesan yang ditujukan kepada pemberi persetujuan. Untuk informasi selengkapnya tentang cara menavigasi ke halaman ini, lihat[Menyetujui atau menolak alur kerja](workflows-approval-approve.md).
## Dapatkah saya menggunakan gerbang 'Persetujuan' untuk mencegah alur kerja berjalan?
Ya, dengan kualifikasi. Untuk informasi selengkapnya, lihat [Bisakah saya menggunakan gerbang untuk mencegah alur kerja berjalan?](workflows-gates.md#workflows-gates-prevent).
## Bagaimana cara kerja persetujuan alur kerja dengan mode lari antrian, digantikan, dan paralel?
[Saat menggunakan mode lari antrian, digantikan, atau paralel, gerbang **Persetujuan** bekerja dengan cara yang mirip dengan tindakan.](workflows-actions.md) Kami menyarankan membaca[Tentang mode lari antrian](workflows-configure-runs.md#workflows-configure-runs-queued),[Tentang mode lari yang digantikan](workflows-configure-runs.md#workflows-configure-runs-superseded), [Tentang mode parallel run](workflows-configure-runs.md#workflows-configure-runs-parallel) bagian untuk membiasakan diri dengan mode run ini. Setelah Anda memiliki pemahaman dasar tentang mereka, kembali ke bagian ini untuk mencari tahu bagaimana mode run ini bekerja ketika gerbang **Persetujuan** hadir.
Ketika gerbang **Persetujuan** hadir, proses diproses sebagai berikut:
+ Jika Anda menggunakan [mode lari antrian, run akan mengantri](workflows-configure-runs.md#workflows-configure-runs-queued) di belakang run yang saat ini menunggu persetujuan di gerbang. Ketika gerbang itu menjadi tidak terkunci (yaitu, semua persetujuan telah diberikan), proses berikutnya dalam antrian maju ke gerbang, dan menunggu persetujuan. Proses ini berlanjut dengan proses antrian yang diproses melalui gerbang. one-by-one [Figure 1](#figure-1-workflow-queued-run-mode-ma)menggambarkan proses ini.
+ Jika Anda menggunakan [mode run yang digantikan](workflows-configure-runs.md#workflows-configure-runs-superseded), perilakunya sama dengan mode lari antrian, kecuali bahwa alih-alih menjalankan menumpuk dalam antrian di gerbang, proses yang lebih baru menggantikan (mengambil alih dari) proses sebelumnya. Tidak ada antrian, dan lari apa pun yang saat ini menunggu di gerbang untuk persetujuan akan dibatalkan dan digantikan oleh proses yang lebih baru. [Figure 2](#figure-2-workflow-superseded-run-mode-ma)menggambarkan proses ini.
+ Jika Anda menggunakan [mode parallel run, run](workflows-configure-runs.md#workflows-configure-runs-parallel) start secara paralel dan tidak ada bentuk antrian. Setiap proses diproses oleh gerbang segera karena tidak ada jalan di depannya. [Figure 3](#figure-3-workflow-parallel-run-mode-ma)menggambarkan proses ini.
**Gambar 1****: 'Mode lari antrian' dan gerbang Persetujuan**
![\[Cara kerja gerbang 'Persetujuan' dengan 'mode lari antrian'\]](http://docs.aws.amazon.com/id_id/codecatalyst/latest/userguide/images/flows/runmode-queued-ma.png)
**Gambar 2****: 'Mode lari yang digantikan' dan gerbang Persetujuan**
![\[Cara kerja gerbang 'Persetujuan' dengan 'mode run yang digantikan'\]](http://docs.aws.amazon.com/id_id/codecatalyst/latest/userguide/images/flows/runmode-superseded-ma.png)
**Gambar 3****: 'Mode lari paralel' dan gerbang Persetujuan**
![\[Cara kerja gerbang 'Persetujuan' dengan 'mode lari paralel'\]](http://docs.aws.amazon.com/id_id/codecatalyst/latest/userguide/images/flows/runmode-parallel-ma.png)
# Contoh: Gerbang 'Persetujuan'
Contoh berikut menunjukkan cara menambahkan gerbang **Persetujuan** yang disebut `Approval_01` antara dua tindakan yang disebut`Staging`, dan`Production`. `Staging`Aksi berjalan pertama, `Approval_01` gerbang kedua, dan `Production` aksi terakhir. `Production`Tindakan hanya berjalan jika `Approval_01` gerbang tidak terkunci. `DependsOn`Properti memastikan bahwa`Staging`,`Approval_01`, dan `Production` fase berjalan dalam urutan berurutan.
Untuk informasi selengkapnya tentang gerbang **Persetujuan**, lihat[Memerlukan persetujuan pada alur kerja berjalan](workflows-approval.md).
```
Actions:
Staging: # Deploy to a staging server
Identifier: aws/ecs-deploy@v1
Configuration:
...
Approval_01:
Identifier: aws/approval@v1
DependsOn:
- Staging
Configuration:
ApprovalsRequired: 2
Production: # Deploy to a production server
Identifier: aws/ecs-deploy@v1
DependsOn:
- Approval_01
Configuration:
...
```
# Menambahkan gerbang 'Persetujuan'
Untuk mengonfigurasi alur kerja agar memerlukan persetujuan, Anda harus menambahkan gerbang **Persetujuan** ke alur kerja. Gunakan petunjuk berikut untuk menambahkan gerbang **Persetujuan** ke alur kerja Anda.
Untuk informasi lebih lanjut tentang gerbang ini, lihat[Memerlukan persetujuan pada alur kerja berjalan](workflows-approval.md).
------
#### [ Visual ]
**Untuk menambahkan gerbang 'Persetujuan' ke alur kerja (editor visual)**
1. Buka CodeCatalyst konsol di [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Pilih proyek Anda.
1. **Di panel navigasi, pilih **CI/CD, lalu pilih Alur** kerja.**
1. Pilih nama alur kerja Anda. Anda dapat memfilter berdasarkan repositori sumber atau nama cabang tempat alur kerja ditentukan, atau memfilter berdasarkan nama atau status alur kerja.
1. Pilih **Edit**.
1. Di kiri atas, pilih **Gates**.
1. Di katalog **Gates**, di **Approval**, pilih tanda plus (**\$1**).
1. Pilih **Input**, dan di bidang **Tergantung pada**, lakukan hal berikut.
Tentukan tindakan, grup tindakan, atau gerbang yang harus berjalan dengan sukses agar gerbang ini berjalan. Secara default, saat Anda menambahkan gerbang ke alur kerja, gerbang diatur untuk bergantung pada tindakan terakhir dalam alur kerja Anda. Jika Anda menghapus properti ini, gerbang tidak akan tergantung pada apa pun, dan akan berjalan terlebih dahulu, sebelum tindakan lain.
**catatan**
Gerbang harus dikonfigurasi untuk dijalankan sebelum atau sesudah tindakan, grup tindakan, atau gerbang. Itu tidak dapat diatur untuk berjalan secara paralel dengan tindakan lain, kelompok tindakan, dan gerbang.
Untuk informasi selengkapnya tentang **Tergantung pada** fungsionalitas, lihat[Gerbang dan tindakan sekuensing](workflows-gates-depends-on.md).
1. Pilih tab **Konfigurasi**.
1. Di bidang **nama Gerbang**, lakukan hal berikut.
Tentukan nama yang ingin Anda berikan gerbang. Semua nama gerbang harus unik dalam alur kerja. Nama gerbang terbatas pada karakter alfanumerik (a-z, A-Z, 0-9), tanda hubung (-), dan garis bawah (\$1). Spasi tidak diizinkan. Anda tidak dapat menggunakan tanda kutip untuk mengaktifkan karakter dan spasi khusus dalam nama gerbang.
1. (Opsional) Di bidang **Jumlah persetujuan**, lakukan hal berikut.
Tentukan jumlah minimum persetujuan yang diperlukan untuk membuka gerbang **Persetujuan**. Minimal adalah`1`. Maksimal adalah`2`. Jika dihilangkan, default-nya adalah `1`.
**catatan**
Jika Anda ingin menghilangkan `ApprovalsRequired` properti, hapus `Configuration` bagian gerbang dari file definisi alur kerja.
1. (Opsional) Pilih **Validasi** untuk memvalidasi kode YAMAL alur kerja sebelum melakukan.
1. Pilih **Komit**, masukkan pesan komit, dan pilih **Komit** lagi.
------
#### [ YAML ]
**Untuk menambahkan gerbang 'Persetujuan' ke alur kerja (editor YAMG)**
1. Buka CodeCatalyst konsol di [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Pilih proyek Anda.
1. **Di panel navigasi, pilih **CI/CD, lalu pilih Alur** kerja.**
1. Pilih nama alur kerja Anda. Anda dapat memfilter berdasarkan repositori sumber atau nama cabang tempat alur kerja ditentukan, atau memfilter berdasarkan nama atau status alur kerja.
1. Pilih **Edit**.
1. Pilih **YAMAL.**
1. Tambahkan `Approval` bagian dan properti yang mendasari menggunakan contoh berikut sebagai panduan. Untuk informasi lebih lanjut, lihat [Gerbang 'Persetujuan' YAMAL](approval-ref.md) di[Alur kerja definisi YAMAL](workflow-reference.md).
```
Actions:
MyApproval_01:
Identifier: aws/approval@v1
DependsOn:
- PreviousAction
Configuration:
ApprovalsRequired: 2
```
Untuk contoh lain, lihat[Contoh: Gerbang 'Persetujuan'](workflows-approval-example.md).
1. (Opsional) Pilih **Validasi** untuk memvalidasi kode YAMAL alur kerja sebelum melakukan.
1. Pilih **Komit**, masukkan pesan komit, dan pilih **Komit** lagi.
------
# Mengkonfigurasi pemberitahuan persetujuan
Anda dapat CodeCatalyst mengirim pemberitahuan ke saluran Slack yang memberi tahu pengguna bahwa alur kerja berjalan memerlukan persetujuan. Pengguna melihat notifikasi dan mengklik tautan di dalamnya. Tautan membawa mereka ke halaman CodeCatalyst persetujuan di mana mereka dapat menyetujui atau menolak alur kerja.
Anda juga dapat mengonfigurasi notifikasi untuk memberi tahu pengguna bahwa alur kerja telah disetujui, ditolak, atau bahwa permintaan persetujuan telah kedaluwarsa.
Gunakan petunjuk berikut untuk mengatur notifikasi Slack.
**Sebelum Anda mulai**
Pastikan Anda telah menambahkan gerbang **Persetujuan** ke alur kerja Anda. Untuk informasi selengkapnya, lihat [Menambahkan gerbang 'Persetujuan'](workflows-approval-add.md).
**Untuk mengirim pemberitahuan persetujuan alur kerja ke saluran Slack**
1. Konfigurasikan CodeCatalyst dengan Slack. Untuk informasi selengkapnya, lihat [Memulai dengan notifikasi Slack](getting-started-notifications.md).
1. Dalam CodeCatalyst proyek yang berisi alur kerja yang memerlukan persetujuan, aktifkan notifikasi, jika belum diaktifkan. Untuk mengaktifkan notifikasi:
1. Arahkan ke proyek Anda dan di panel navigasi, pilih **Pengaturan proyek**.
1. Di bagian atas, pilih **Notifikasi**.
1. Di **acara Pemberitahuan**, pilih **Edit notifikasi**.
1. Aktifkan **persetujuan alur kerja tertunda** dan pilih saluran Slack tempat CodeCatalyst akan mengirim notifikasi.
1. (Opsional) Aktifkan notifikasi tambahan untuk memberi tahu orang tentang persetujuan yang disetujui, ditolak, dan kedaluwarsa. **Anda dapat mengaktifkan **Workflow run approved**, **Workflow run ditolak**, **Persetujuan alur kerja digantikan, dan persetujuan** alur kerja habis.** Di sebelah setiap notifikasi, pilih saluran Slack tempat CodeCatalyst akan mengirim notifikasi.
1. Pilih **Simpan**.
# Menyetujui atau menolak alur kerja
Alur kerja yang menyertakan gerbang **Persetujuan** harus disetujui atau ditolak. Pengguna dapat memberikan persetujuan atau penolakan mereka mulai dari:
+ CodeCatalyst konsol
+ tautan yang disediakan oleh anggota tim
+ pemberitahuan Slack otomatis
Setelah pengguna memberikan persetujuan atau penolakan mereka, keputusan ini tidak dapat dibatalkan.
**catatan**
Hanya pengguna tertentu yang dapat menyetujui atau menolak alur kerja yang dijalankan. Untuk informasi selengkapnya, lihat [Siapa yang bisa memberikan persetujuan?](workflows-approval.md#workflows-approval-who).
**Sebelum kamu memulai**
Pastikan Anda telah menambahkan gerbang **Persetujuan** ke alur kerja Anda. Untuk informasi selengkapnya, lihat [Menambahkan gerbang 'Persetujuan'](workflows-approval-add.md).
**Untuk menyetujui atau menolak alur kerja yang dijalankan mulai dari konsol CodeCatalyst**
1. Buka CodeCatalyst konsol di [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Pilih proyek Anda.
1. **Di panel navigasi, pilih **CI/CD, lalu pilih Alur** kerja.**
1. Pilih nama alur kerja Anda. Anda dapat memfilter berdasarkan repositori sumber atau nama cabang tempat alur kerja ditentukan, atau memfilter berdasarkan nama atau status alur kerja.
1. Dalam diagram alur kerja, pilih kotak yang mewakili gerbang **Persetujuan**.
Panel samping muncul.
**catatan**
Pada titik ini, Anda dapat mengirim URL halaman ini ke pemberi persetujuan lain jika Anda mau.
1. Di bawah **keputusan Tinjau**, pilih **Menyetujui** atau **Tolak**.
1. (Opsional) Di **Komentar - opsional**, masukkan komentar yang menunjukkan mengapa Anda menyetujui atau menolak alur kerja berjalan.
1. Pilih **Kirim**.
**Untuk menyetujui atau menolak alur kerja yang dimulai dari tautan yang disediakan oleh anggota tim**
1. Pilih tautan yang dikirimkan kepada Anda oleh anggota tim Anda. (Anda dapat meminta anggota tim Anda membaca prosedur sebelumnya untuk mendapatkan tautan.)
1. Masuk ke CodeCatalyst, jika ditanya.
Anda diarahkan ke halaman persetujuan jalankan alur kerja.
1. Di bawah **keputusan Tinjau**, pilih **Menyetujui** atau **Tolak**.
1. (Opsional) Di **Komentar - opsional**, masukkan komentar yang menunjukkan mengapa Anda menyetujui atau menolak alur kerja berjalan.
1. Pilih **Kirim**.
**Untuk menyetujui atau menolak alur kerja yang dimulai dari pemberitahuan Slack otomatis**
1. Pastikan notifikasi Slack sudah diatur. Lihat [Mengkonfigurasi pemberitahuan persetujuan](workflows-approval-notify.md).
1. Di Slack, di saluran tempat pemberitahuan persetujuan dikirim, pilih tautan dalam pemberitahuan persetujuan.
1. Masuk ke CodeCatalyst, jika ditanya.
Anda diarahkan ke halaman jalankan alur kerja.
1. Dalam diagram alur kerja, pilih gerbang persetujuan.
1. Di bawah **keputusan Tinjau**, pilih **Menyetujui** atau **Tolak**.
1. (Opsional) Di **Komentar - opsional**, masukkan komentar yang menunjukkan mengapa Anda menyetujui atau menolak alur kerja berjalan.
1. Pilih **Kirim**.
# Gerbang 'Persetujuan' YAMAL
Berikut ini adalah definisi YAMAL dari gerbang **Persetujuan**. Untuk mempelajari cara menggunakan gerbang ini, lihat[Memerlukan persetujuan pada alur kerja berjalan](workflows-approval.md).
Definisi tindakan ini ada sebagai bagian dalam file definisi alur kerja yang lebih luas. Untuk informasi selengkapnya tentang file ini, lihat[Alur kerja definisi YAMAL](workflow-reference.md).
**catatan**
Sebagian besar properti YAMAL yang mengikuti memiliki elemen UI yang sesuai di editor visual. Untuk mencari elemen UI, gunakan **Ctrl\$1F**. Elemen akan terdaftar dengan properti YAMLnya yang terkait.
```
# The workflow definition starts here.
# See Properti tingkat atas for details.
Name: MyWorkflow
SchemaVersion: 1.0
Actions:
# The 'Approval' gate definition starts here.
Approval:
Identifier: aws/approval@v1
DependsOn:
- another-action
Configuration:
ApprovalsRequired: number
```
## Approval
(Diperlukan)
Tentukan nama yang ingin Anda berikan gerbang. Semua nama gerbang harus unik dalam alur kerja. Nama gerbang terbatas pada karakter alfanumerik (a-z, A-Z, 0-9), tanda hubung (-), dan garis bawah (\$1). Spasi tidak diizinkan. Anda tidak dapat menggunakan tanda kutip untuk mengaktifkan karakter dan spasi khusus dalam nama gerbang.
Default: `Approval_nn`.
UI yang sesuai: Tab konfigurasi/nama **Gerbang**
## Identifier
(*Approval*/**Identifier**)
(Diperlukan)
Mengidentifikasi gerbang. Gerbang **Persetujuan** mendukung versi`1.0.0`. Jangan mengubah properti ini kecuali Anda ingin mempersingkat versinya. Untuk informasi selengkapnya, lihat [Menentukan versi tindakan yang akan digunakan](workflows-action-versions.md).
Default: `aws/approval@v1`.
**UI yang sesuai: Diagram alur Approval kerja/\$1nn/ aws/persetujuan @v1 label**
## DependsOn
(*Approval*/**DependsOn**)
(Opsional)
Tentukan tindakan, grup tindakan, atau gerbang yang harus berjalan dengan sukses agar gerbang ini berjalan. Secara default, saat Anda menambahkan gerbang ke alur kerja, gerbang diatur untuk bergantung pada tindakan terakhir dalam alur kerja Anda. Jika Anda menghapus properti ini, gerbang tidak akan tergantung pada apa pun, dan akan berjalan terlebih dahulu, sebelum tindakan lain.
**catatan**
Gerbang harus dikonfigurasi untuk dijalankan sebelum atau sesudah tindakan, grup tindakan, atau gerbang. Itu tidak dapat diatur untuk berjalan secara paralel dengan tindakan lain, kelompok tindakan, dan gerbang.
Untuk informasi selengkapnya tentang **Tergantung pada** fungsionalitas, lihat[Gerbang dan tindakan sekuensing](workflows-gates-depends-on.md).
**UI yang sesuai: Tab masukan/Tergantung pada**
## Configuration
(*Approval*/**Configuration**)
(Opsional)
Bagian di mana Anda dapat menentukan properti konfigurasi gerbang.
UI yang sesuai: Tab **konfigurasi**
## ApprovalsRequired
(*Approval*/Configuration/**ApprovalsRequired**)
(Opsional)
Tentukan jumlah minimum persetujuan yang diperlukan untuk membuka gerbang **Persetujuan**. Minimal adalah`1`. Maksimal adalah`2`. Jika dihilangkan, default-nya adalah `1`.
**catatan**
Jika Anda ingin menghilangkan `ApprovalsRequired` properti, hapus `Configuration` bagian gerbang dari file definisi alur kerja.
UI yang sesuai: Tab **konfigurasi/Jumlah persetujuan**