Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Bekerja dengan penerapan di CodeDeploy
Dalam CodeDeploy, penyebaran adalah proses, dan komponen yang terlibat dalam proses, menginstal konten pada satu atau lebih contoh. Konten ini dapat terdiri dari kode, web dan file konfigurasi, executable, paket, skrip, dan sebagainya. CodeDeploy menyebarkan konten yang disimpan dalam repositori sumber, sesuai dengan aturan konfigurasi yang Anda tentukan.
Jika Anda menggunakan platform komputasi EC2/Lokal, maka dua penerapan ke kumpulan instans yang sama dapat berjalan secara bersamaan.
CodeDeploy menyediakan dua opsi jenis penerapan, penerapan di tempat dan penerapan biru/hijau.
+ **Penyebaran di tempat**: Aplikasi pada setiap instance dalam grup penyebaran dihentikan, revisi aplikasi terbaru diinstal, dan versi baru aplikasi dimulai dan divalidasi. Anda dapat menggunakan penyeimbang beban sehingga setiap instance dideregistrasi selama penerapannya dan kemudian dikembalikan ke layanan setelah penerapan selesai. Hanya penerapan yang menggunakan platform komputasi EC2/Lokal yang dapat menggunakan penerapan di tempat. Untuk informasi selengkapnya tentang penerapan di tempat, lihat. [Ikhtisar penerapan di tempat](welcome.md#welcome-deployment-overview-in-place)
+ Penerapan **biru/hijau: Perilaku penerapan** Anda bergantung pada platform komputasi yang Anda gunakan:
+ **Blue/green on an EC2/OnPlatform komputasi -Premises**: Instance dalam grup penerapan (lingkungan asli) digantikan oleh serangkaian instance yang berbeda (lingkungan pengganti) menggunakan langkah-langkah berikut:
+ Instans disediakan untuk lingkungan pengganti.
+ Revisi aplikasi terbaru diinstal pada instance pengganti.
+ Waktu tunggu opsional terjadi untuk kegiatan seperti pengujian aplikasi dan verifikasi sistem.
+ Instans di lingkungan penggantian terdaftar dengan satu atau lebih penyeimbang beban Elastic Load Balancing, menyebabkan lalu lintas dialihkan ke sana. Contoh di lingkungan asli dideregistrasi dan dapat dihentikan atau terus berjalan untuk penggunaan lain.
**catatan**
Jika Anda menggunakan platform komputasi EC2/Lokal, ketahuilah bahwa blue/green penerapan hanya berfungsi dengan instans Amazon EC2.
+ **Biru/hijau pada platform komputasi AWS Lambda Amazon ECS** **atau Amazon: Lalu lintas digeser secara bertahap sesuai dengan konfigurasi **kenari**, linier, atau penerapan. **all-at-once****
+ **Penerapan biru/hijau melalui CloudFormation**: Lalu lintas dialihkan dari sumber daya Anda saat ini ke sumber daya yang diperbarui sebagai bagian dari pembaruan tumpukan. CloudFormation Saat ini, hanya blue/green penerapan ECS yang didukung.
Untuk informasi selengkapnya tentang blue/green penerapan, lihat. [Ikhtisar blue/green penerapan](welcome.md#welcome-deployment-overview-blue-green)
Untuk informasi tentang penerapan otomatis dari Amazon S3, [lihat Menerapkan secara otomatis dari Amazon S3 menggunakan](https://aws.amazon.com/blogs/devops/automatically-deploy-from-amazon-s3-using-aws-codedeploy/). CodeDeploy
**Topics**
+ [Buat deployment](deployments-create.md)
+ [Lihat detail penerapan](deployments-view-details.md)
+ [Lihat data log penyebaran](deployments-view-logs.md)
+ [Hentikan penerapan](deployments-stop.md)
+ [Menerapkan ulang dan memutar kembali penerapan](deployments-rollback-and-redeploy.md)
+ [Menyebarkan aplikasi di akun yang berbeda AWS](deployments-cross-account.md)
+ [Validasi paket penerapan pada mesin lokal](deployments-local.md)
# Buat penerapan dengan CodeDeploy
Anda dapat menggunakan CodeDeploy konsol, API AWS CLI, atau CodeDeploy API untuk membuat penerapan yang menginstal revisi aplikasi yang telah Anda dorong ke Amazon S3 atau, jika penerapan Anda ke platform komputasi EC2/On-premise, pada instans dalam grup penerapan. GitHub
Proses untuk membuat penerapan tergantung pada platform komputasi yang digunakan oleh penerapan Anda.
**Topics**
+ [Prasyarat penyebaran](deployments-create-prerequisites.md)
+ [Membuat penerapan Platform Komputasi Amazon ECS (konsol)](deployments-create-console-ecs.md)
+ [Membuat penerapan AWS Lambda Compute Platform (konsol)](deployments-create-console-lambda.md)
+ [Membuat penerapan Platform Komputasi EC2/Lokal (konsol)](deployments-create-console.md)
+ [Membuat penerapan Platform Komputasi Amazon ECS (CLI)](deployments-create-ecs-cli.md)
+ [Membuat penerapan AWS Lambda Compute Platform (CLI)](deployments-create-lambda-cli.md)
+ [Membuat penerapan Platform Komputasi EC2/Lokal (CLI)](deployments-create-cli.md)
+ [Buat blue/green penyebaran Amazon ECS melalui CloudFormation](deployments-create-ecs-cfn.md)
# Prasyarat penyebaran
Pastikan langkah-langkah berikut selesai sebelum Anda memulai penerapan.
## Prasyarat penerapan pada platform komputasi AWS Lambda
+ Buat aplikasi yang mencakup setidaknya satu grup penyebaran. Untuk informasi selengkapnya, lihat [Buat aplikasi dengan CodeDeploy](applications-create.md) dan [Buat grup penerapan dengan CodeDeploy](deployment-groups-create.md).
+ Siapkan revisi aplikasi, juga dikenal sebagai AppSpec file, yang menentukan versi fungsi Lambda yang ingin Anda terapkan. AppSpec File ini juga dapat menentukan fungsi Lambda untuk memvalidasi penerapan Anda. Untuk mengetahui informasi selengkapnya, lihat [Bekerja dengan revisi aplikasi untuk CodeDeploy](application-revisions.md).
+ Jika Anda ingin menggunakan konfigurasi penerapan khusus untuk penerapan Anda, buat sebelum memulai proses penerapan. Untuk informasi, lihat [Buat konfigurasi penerapan dengan CodeDeploy](deployment-configurations-create.md).
## Prasyarat penerapan pada platform komputasi EC2/Lokal
+ Untuk penerapan di tempat, buat atau konfigurasikan instance yang ingin Anda gunakan. Untuk informasi, lihat [Bekerja dengan instance untuk CodeDeploy](instances.md). Untuk blue/green penerapan, Anda memiliki grup Penskalaan Otomatis Amazon EC2 yang sudah ada untuk digunakan sebagai templat untuk lingkungan pengganti, atau Anda memiliki satu atau beberapa instans atau grup Penskalaan Otomatis Amazon EC2 yang Anda tentukan sebagai lingkungan asli. Untuk informasi selengkapnya, lihat [Tutorial: Gunakan CodeDeploy untuk menyebarkan aplikasi ke grup Auto Scaling](tutorials-auto-scaling-group.md) dan [Mengintegrasikan CodeDeploy dengan Amazon EC2 Auto Scaling](integrations-aws-auto-scaling.md).
+ Buat aplikasi yang mencakup setidaknya satu grup penyebaran. Untuk informasi selengkapnya, lihat [Buat aplikasi dengan CodeDeploy](applications-create.md) dan [Buat grup penerapan dengan CodeDeploy](deployment-groups-create.md).
+ Siapkan revisi aplikasi yang ingin Anda terapkan ke instance di grup penyebaran Anda. Untuk informasi, lihat [Bekerja dengan revisi aplikasi untuk CodeDeploy](application-revisions.md).
+ Jika Anda ingin menggunakan konfigurasi penerapan khusus untuk penerapan Anda, buat sebelum memulai proses penerapan. Untuk informasi, lihat [Buat konfigurasi penerapan dengan CodeDeploy](deployment-configurations-create.md).
+ Jika Anda menerapkan revisi aplikasi dari bucket Amazon S3, bucket berada di Wilayah yang AWS sama dengan instance di grup penerapan Anda.
+ Jika Anda menerapkan revisi aplikasi dari bucket Amazon S3, kebijakan bucket Amazon S3 telah diterapkan ke bucket. Kebijakan ini memberi instans Anda izin yang diperlukan untuk mengunduh revisi aplikasi.
Misalnya, kebijakan bucket Amazon S3 berikut memungkinkan instans Amazon EC2 dengan profil instans IAM terlampir yang berisi `arn:aws:iam::444455556666:role/CodeDeployDemo` ARN untuk diunduh dari mana saja di bucket Amazon S3 bernama: `amzn-s3-demo-bucket`
```
{
"Statement": [
{
"Action": [
"s3:Get*",
"s3:List*"
],
"Effect": "Allow",
"Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*",
"Principal": {
"AWS": [
"arn:aws:iam::444455556666:role/CodeDeployDemo"
]
}
}
]
}
```
Kebijakan bucket Amazon S3 berikut memungkinkan instans lokal dengan pengguna IAM terkait yang berisi ARN `arn:aws:iam::444455556666:user/CodeDeployUser` dapat diunduh dari mana saja di bucket Amazon S3 bernama: `amzn-s3-demo-bucket`
```
{
"Statement": [
{
"Action": [
"s3:Get*",
"s3:List*"
],
"Effect": "Allow",
"Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*",
"Principal": {
"AWS": [
"arn:aws:iam::444455556666:user/CodeDeployUser"
]
}
}
]
}
```
Untuk informasi tentang cara membuat dan melampirkan kebijakan bucket Amazon S3, lihat contoh [kebijakan Bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html).
+ Jika Anda membuat blue/green penerapan, atau Anda telah menetapkan Classic Load Balancer opsional, Application Load Balancer, atau Network Load Balancer dalam grup penyebaran untuk penerapan di tempat, Anda telah membuat VPC menggunakan Amazon VPC yang berisi setidaknya dua subnet. (CodeDeploy menggunakan Elastic Load Balancing, yang mengharuskan semua instance dalam grup penyeimbang beban berada dalam satu VPC.)
Jika Anda belum membuat VPC, lihat Panduan Memulai [VPC](https://docs.aws.amazon.com/AmazonVPC/latest/GettingStartedGuide/ExerciseOverview.html) Amazon.
+ Jika Anda membuat blue/green penerapan, Anda telah mengonfigurasi setidaknya satu Classic Load Balancer, Application Load Balancer, atau Network Load Balancer di Elastic Load Balancing dan menggunakannya untuk mendaftarkan instance yang membentuk lingkungan asli Anda.
**catatan**
Instans di lingkungan pengganti Anda akan didaftarkan ke penyeimbang beban nanti.
Untuk informasi selengkapnya tentang mengonfigurasi penyeimbang beban, lihat[Siapkan penyeimbang beban di Elastic Load Balancing untuk penerapan Amazon CodeDeploy EC2](deployment-groups-create-load-balancer.md), dan. [Siapkan penyeimbang beban, grup target, dan pendengar untuk penerapan Amazon CodeDeploy ECS](deployment-groups-create-load-balancer-for-ecs.md)
## Prasyarat penerapan untuk penerapan melalui blue/green CloudFormation
+ Template Anda tidak perlu memodelkan sumber daya untuk CodeDeploy aplikasi atau grup penyebaran.
+ Template Anda harus menyertakan sumber daya untuk VPC menggunakan Amazon VPC yang berisi setidaknya dua subnet.
+ Template Anda harus menyertakan sumber daya untuk satu atau lebih Classic Load Balancer, Application Load Balancer, atau Network Load Balancer di Elastic Load Balancing yang digunakan untuk mengarahkan lalu lintas ke grup target Anda.
# Membuat penerapan Platform Komputasi Amazon ECS (konsol)
Topik ini menunjukkan cara menerapkan layanan Amazon ECS menggunakan konsol. Untuk informasi selengkapnya, lihat [Tutorial: Menyebarkan aplikasi ke Amazon ECS](tutorial-ecs-deployment.md) dan [Tutorial: Menyebarkan layanan Amazon ECS dengan uji validasi](tutorial-ecs-deployment-with-hooks.md).
1. Masuk ke Konsol Manajemen AWS dan buka CodeDeploy konsol di [https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy).
**catatan**
Masuk dengan pengguna yang sama dengan yang Anda atur[Memulai dengan CodeDeploy](getting-started-codedeploy.md).
1. Lakukan salah satu tindakan berikut:
+ **Jika Anda ingin menyebarkan aplikasi, di panel navigasi, perluas **Deploy**, lalu pilih Aplikasi.** Pilih nama aplikasi yang ingin Anda gunakan. Pastikan kolom **Compute platform** untuk aplikasi Anda adalah **Amazon ECS**.
+ **Jika Anda ingin menerapkan ulang penerapan, di panel navigasi, perluas **Deploy, lalu pilih Deployment**.** Pilih penyebaran yang ingin Anda gunakan kembali, dan di kolom **Aplikasi**, pilih nama aplikasinya. Pastikan kolom **Compute platform** untuk penerapan Anda adalah **Amazon** ECS.
1. Pada tab **Deployment**, pilih **Create** deployment.
**catatan**
Aplikasi Anda harus memiliki grup penyebaran sebelum dapat digunakan. Jika aplikasi Anda tidak memiliki grup penyebaran, pada tab Grup **Deployment, pilih Buat grup** **penyebaran**. Untuk informasi selengkapnya, lihat [Buat grup penerapan dengan CodeDeploy](deployment-groups-create.md).
1. Di **grup Deployment**, pilih grup penyebaran yang akan digunakan untuk penerapan ini.
1. Di samping **lokasi revisi**, pilih lokasi revisi Anda:
+ **Aplikasi saya disimpan di Amazon S3** — Untuk informasi, lihat[Menentukan informasi tentang revisi yang disimpan dalam bucket Amazon S3](deployments-create-console-s3.md), dan kemudian kembali ke langkah 6.
+ **Gunakan AppSpec editor** - Pilih JSON atau YAMAL, lalu masukkan AppSpec file Anda ke editor. Anda dapat menyimpan AppSpec file dengan memilih **Simpan sebagai file teks**. Ketika Anda memilih **Deploy** di akhir langkah-langkah ini, Anda menerima kesalahan jika JSON atau YAMAL Anda tidak valid. Untuk informasi selengkapnya tentang membuat AppSpec file, lihat[Tambahkan file spesifikasi aplikasi ke revisi untuk CodeDeploy](application-revisions-appspec-file.md).
1. (Opsional) Dalam **deskripsi Deployment**, masukkan deskripsi untuk penerapan ini.
1. (Opsional) Dalam **penggantian konfigurasi Rollback**, Anda dapat menentukan opsi rollback otomatis yang berbeda untuk penerapan ini daripada yang ditentukan untuk grup penerapan, jika ada.
Untuk informasi tentang rollback di CodeDeploy, lihat [Penerapan ulang dan rollback penerapan](deployment-steps-lambda.md#deployment-rollback-lambda) dan. [Menerapkan ulang dan memutar kembali penerapan dengan CodeDeploy](deployments-rollback-and-redeploy.md)
Pilih dari yang berikut ini:
+ **Kembalikan saat penerapan gagal** — CodeDeploy menyebarkan kembali revisi bagus terakhir yang diketahui sebagai penerapan baru.
+ **Putar kembali saat ambang alarm terpenuhi** - Jika alarm ditambahkan ke grup penerapan, pindahkan CodeDeploy revisi terakhir yang diketahui saat satu atau lebih alarm yang ditentukan diaktifkan.
+ **Nonaktifkan rollback** — Jangan lakukan rollback untuk penerapan ini.
1. Pilih **Buat penerapan**.
Untuk melacak status penerapan Anda, lihat[Lihat CodeDeploy detail penerapan](deployments-view-details.md).
# Membuat penerapan AWS Lambda Compute Platform (konsol)
Topik ini menunjukkan cara menerapkan fungsi Lambda menggunakan konsol.
1. Masuk ke Konsol Manajemen AWS dan buka CodeDeploy konsol di [https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy).
**catatan**
Masuk dengan pengguna yang sama dengan yang Anda atur[Memulai dengan CodeDeploy](getting-started-codedeploy.md).
1. Lakukan salah satu tindakan berikut:
+ **Jika Anda ingin menyebarkan aplikasi, di panel navigasi, perluas **Deploy**, lalu pilih Aplikasi.** Pilih nama aplikasi yang ingin Anda gunakan. Pastikan kolom **Compute platform** untuk aplikasi Anda adalah **AWS Lambda**.
+ **Jika Anda ingin menerapkan ulang penerapan, di panel navigasi, perluas **Deploy, lalu pilih Deployment**.** Pilih penyebaran yang ingin Anda gunakan kembali, dan di kolom **Aplikasi**, pilih nama aplikasinya. **Pastikan kolom **Compute platform** untuk penerapan Anda adalah Lambda AWS .**
1. Pada tab **Deployment**, pilih **Create** deployment.
**catatan**
Aplikasi Anda harus memiliki grup penyebaran sebelum dapat digunakan. Jika aplikasi Anda tidak memiliki grup penyebaran, pada tab Grup **Deployment, pilih Buat grup** **penyebaran**. Untuk informasi selengkapnya, lihat [Buat grup penerapan dengan CodeDeploy](deployment-groups-create.md).
1. Di **grup Deployment**, pilih grup penyebaran yang akan digunakan untuk penerapan ini.
1. Di samping **lokasi revisi**, pilih lokasi revisi Anda:
+ **Aplikasi saya disimpan di Amazon S3** — Untuk informasi, lihat[Menentukan informasi tentang revisi yang disimpan dalam bucket Amazon S3](deployments-create-console-s3.md), dan kemudian kembali ke langkah 6.
+ **Gunakan AppSpec editor** - Pilih JSON atau YAMAL, lalu masukkan AppSpec file Anda ke editor. Anda dapat menyimpan AppSpec file dengan memilih **Simpan sebagai file teks**. Ketika Anda memilih **Deploy** di akhir langkah-langkah ini, Anda menerima kesalahan jika JSON atau YAMAL Anda tidak valid. Untuk informasi selengkapnya tentang membuat AppSpec file, lihat[Tambahkan file spesifikasi aplikasi ke revisi untuk CodeDeploy](application-revisions-appspec-file.md).
1. (Opsional) Dalam **deskripsi Deployment**, masukkan deskripsi untuk penerapan ini.
1. (Opsional) Perluas **penggantian grup Deployment** untuk memilih konfigurasi penerapan untuk mengontrol bagaimana lalu lintas dialihkan ke versi fungsi Lambda yang berbeda dari yang ditentukan dalam grup penerapan.
Untuk informasi selengkapnya, lihat [Konfigurasi penerapan pada platform komputasi AWS Lambda](deployment-configurations.md#deployment-configuration-lambda).
1. (Opsional) Dalam **penggantian konfigurasi Rollback**, Anda dapat menentukan opsi rollback otomatis yang berbeda untuk penerapan ini daripada yang ditentukan untuk grup penerapan, jika ada.
Untuk informasi tentang rollback di CodeDeploy, lihat [Penerapan ulang dan rollback penerapan](deployment-steps-lambda.md#deployment-rollback-lambda) dan. [Menerapkan ulang dan memutar kembali penerapan dengan CodeDeploy](deployments-rollback-and-redeploy.md)
Pilih dari yang berikut ini:
+ **Kembalikan saat penerapan gagal** — CodeDeploy menyebarkan kembali revisi bagus terakhir yang diketahui sebagai penerapan baru.
+ **Putar kembali saat ambang alarm terpenuhi** - Jika alarm ditambahkan ke grup penerapan, pindahkan CodeDeploy revisi terakhir yang diketahui saat satu atau lebih alarm yang ditentukan diaktifkan.
+ **Nonaktifkan rollback** — Jangan lakukan rollback untuk penerapan ini.
1. Pilih **Buat penerapan**.
Untuk melacak status penerapan Anda, lihat[Lihat CodeDeploy detail penerapan](deployments-view-details.md).
# Membuat penerapan Platform Komputasi EC2/Lokal (konsol)
Topik ini menunjukkan cara menerapkan aplikasi ke Amazon EC2 atau server lokal menggunakan konsol.
1. Masuk ke Konsol Manajemen AWS dan buka CodeDeploy konsol di [https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy).
**catatan**
Masuk dengan pengguna yang sama dengan yang Anda atur[Memulai dengan CodeDeploy](getting-started-codedeploy.md).
1. Lakukan salah satu tindakan berikut:
+ **Jika Anda ingin menyebarkan aplikasi, di panel navigasi, perluas **Deploy**, lalu pilih Aplikasi.** Pilih nama aplikasi yang ingin Anda gunakan. Pastikan kolom **Compute platform** untuk aplikasi Anda adalah **EC2/On-premise**.
+ **Jika Anda ingin menerapkan ulang penerapan, di panel navigasi, perluas **Deploy, lalu pilih Deployment**.** **Temukan penyebaran yang ingin Anda gunakan kembali, lalu pilih nama aplikasinya di kolom Aplikasi.** **Pastikan kolom **Compute platform** untuk penerapan Anda adalah EC2/On-premise.**
1. Pada tab **Deployment**, pilih **Create** deployment.
**catatan**
Aplikasi Anda harus memiliki grup penyebaran sebelum dapat digunakan. Jika aplikasi Anda tidak memiliki grup penyebaran, pada tab Grup **Deployment, pilih Buat grup** **penyebaran**. Untuk informasi selengkapnya, lihat [Buat grup penerapan dengan CodeDeploy](deployment-groups-create.md).
1. Di **grup Deployment**, pilih grup penyebaran yang akan digunakan untuk penerapan ini.
1. Di samping jenis **Repositori, pilih jenis** repositori yang disimpan dalam revisi Anda:
+ **Aplikasi saya disimpan di Amazon S3** — Untuk informasi, lihat[Menentukan informasi tentang revisi yang disimpan dalam bucket Amazon S3](deployments-create-console-s3.md), dan kemudian kembali ke langkah 6.
+ **Aplikasi saya disimpan di GitHub** — Untuk informasi, lihat[Tentukan informasi tentang revisi yang disimpan dalam repositori GitHub](deployments-create-console-github.md), dan kemudian kembali ke langkah 6.
1. (Opsional) Dalam **deskripsi Deployment**, masukkan deskripsi untuk penerapan ini.
1. (Opsional) Perluas **konfigurasi penerapan Override** untuk memilih konfigurasi penerapan guna mengontrol cara lalu lintas dialihkan ke Amazon EC2 atau server lokal yang berbeda dari yang ditentukan dalam grup penerapan.
Untuk informasi selengkapnya, lihat [Bekerja dengan konfigurasi penerapan di CodeDeploy](deployment-configurations.md).
1.
1. Pilih **Jangan gagal penerapan jika peristiwa ApplicationStop siklus hidup gagal** jika Anda ingin penerapan ke instance berhasil jika peristiwa siklus hidup gagal. `ApplicationStop`
1. Perluas **Setelan perilaku penerapan tambahan** untuk menentukan cara CodeDeploy menangani file di lokasi target penerapan yang bukan bagian dari penerapan yang berhasil sebelumnya.
Pilih dari yang berikut ini:
+ **Gagal penerapan** - Kesalahan dilaporkan dan status penerapan diubah menjadi. `Failed`
+ **Timpa konten** — Jika file dengan nama yang sama ada di lokasi target, versi dari revisi aplikasi menggantikannya.
+ **Pertahankan konten** — Jika file dengan nama yang sama ada di lokasi target, file disimpan dan versi dalam revisi aplikasi tidak disalin ke instance.
Untuk informasi selengkapnya, lihat [Perilaku rollback dengan konten yang ada](deployments-rollback-and-redeploy.md#deployments-rollback-and-redeploy-content-options).
1. (Opsional) Dalam **penggantian konfigurasi Rollback**, Anda dapat menentukan opsi rollback otomatis yang berbeda untuk penerapan ini daripada yang ditentukan untuk grup penerapan, jika ada.
Untuk informasi tentang rollback di CodeDeploy, lihat [Penerapan ulang dan rollback penerapan](deployment-steps-server.md#deployment-rollback) dan. [Menerapkan ulang dan memutar kembali penerapan dengan CodeDeploy](deployments-rollback-and-redeploy.md)
Pilih dari yang berikut ini:
+ **Kembalikan saat penerapan gagal** — CodeDeploy menyebarkan kembali revisi bagus terakhir yang diketahui sebagai penerapan baru.
+ **Putar kembali saat ambang alarm terpenuhi** - Jika alarm ditambahkan ke grup CodeDeploy penyebaran, gunakan revisi terakhir yang diketahui saat satu atau lebih alarm yang ditentukan diaktifkan.
+ **Nonaktifkan rollback** — Jangan lakukan rollback untuk penerapan ini.
1. Pilih **Mulai penerapan**.
Untuk melacak status penerapan Anda, lihat[Lihat CodeDeploy detail penerapan](deployments-view-details.md).
**Topics**
+ [Menentukan informasi tentang revisi yang disimpan dalam bucket Amazon S3](deployments-create-console-s3.md)
+ [Tentukan informasi tentang revisi yang disimpan dalam repositori GitHub](deployments-create-console-github.md)
# Menentukan informasi tentang revisi yang disimpan dalam bucket Amazon S3
Jika Anda mengikuti langkah-langkahnya[Membuat penerapan Platform Komputasi EC2/Lokal (konsol)](deployments-create-console.md), ikuti langkah-langkah berikut untuk menambahkan detail tentang revisi aplikasi yang disimpan dalam bucket Amazon S3.
1. Salin tautan Amazon S3 revisi Anda **ke** lokasi Revisi. Untuk menemukan nilai tautan:
1. Di tab browser terpisah:
Masuk ke Konsol Manajemen AWS dan buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
Jelajahi dan pilih revisi Anda.
1. Jika panel **Properties** tidak terlihat, pilih tombol **Properties**.
1. Di panel **Properti**, salin nilai bidang **Tautan** ke kotak **Lokasi revisi** di CodeDeploy konsol.
Untuk menentukan ETag (checksum file) sebagai bagian dari lokasi revisi:
+ Jika nilai bidang **Tautan** berakhir**?versionId=*versionId***, tambahkan **&etag=** dan ETag ke akhir nilai bidang **Tautan**.
+ Jika nilai bidang **Tautan** tidak menentukan ID versi, tambahkan **?etag=** dan ETag ke akhir nilai bidang **Tautan**.
**catatan**
Meskipun tidak semudah menyalin nilai bidang **Tautan**, Anda juga dapat mengetikkan lokasi revisi dalam salah satu format berikut:
**s3://*bucket-name*/*folders*/*objectName***
**s3://*bucket-name*/*folders*/*objectName*?versionId=*versionId***
**s3://*bucket-name*/*folders*/*objectName*?etag=*etag***
**s3://*bucket-name*/*folders*/*objectName*?versionId=*versionId*&etag=*etag***
***bucket-name*.s3.amazonaws.com/*folders*/*objectName***
1. Jika pesan muncul di daftar **Jenis file** yang mengatakan jenis file tidak dapat dideteksi, pilih jenis file revisi. Jika tidak, terima jenis file yang terdeteksi.
# Tentukan informasi tentang revisi yang disimpan dalam repositori GitHub
Jika Anda mengikuti langkah-langkahnya[Membuat penerapan Platform Komputasi EC2/Lokal (konsol)](deployments-create-console.md), ikuti langkah-langkah ini untuk menambahkan detail tentang revisi aplikasi yang disimpan dalam repositori GitHub .
1. Di **Connect to GitHub**, lakukan salah satu hal berikut:
+ Untuk membuat koneksi untuk CodeDeploy aplikasi ke GitHub akun, di tab browser web yang berbeda, keluar dari GitHub. Di **GitHub akun**, masukkan nama untuk mengidentifikasi koneksi ini, lalu pilih **Connect to GitHub**. Halaman web meminta Anda untuk mengizinkan CodeDeploy untuk berinteraksi dengan GitHub aplikasi Anda. Lanjutkan ke langkah 2.
+ Untuk menggunakan koneksi yang telah Anda buat, di **GitHubakun**, pilih namanya, lalu pilih **Connect to GitHub**. Lanjutkan ke langkah 4.
+ Untuk membuat koneksi ke GitHub akun lain, di tab browser web yang berbeda, keluar dari GitHub. Pilih **Connect to a different GitHub account**, lalu pilih **Connect to GitHub**. Lanjutkan ke langkah 2.
1. Jika Anda diminta untuk masuk GitHub, ikuti petunjuk di halaman **Masuk**. Masuk dengan nama GitHub pengguna atau email dan kata sandi Anda.
1. Jika halaman **aplikasi Otorisasi** muncul, pilih **Otorisasi** aplikasi.
1. Pada halaman **Create deployment**, di kotak **Nama repositori**, masukkan nama GitHub pengguna atau organisasi yang berisi revisi, diikuti dengan garis miring (`/`), diikuti dengan nama repositori yang berisi revisi. Jika Anda tidak yakin dengan nilai yang akan diketik:
1. Di tab browser web yang berbeda, buka [GitHubdasbor](https://github.com/dashboard) Anda.
1. Di **repositori Anda**, arahkan kursor mouse Anda ke nama repositori target. Tooltip muncul, menampilkan nama GitHub pengguna atau organisasi, diikuti dengan garis miring (`/`), diikuti dengan nama repositori. Masukkan nilai yang ditampilkan ini ke dalam kotak **nama Repositori**.
**catatan**
Jika nama repositori target tidak terlihat di **repositori Anda**, gunakan GitHub kotak **Pencarian** untuk menemukan nama repositori target dan nama pengguna atau organisasi. GitHub
1. Di **Commit ID**, masukkan ID komit yang mengacu pada revisi di repositori. Jika Anda tidak yakin dengan nilai yang akan diketik:
1. Di tab browser web yang berbeda, buka [GitHubdasbor](https://github.com/dashboard) Anda.
1. Di **repositori Anda**, pilih nama repositori yang berisi komit target.
1. Dalam daftar komit, temukan dan salin ID komit yang mengacu pada revisi di repositori. ID ini biasanya memiliki panjang 40 karakter dan terdiri dari huruf dan angka. (Jangan gunakan versi yang lebih pendek dari ID komit, yang biasanya merupakan 10 karakter pertama dari versi ID komit yang lebih panjang.)
1. Rekatkan ID komit ke dalam kotak **ID Komit**.
# Membuat penerapan Platform Komputasi Amazon ECS (CLI)
Setelah Anda membuat aplikasi dan revisi (dalam penyebaran Amazon ECS, ini adalah filenya): AppSpec
Panggil perintah [create-deployment](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment.html), dengan menentukan:
+ Nama aplikasi. Untuk melihat daftar nama aplikasi, panggil perintah [daftar-aplikasi](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-applications.html).
+ Nama grup penyebaran. Untuk melihat daftar nama grup penyebaran, panggil [list-deployment-groups](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-groups.html)perintah.
+ Informasi tentang revisi yang akan digunakan:
Untuk revisi yang disimpan di Amazon S3:
+ Nama bucket Amazon S3 yang berisi revisi.
+ Nama revisi yang diunggah.
+ (Opsional) Pengidentifikasi versi Amazon S3 untuk revisi. (Jika pengenal versi tidak ditentukan, CodeDeploy gunakan versi terbaru.)
+ (Opsional) ETag Untuk revisi. (Jika tidak ETag ditentukan, CodeDeploy lewati validasi objek.)
Untuk revisi yang disimpan dalam file yang tidak ada di Amazon S3, Anda memerlukan nama file dan jalurnya. File revisi Anda ditulis menggunakan JSON atau YAMAL, jadi kemungkinan besar memiliki ekstensi.json atau .yaml.
+ (Opsional) Deskripsi untuk penerapan.
File revisi dapat ditentukan sebagai file yang diunggah ke bucket Amazon S3 atau sebagai string. Sintaks untuk masing-masing ketika digunakan sebagai bagian dari **create-deployment** perintah adalah:
+ Ember Amazon S3:
`version`Dan `eTag` bersifat opsional.
```
--s3-location bucket=string,key=string,bundleType=JSON|YAML,version=string,eTag=string
```
+ Tali:
```
--revision '{"revisionType": "String", "string": {"content":"revision-as-string"}}'
```
**catatan**
**create-deployment**Perintah dapat memuat revisi dari file. Untuk informasi selengkapnya, lihat [Memuat parameter dari file](https://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html#cli-using-param-file).
Untuk templat revisi AWS Lambda penerapan, lihat. [Menambahkan AppSpec file untuk penyebaran AWS Lambda](application-revisions-appspec-file.md#add-appspec-file-lambda) Untuk contoh revisi, lihat[AppSpec Contoh file untuk penerapan AWS Lambda](reference-appspec-file-example.md#appspec-file-example-lambda).
Untuk melacak status penerapan Anda, lihat[Lihat CodeDeploy detail penerapan](deployments-view-details.md).
# Membuat penerapan AWS Lambda Compute Platform (CLI)
Setelah Anda membuat aplikasi dan revisi (dalam penerapan AWS Lambda, ini adalah file): AppSpec
Panggil perintah [create-deployment](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment.html), dengan menentukan:
+ Nama aplikasi. Untuk melihat daftar nama aplikasi, panggil perintah [daftar-aplikasi](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-applications.html).
+ Nama grup penyebaran. Untuk melihat daftar nama grup penyebaran, panggil [list-deployment-groups](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-groups.html)perintah.
+ Informasi tentang revisi yang akan digunakan:
Untuk revisi yang disimpan di Amazon S3:
+ Nama bucket Amazon S3 yang berisi revisi.
+ Nama revisi yang diunggah.
+ (Opsional) Pengidentifikasi versi Amazon S3 untuk revisi. (Jika pengenal versi tidak ditentukan, CodeDeploy gunakan versi terbaru.)
+ (Opsional) ETag Untuk revisi. (Jika tidak ETag ditentukan, CodeDeploy lewati validasi objek.)
Untuk revisi yang disimpan dalam file yang tidak ada di Amazon S3, Anda memerlukan nama file dan jalurnya. File revisi Anda ditulis menggunakan JSON atau YAMAL, jadi kemungkinan besar memiliki ekstensi.json atau .yaml.
+ (Opsional) Nama konfigurasi penerapan yang akan digunakan. Untuk melihat daftar konfigurasi penerapan, panggil perintah. [list-deployment-configs](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-configs.html) (Jika tidak ditentukan, CodeDeploy gunakan konfigurasi penerapan default tertentu.)
+ (Opsional) Deskripsi untuk penerapan.
File revisi dapat ditentukan sebagai file yang diunggah ke bucket Amazon S3 atau sebagai string. Sintaks untuk masing-masing ketika digunakan sebagai bagian dari **create-deployment** perintah adalah:
+ Ember Amazon S3:
`version`Dan `eTag` bersifat opsional.
```
--s3-location bucket=string,key=string,bundleType=JSON|YAML,version=string,eTag=string
```
+ Tali:
```
--revision '{"revisionType": "String", "string": {"content":"revision-as-string"}}'
```
**catatan**
**create-deployment**Perintah dapat memuat revisi dari file. Untuk informasi selengkapnya, lihat [Memuat parameter dari file](https://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html#cli-using-param-file).
Untuk templat revisi AWS Lambda penerapan, lihat. [Menambahkan AppSpec file untuk penyebaran AWS Lambda](application-revisions-appspec-file.md#add-appspec-file-lambda) Untuk contoh revisi, lihat[AppSpec Contoh file untuk penerapan AWS Lambda](reference-appspec-file-example.md#appspec-file-example-lambda).
Untuk melacak status penerapan Anda, lihat[Lihat CodeDeploy detail penerapan](deployments-view-details.md).
# Membuat penerapan Platform Komputasi EC2/Lokal (CLI)
Untuk menggunakan untuk menerapkan revisi AWS CLI ke platform komputasi EC2/On-premise:
1. Setelah Anda menyiapkan instance, membuat aplikasi, dan mendorong revisi, lakukan salah satu hal berikut:
+ Jika Anda ingin menerapkan revisi dari bucket Amazon S3, lanjutkan ke langkah 2 sekarang.
+ Jika Anda ingin menerapkan revisi dari GitHub repositori, pertama-tama selesaikan langkah-langkahnya, lalu lanjutkan ke langkah 2. [Connect CodeDeploy aplikasi ke GitHub repositori](deployments-create-cli-github.md)
1. Panggil perintah [create-deployment](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment.html), dengan menentukan:
+ `--application-name`: Nama aplikasi. Untuk melihat daftar nama aplikasi, panggil perintah [daftar-aplikasi](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-applications.html).
+ `--deployment-group-name`: Nama grup penyebaran Amazon EC2. Untuk melihat daftar nama grup penyebaran, panggil [list-deployment-groups](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-groups.html)perintah.
+ `--revision`: Informasi tentang revisi yang akan digunakan:
Untuk revisi yang disimpan di Amazon S3:
+ `s3Location`: Nama bucket Amazon S3 yang berisi revisi.
+ `s3Location --> key`: Nama revisi yang diunggah.
+ `s3Location --> bundleType`: Jenis file revisi yang diunggah.
**catatan**
Format file arsip tar dan tar terkompresi (.tar dan.tar.gz) tidak didukung untuk instance Windows Server.
+ `s3Location --> version`: (Opsional) Pengidentifikasi versi Amazon S3 untuk revisi. (Jika pengenal versi tidak ditentukan, CodeDeploy gunakan versi terbaru.)
+ `s3Location --> eTag`: (Opsional) ETag Untuk revisi. (Jika tidak ETag ditentukan, CodeDeploy lewati validasi objek.)
Untuk revisi yang disimpan di GitHub:
+ `gitHubLocation --> repository`: Nama GitHub pengguna atau grup yang ditetapkan ke repositori yang berisi revisi, diikuti dengan garis miring (`/`), diikuti dengan nama repositori.
+ `gitHubLocation --> commitId`: ID komit untuk revisi.
+ `--deployment-config-name`: (Opsional) Nama konfigurasi penerapan yang akan digunakan. Untuk melihat daftar konfigurasi penerapan, panggil perintah. [list-deployment-configs](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-configs.html) (Jika tidak ditentukan, CodeDeploy gunakan konfigurasi penerapan default tertentu.)
+ `--ignore-application-stop-failures | --no-ignore-application-stop-failures`: (Opsional) Apakah Anda ingin penerapan ke instance melanjutkan ke peristiwa siklus hidup `BeforeInstall` penerapan jika peristiwa siklus hidup `ApplicationStop` penerapan gagal.
+ `--description`: (Opsional) Deskripsi untuk penerapan.
+ `--file-exists-behavior`: (Opsional) Sebagai bagian dari proses penerapan, CodeDeploy agen menghapus dari setiap instance semua file yang diinstal oleh penerapan terbaru. Pilih apa yang terjadi ketika file yang bukan bagian dari penerapan sebelumnya muncul di lokasi penyebaran target.
+ `--target-instances`: Untuk blue/green penerapan, informasi tentang instans yang termasuk dalam lingkungan pengganti dalam blue/green penerapan, termasuk nama satu atau beberapa grup Penskalaan Otomatis Amazon EC2, atau kunci filter tag, jenis, dan nilai yang digunakan untuk mengidentifikasi instans Amazon EC2.
**catatan**
Gunakan sintaks ini sebagai bagian dari **create-deployment** panggilan untuk menentukan informasi tentang revisi di Amazon S3 langsung pada baris perintah. (Itu `version` dan `eTag` opsional.)
```
--s3-location bucket=string,key=string,bundleType=tar|tgz|zip,version=string,eTag=string
```
Gunakan sintaks ini sebagai bagian dari **create-deployment** panggilan untuk menentukan informasi tentang revisi GitHub langsung pada baris perintah:
```
--github-location repository=string,commitId=string
```
Untuk mendapatkan informasi tentang revisi yang sudah didorong, hubungi [list-application-revisions](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-application-revisions.html)perintah.
Untuk melacak status penerapan Anda, lihat[Lihat CodeDeploy detail penerapan](deployments-view-details.md).
## referensi perintah create-deployment
Di bawah ini adalah struktur perintah dan opsi untuk `create-deployment` perintah. *Untuk informasi selengkapnya, lihat referensi [create-deployment di Command](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment.html) Reference.AWS CLI *
```
create-deployment
--application-name
[--deployment-group-name ]
[--revision ]
[--deployment-config-name ]
[--description ]
[--ignore-application-stop-failures | --no-ignore-application-stop-failures]
[--target-instances ]
[--auto-rollback-configuration ]
[--update-outdated-instances-only | --no-update-outdated-instances-only]
[--file-exists-behavior ]
[--s3-location ]
[--github-location ]
[--cli-input-json ]
[--generate-cli-skeleton ]
```
# Connect CodeDeploy aplikasi ke GitHub repositori
Sebelum Anda dapat menyebarkan aplikasi dari GitHub repositori untuk pertama kalinya menggunakan AWS CLI, Anda harus terlebih dahulu memberikan CodeDeploy izin untuk berinteraksi dengan GitHub atas nama akun Anda. GitHub Langkah ini harus diselesaikan satu kali untuk setiap aplikasi menggunakan CodeDeploy konsol.
1. Masuk ke Konsol Manajemen AWS dan buka CodeDeploy konsol di [https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy).
**catatan**
Masuk dengan pengguna yang sama dengan yang Anda atur[Memulai dengan CodeDeploy](getting-started-codedeploy.md).
1. Pilih **Aplikasi**.
1. Dari **Aplikasi**, pilih aplikasi yang ingin Anda tautkan ke akun GitHub pengguna Anda dan pilih **Deploy aplikasi**.
**catatan**
Anda tidak membuat penerapan. Ini saat ini satu-satunya cara untuk memberikan CodeDeploy izin untuk berinteraksi dengan GitHub atas nama akun GitHub pengguna Anda.
1. Di samping **Jenis repositori**, pilih **Revisi aplikasi saya disimpan** di. GitHub
1. Pilih **Connect to GitHub**.
**catatan**
Jika Anda melihat link **Connect to GitHub account lain**:
Anda mungkin telah berwenang CodeDeploy untuk berinteraksi dengan GitHub atas nama GitHub akun lain untuk aplikasi tersebut.
Anda mungkin telah mencabut otorisasi CodeDeploy untuk berinteraksi dengan GitHub atas nama GitHub akun yang masuk untuk semua aplikasi yang ditautkan ke dalam. CodeDeploy
Untuk informasi selengkapnya, lihat [GitHub otentikasi dengan aplikasi di CodeDeploy](integrations-partners-github.md#behaviors-authentication).
1. Jika Anda belum masuk GitHub, ikuti petunjuk di halaman **Masuk**.
1. Pada halaman **Otorisasi aplikasi**, pilih **Otorisasi** aplikasi.
1. Sekarang yang CodeDeploy memiliki izin, pilih **Batal**, dan lanjutkan dengan langkah-langkah masuk[Membuat penerapan Platform Komputasi EC2/Lokal (CLI)](deployments-create-cli.md).
# Buat blue/green penyebaran Amazon ECS melalui CloudFormation
Anda dapat menggunakan AWS CloudFormation untuk mengelola blue/green penyebaran Amazon ECS melalui. CodeDeploy Anda menghasilkan penyebaran Anda dengan mendefinisikan sumber daya hijau dan biru Anda dan menentukan pengaturan perutean dan stabilisasi lalu lintas yang akan digunakan. CloudFormation Topik ini mencakup perbedaan antara blue/green penerapan Amazon ECS yang dikelola oleh CodeDeploy dan penerapan yang dikelola oleh. CloudFormation
*Untuk step-by-step petunjuk tentang penggunaan CloudFormation untuk mengelola penerapan biru/hijau Amazon ECS Anda, lihat [Mengotomatiskan penerapan biru/hijau ECS melalui penggunaan di Panduan](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/blue-green.html) Pengguna. CodeDeploy AWS CloudFormationAWS CloudFormation *
**catatan**
Mengelola blue/green penerapan Amazon ECS tidak CloudFormation tersedia di wilayah Asia Pasifik (Osaka).
## Perbedaan antara blue/green penerapan Amazon ECS melalui dan CodeDeploy CloudFormation
Templat CloudFormation tumpukan memodelkan sumber daya dan infrastruktur terkait tugas Amazon ECS, dan juga opsi konfigurasi untuk penerapan. Jadi ada perbedaan antara penerapan Amazon ECS standar dan blue/green blue/green penerapan yang dibuat melalui. CloudFormation
Tidak seperti blue/green penerapan Amazon ECS standar, Anda tidak memodelkan atau membuat yang berikut secara manual:
+ Anda tidak membuat AWS CodeDeploy aplikasi dengan menentukan nama yang secara unik mewakili apa yang ingin Anda terapkan.
+ Anda tidak membuat grup AWS CodeDeploy penerapan.
+ Anda tidak menentukan *file spesifikasi aplikasi* (AppSpec file). Informasi yang biasanya dikelola dengan AppSpec file, seperti opsi konfigurasi tertimbang atau peristiwa siklus hidup, dikelola oleh hook. `AWS::CodeDeploy::BlueGreen`
Tabel ini merangkum perbedaan alur kerja tingkat tinggi antara jenis penerapan.
****
| Fungsi | blue/green Penerapan standar | Penerapan biru/hijau melalui CloudFormation |
| --- | --- | --- |
| Tentukan cluster Amazon ECS, layanan Amazon ECS, Application Load Balancer atau Network Load Balancer, Production listener, test listener, dan dua grup target. | Buat grup CodeDeploy penyebaran yang menentukan sumber daya ini. | Buat CloudFormation template untuk memodelkan sumber daya ini. |
| Tentukan perubahan yang akan diterapkan. | Buat CodeDeploy aplikasi. | Buat CloudFormation template yang menentukan gambar kontainer. |
| Tentukan definisi tugas Amazon ECS, nama kontainer, dan port kontainer. | Buat AppSpec file yang menentukan sumber daya ini. | Buat CloudFormation template untuk memodelkan sumber daya ini. |
| Tentukan opsi pemindahan lalu lintas penerapan dan kait peristiwa siklus hidup. | Buat AppSpec file yang menentukan opsi ini. | Buat CloudFormation template yang menggunakan parameter AWS::CodeDeploy::BlueGreen hook untuk menentukan opsi ini. |
| CloudWatch alarm. | Buat CloudWatch alarm yang memicu rollback. | Konfigurasikan CloudWatch alarm di tingkat CloudFormation tumpukan yang memicu rollback. |
| Rollback/redeployment. | Tentukan opsi rollback dan redeployment. | Batalkan pembaruan tumpukan di CloudFormation. |
## Memantau blue/green penyebaran Amazon ECS melalui CloudFormation
Anda dapat memantau blue/green penerapan melalui CloudFormation dan. CodeDeploy Untuk informasi tentang pemantauan melalui CloudFormation, lihat [Memantau blue/green peristiwa CloudFormation di](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/blue-green.html#blue-green-events) *Panduan AWS CloudFormation Pengguna*.
**Untuk melihat status penerapan blue/green penerapan di CodeDeploy**
1. Masuk ke Konsol Manajemen AWS dan buka CodeDeploy konsol di [https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy).
**catatan**
Masuk dengan pengguna yang sama dengan yang Anda atur[Memulai dengan CodeDeploy](getting-started-codedeploy.md).
1. Di **Deployment**, penerapan yang dipicu oleh pembaruan CloudFormation tumpukan muncul. Pilih penerapan untuk melihat riwayat **Deployment**.
![\[Tangkapan layar konsol yang menampilkan bagian Deployment dan riwayat penerapan.\]](http://docs.aws.amazon.com/id_id/codedeploy/latest/userguide/images/cfn-cd-bg-deplhist.png)
1. Pilih penyebaran untuk melihat status pergeseran lalu lintas. Perhatikan bahwa grup aplikasi dan penyebaran tidak dibuat.
![\[Tangkapan layar konsol yang menampilkan detail penerapan dengan status penerapan selesai.\]](http://docs.aws.amazon.com/id_id/codedeploy/latest/userguide/images/cfn-cd-bg-deplstatus.png)
1. Berikut ini berlaku untuk memutar kembali atau menghentikan penerapan:
+ Penerapan yang berhasil muncul CodeDeploy dan menunjukkan bahwa penerapan diprakarsai oleh. CloudFormation
+ Jika Anda ingin menghentikan dan memutar kembali penerapan, Anda harus membatalkan pembaruan tumpukan di CloudFormation.
# Lihat CodeDeploy detail penerapan
Anda dapat menggunakan CodeDeploy konsol, konsol AWS CLI, atau CodeDeploy APIs untuk melihat detail tentang penerapan yang terkait dengan akun Anda AWS .
**catatan**
Anda dapat melihat EC2/Log penerapan lokal pada instans Anda di lokasi berikut:
Amazon Linux, RHEL, dan Server Ubuntu: `/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log`
Server Windows: C:\$1ProgramData\$1 Amazon\$1 CodeDeploy \$1 log\$1 scripts.log
Untuk informasi selengkapnya, lihat [Menganalisis file log untuk menyelidiki kegagalan penerapan pada instance](troubleshooting-ec2-instances.md#troubleshooting-deploy-failures).
**Topics**
+ [Lihat detail penerapan (konsol)](#deployments-view-details-console)
+ [Lihat detail penerapan (CLI)](#deployments-view-details-cli)
## Lihat detail penerapan (konsol)
Untuk menggunakan CodeDeploy konsol untuk melihat detail penerapan:
1. Masuk ke Konsol Manajemen AWS dan buka CodeDeploy konsol di [https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy).
**catatan**
Masuk dengan pengguna yang sama dengan yang Anda atur[Memulai dengan CodeDeploy](getting-started-codedeploy.md).
1. **Di panel navigasi, perluas **Deploy, lalu pilih Deployments**.**
**catatan**
Jika tidak ada entri yang ditampilkan, pastikan wilayah yang benar dipilih. Pada bilah navigasi, di pemilih wilayah, pilih salah satu wilayah yang tercantum di [Wilayah dan Titik Akhir](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region) di. *Referensi Umum AWS* CodeDeploy hanya didukung di wilayah ini.
1. **Untuk melihat detail selengkapnya untuk satu penerapan, dalam **riwayat Deployment**, pilih ID penerapan atau pilih tombol di sebelah ID penerapan, lalu pilih Lihat.**
## Lihat detail penerapan (CLI)
Untuk menggunakan AWS CLI untuk melihat rincian penyebaran, panggil `get-deployment` perintah atau `batch-get-deployments` perintah. Anda dapat memanggil `list-deployments` perintah untuk mendapatkan daftar penyebaran unik IDs untuk digunakan sebagai input ke `get-deployment` perintah dan perintah. `batch-get-deployments`
Untuk melihat detail tentang penerapan tunggal, panggil perintah [get-deployment](https://docs.aws.amazon.com/cli/latest/reference/deploy/get-deployment.html), dengan menentukan pengenal penerapan unik. Untuk mendapatkan ID penerapan, panggil perintah [list-deployments](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployments.html).
Untuk melihat detail tentang beberapa penerapan, panggil [batch-get-deployments](https://docs.aws.amazon.com/cli/latest/reference/deploy/batch-get-deployments.html)perintah, tentukan beberapa pengidentifikasi penerapan unik. Untuk mendapatkan penerapan IDs, panggil perintah [list-deployments](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployments.html).
Untuk melihat daftar penerapan IDs, panggil perintah [list-deployments](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployments.html), dengan menentukan:
+ Nama aplikasi yang terkait dengan penyebaran. Untuk melihat daftar nama aplikasi, panggil perintah [daftar-aplikasi](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-applications.html).
+ Nama grup penyebaran yang terkait dengan penyebaran. Untuk melihat daftar nama grup penyebaran, panggil [list-deployment-groups](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-groups.html)perintah.
+ Secara opsional, apakah akan menyertakan detail tentang penerapan berdasarkan status penerapannya. (Jika tidak ditentukan, semua penerapan yang cocok akan dicantumkan, terlepas dari status penerapannya.)
+ Secara opsional, apakah akan menyertakan detail tentang penerapan berdasarkan waktu mulai pembuatan penerapan atau waktu akhir, atau keduanya. (Jika tidak ditentukan, semua penerapan yang cocok akan dicantumkan, terlepas dari waktu pembuatannya.)
# Melihat data log untuk penerapan CodeDeploy EC2/Lokal
Anda dapat melihat data log yang dibuat oleh CodeDeploy penerapan dengan menyiapkan CloudWatch agen Amazon untuk melihat data agregat di CloudWatch konsol atau dengan masuk ke instance individual untuk meninjau file log.
**catatan**
Log tidak didukung untuk penerapan AWS Lambda atau Amazon ECS. Mereka dapat dibuat hanya untuk penerapan EC2/On-premise.
**Topics**
+ [Lihat data file log di CloudWatch konsol Amazon](#deployments-view-logs-cloudwatch)
+ [Lihat file log pada sebuah instance](#deployments-view-logs-instance)
## Lihat data file log di CloudWatch konsol Amazon
Saat CloudWatch agen Amazon diinstal pada instance, data penerapan untuk semua penerapan ke instance tersebut akan tersedia untuk dilihat di konsol. CloudWatch Untuk mempermudah, sebaiknya gunakan CloudWatch untuk memonitor file log secara terpusat alih-alih melihatnya secara instance per instance. Untuk informasi selengkapnya, lihat [Kirim log CodeDeploy agen ke CloudWatch](codedeploy-agent-operations-cloudwatch-agent.md).
## Lihat file log pada sebuah instance
Untuk melihat data log penerapan untuk instance individual, Anda dapat masuk ke instans dan menelusuri informasi tentang kesalahan atau peristiwa penerapan lainnya.
**Topics**
+ [Untuk melihat file log penerapan di Amazon Linux, RHEL, dan instance Server Ubuntu](#deployments-view-logs-instance-unix)
+ [Untuk melihat file log penyebaran pada instance Windows Server](#deployments-view-logs-instance-windows)
### Untuk melihat file log penerapan di Amazon Linux, RHEL, dan instance Server Ubuntu
Pada instans Amazon Linux, RHEL, dan Ubuntu Server, log penerapan disimpan di lokasi berikut:
`/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log`
Untuk melihat atau menganalisis log penerapan di Amazon Linux, RHEL, dan instance Server Ubuntu, masuk ke instance, lalu ketik perintah berikut untuk membuka file log CodeDeploy agen:
```
less /var/log/aws/codedeploy-agent/codedeploy-agent.log
```
Ketik perintah berikut untuk menelusuri file log untuk pesan kesalahan:
| Perintah | Hasil |
| --- | --- |
| & ERROR | Tampilkan hanya pesan kesalahan dalam file log. Gunakan satu spasi sebelum dan sesudah kataERROR. |
| / ERROR | Cari pesan kesalahan berikutnya.¹ |
| ? ERROR | Cari pesan kesalahan sebelumnya.² Gunakan satu spasi sebelum dan sesudah kata. ERROR |
| G | Pergi ke akhir file log. |
| g | Pergi ke awal file log. |
| q | Keluar dari file log. |
| h | Pelajari tentang perintah tambahan. |
| ¹ Setelah Anda mengetik**/ ERROR **, ketik **n** untuk pesan kesalahan berikutnya. Ketik **N** untuk pesan kesalahan sebelumnya. ² Setelah Anda mengetik**? ERROR **, ketik **n** untuk pesan kesalahan berikutnya, atau ketik **N** untuk pesan kesalahan sebelumnya. |
Anda juga dapat mengetik perintah berikut untuk membuka file log CodeDeploy skrip:
```
less /opt/codedeploy-agent/deployment-root/deployment-group-ID/deployment-ID/logs/scripts.log
```
Ketik perintah berikut untuk menelusuri file log untuk pesan kesalahan:
| Perintah | Hasil |
| --- | --- |
| &stderr | Tampilkan hanya pesan kesalahan dalam file log. |
| /stderr | Cari pesan kesalahan berikutnya.¹ |
| ?stderr | Cari pesan kesalahan sebelumnya.² |
| G | Pergi ke akhir file log. |
| g | Pergi ke awal file log. |
| q | Keluar dari file log. |
| h | Pelajari tentang perintah tambahan. |
| ¹Setelah Anda mengetik**/stderr**, ketik **n** untuk meneruskan pesan kesalahan berikutnya. Ketik **N** pesan kesalahan sebelumnya ke belakang. ² Setelah Anda mengetik**?stderr**, **n** ketik pesan kesalahan berikutnya ke belakang. Ketik **N** untuk meneruskan pesan kesalahan sebelumnya. |
### Untuk melihat file log penyebaran pada instance Windows Server
**CodeDeploy file log agen**: Pada instance Windows Server, file log CodeDeploy agen disimpan di lokasi berikut:
`C:\ProgramData\Amazon\CodeDeploy\log\codedeploy-agent-log.txt`
Untuk melihat atau menganalisis file log CodeDeploy agen pada instance Windows Server, masuk ke instance, lalu ketik perintah berikut untuk membuka file:
```
notepad C:\ProgramData\Amazon\CodeDeploy\log\codedeploy-agent-log.txt
```
Untuk menelusuri file log untuk pesan kesalahan, tekan CTRL\$1F, ketik**ERROR [**, lalu tekan Enter untuk menemukan kesalahan pertama.
**CodeDeploy file log skrip**: Pada instance Windows Server, log penyebaran disimpan di lokasi berikut:
`C:\ProgramData\Amazon\CodeDeploy\deployment-group-id\deployment-id\logs\scripts.log`
Di mana:
+ *deployment-group-id*adalah string seperti `examplebf3a9c7a-7c19-4657-8684-b0c68d0cd3c4`
+ *deployment-id*adalah pengenal seperti `d-12EXAMPLE`
Ketik perintah berikut untuk membuka file log CodeDeploy skrip:
```
notepad C:\ProgramData\Amazon\CodeDeploy\deployment-group-ID\deployment-ID\logs\scripts.log
```
Untuk menelusuri file log untuk pesan kesalahan, tekan CTRL\$1F, ketik**stderr**, lalu tekan Enter untuk menemukan kesalahan pertama.
# Hentikan penerapan dengan CodeDeploy
Anda dapat menggunakan CodeDeploy konsol, konsol AWS CLI, atau CodeDeploy APIs untuk menghentikan penerapan yang terkait dengan akun Anda AWS .
**Awas**
Menghentikan penerapan EC2 /Lokal dapat meninggalkan beberapa atau semua instance di grup penerapan Anda dalam status penerapan yang tidak ditentukan. Untuk informasi selengkapnya, lihat [Penerapan yang dihentikan dan gagal](deployment-steps-server.md#deployment-stop-fail).
**Topics**
+ [Hentikan penerapan (konsol)](#deployments-stop-console)
+ [Hentikan penerapan (CLI)](#deployments-stop-cli)
**catatan**
Jika penerapan Anda adalah penerapan biru/hijau CloudFormation, Anda tidak dapat melakukan tugas ini di konsol. CodeDeploy Pergi ke CloudFormation konsol untuk melakukan tugas ini.
## Hentikan penerapan (konsol)
1. Masuk ke Konsol Manajemen AWS dan buka CodeDeploy konsol di [https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy).
**catatan**
Masuk dengan pengguna yang sama dengan yang Anda atur[Memulai dengan CodeDeploy](getting-started-codedeploy.md).
1. **Di panel navigasi, perluas **Deploy, lalu pilih Deployments**.**
**catatan**
Jika tidak ada entri yang ditampilkan, pastikan wilayah yang benar dipilih. Pada bilah navigasi, di pemilih wilayah, pilih salah satu wilayah yang tercantum di [Wilayah dan Titik Akhir](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region) di. *Referensi Umum AWS* CodeDeploy hanya didukung di wilayah ini.
1. Pilih penerapan yang ingin Anda hentikan, lakukan salah satu hal berikut:
1. Pilih **Stop deployment** untuk menghentikan penerapan tanpa rollback.
1. Pilih **Berhenti dan putar kembali penerapan** untuk menghentikan dan memutar kembali penerapan
Untuk informasi selengkapnya, lihat [Menerapkan ulang dan memutar kembali penerapan dengan CodeDeploy](deployments-rollback-and-redeploy.md).
**catatan**
Jika **Stop deployment** **dan Stop and roll back deployment** tidak tersedia, penerapan telah berkembang ke titik di mana tidak dapat dihentikan.
## Hentikan penerapan (CLI)
Panggil perintah [stop-deployment](https://docs.aws.amazon.com/cli/latest/reference/deploy/stop-deployment.html), dengan menentukan ID deployment. Untuk melihat daftar penerapan IDs, panggil perintah [list-deployments](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployments.html).
# Menerapkan ulang dan memutar kembali penerapan dengan CodeDeploy
CodeDeploy memutar kembali penerapan dengan menerapkan kembali revisi aplikasi yang sebelumnya diterapkan sebagai penerapan baru. Penerapan rolled-back ini secara teknis adalah penerapan baru, dengan penerapan baru, bukan versi yang dipulihkan dari penerapan sebelumnya IDs.
Penerapan dapat diputar kembali secara otomatis atau manual.
**Topics**
+ [Rollback otomatis](#deployments-rollback-and-redeploy-automatic-rollbacks)
+ [Rollback manual](#deployments-rollback-and-redeploy-manual-rollbacks)
+ [Alur kerja rollback dan redeployment](#deployments-rollback-and-redeploy-workflow)
+ [Perilaku rollback dengan konten yang ada](#deployments-rollback-and-redeploy-content-options)
## Rollback otomatis
Anda dapat mengonfigurasi grup penerapan atau penerapan untuk memutar kembali secara otomatis saat penerapan gagal atau saat ambang batas pemantauan yang Anda tentukan terpenuhi. Dalam hal ini, versi baik terakhir yang diketahui dari revisi aplikasi digunakan. Anda mengonfigurasi rollback otomatis saat membuat aplikasi atau membuat atau memperbarui grup penyebaran.
Saat membuat penerapan baru, Anda juga dapat memilih untuk mengganti konfigurasi rollback otomatis yang ditentukan untuk grup penerapan.
**catatan**
Anda dapat menggunakan Amazon Simple Notification Service untuk menerima notifikasi setiap kali penerapan digulirkan kembali secara otomatis. Untuk informasi, lihat [Memantau penerapan dengan notifikasi acara Amazon SNS](monitoring-sns-event-notifications.md).
Untuk informasi selengkapnya tentang mengonfigurasi rollback otomatis, lihat. [Mengonfigurasi opsi lanjutan untuk grup deployment](deployment-groups-configure-advanced-options.md)
## Rollback manual
Jika Anda belum menyiapkan rollback otomatis, Anda dapat memutar kembali penerapan secara manual dengan membuat penerapan baru yang menggunakan revisi aplikasi yang digunakan sebelumnya dan mengikuti langkah-langkah untuk menerapkan revisi. Anda dapat melakukan ini jika aplikasi telah masuk ke keadaan yang tidak diketahui. Daripada menghabiskan banyak waktu pemecahan masalah, Anda dapat menerapkan ulang aplikasi ke status kerja yang diketahui. Untuk informasi selengkapnya, lihat [Buat penerapan dengan CodeDeploy](deployments-create.md).
**catatan**
Jika Anda menghapus instance dari grup penyebaran, CodeDeploy tidak menghapus instalan apa pun yang mungkin telah diinstal pada instance itu.
## Alur kerja rollback dan redeployment
Ketika rollback otomatis dimulai, atau ketika Anda secara manual memulai redeployment atau manual rollback, CodeDeploy pertama-tama mencoba untuk menghapus dari setiap instance yang berpartisipasi semua file yang terakhir berhasil diinstal. CodeDeploy melakukan ini dengan memeriksa file pembersihan:
`/opt/codedeploy-agent/deployment-root/deployment-instructions/deployment-group-ID-cleanup`file (untuk Amazon Linux, Ubuntu Server, dan instans RHEL)
`C:\ProgramData\Amazon\CodeDeploy\deployment-instructions\deployment-group-ID-cleanup`file (untuk instance Windows Server)
Jika ada, CodeDeploy gunakan file pembersihan untuk menghapus dari instance semua file yang terdaftar sebelum memulai penerapan baru.
Misalnya, dua file teks pertama dan dua file skrip sudah digunakan ke instans Amazon EC2 yang menjalankan Windows Server, dan skrip membuat dua file teks lagi selama peristiwa siklus hidup penerapan:
```
c:\temp\a.txt (previously deployed by CodeDeploy)
c:\temp\b.txt (previously deployed by CodeDeploy)
c:\temp\c.bat (previously deployed by CodeDeploy)
c:\temp\d.bat (previously deployed by CodeDeploy)
c:\temp\e.txt (previously created by c.bat)
c:\temp\f.txt (previously created by d.bat)
```
File pembersihan hanya akan mencantumkan dua file teks pertama dan dua file skrip:
```
c:\temp\a.txt
c:\temp\b.txt
c:\temp\c.bat
c:\temp\d.bat
```
Sebelum penyebaran baru, CodeDeploy akan menghapus hanya dua file teks pertama dan dua file skrip, meninggalkan dua file teks terakhir yang tidak tersentuh:
```
c:\temp\a.txt will be removed
c:\temp\b.txt will be removed
c:\temp\c.bat will be removed
c:\temp\d.bat will be removed
c:\temp\e.txt will remain
c:\temp\f.txt will remain
```
Sebagai bagian dari proses ini, tidak CodeDeploy akan mencoba mengembalikan atau mendamaikan tindakan apa pun yang diambil oleh skrip apa pun dalam penerapan sebelumnya selama pemindahan berikutnya, baik secara manual maupun otomatis. Misalnya, jika `d.bat` file `c.bat` dan berisi logika untuk tidak membuat ulang `f.txt` file `e.txt` dan jika sudah ada, maka versi lama `e.txt` dan `f.txt` akan tetap tidak tersentuh setiap kali CodeDeploy berjalan `c.bat` dan `d.bat` dalam penerapan berikutnya. Anda dapat menambahkan logika `d.bat` ke `c.bat` dan untuk selalu memeriksa dan menghapus versi lama `e.txt` dan `f.txt` sebelum membuat yang baru.
## Perilaku rollback dengan konten yang ada
Sebagai bagian dari proses penyebaran, CodeDeploy agen menghapus dari setiap instance semua file yang diinstal oleh penerapan terbaru. Jika file yang bukan bagian dari penerapan sebelumnya muncul di lokasi penyebaran target, Anda dapat memilih apa yang CodeDeploy dilakukannya selama penerapan berikutnya:
+ **Gagal penerapan** — Kesalahan dilaporkan dan status penerapan diubah menjadi Gagal.
+ **Timpa konten** — Versi file dari revisi aplikasi menggantikan versi yang sudah ada pada instance.
+ **Mempertahankan konten** — File di lokasi target disimpan dan versi dalam revisi aplikasi tidak disalin ke instance.
Anda dapat memilih perilaku ini saat membuat penerapan. Jika membuat penerapan di konsol, lihat[Membuat penerapan Platform Komputasi EC2/Lokal (konsol)](deployments-create-console.md). Jika membuat penerapan dengan AWS CLI, lihat[Membuat penerapan Platform Komputasi EC2/Lokal (CLI)](deployments-create-cli.md).
Anda dapat memilih untuk menyimpan file yang ingin Anda menjadi bagian dari penerapan berikutnya tanpa harus menambahkannya ke paket revisi aplikasi. Misalnya, Anda dapat mengunggah file langsung ke instance yang diperlukan untuk penerapan tetapi tidak ditambahkan ke bundel revisi aplikasi. Atau Anda dapat mengunggah file ke instance jika aplikasi Anda sudah berada di lingkungan produksi Anda tetapi Anda ingin menggunakannya CodeDeploy untuk pertama kalinya untuk menerapkannya.
Dalam kasus rollback, di mana revisi aplikasi terbaru yang berhasil diterapkan diterapkan kembali karena kegagalan penerapan, opsi penanganan konten untuk penerapan terakhir yang berhasil diterapkan pada penerapan rollback.
Namun, jika penerapan yang gagal dikonfigurasi untuk menimpa, alih-alih mempertahankan file, hasil yang tidak terduga dapat terjadi selama rollback. Secara khusus, file yang Anda harapkan untuk disimpan mungkin dihapus oleh penerapan yang gagal. File tidak ada pada instance saat penerapan rollback berjalan.
Dalam contoh berikut, ada tiga penerapan. File apa pun yang ditimpa (dihapus) selama penerapan kedua yang gagal tidak lagi tersedia (tidak dapat dipertahankan) saat revisi aplikasi 1 diterapkan lagi selama penerapan 3:
****
| Deployment | Revisi aplikasi | Opsi menimpa konten | Status deployment | Perilaku dan hasil |
| --- | --- | --- | --- | --- |
| penyebaran 1 | revisi aplikasi 1 | MELESTARIKAN | Berhasil | CodeDeploy mendeteksi file di lokasi target yang tidak digunakan oleh penerapan sebelumnya. File-file ini mungkin ditempatkan di sana dengan sengaja untuk menjadi bagian dari penyebaran saat ini. Mereka disimpan dan dicatat sebagai bagian dari paket penyebaran saat ini. |
| penyebaran 2 | revisi aplikasi 2 | MENIMPA | Gagal | Selama proses penyebaran, CodeDeploy menghapus semua file yang merupakan bagian dari penerapan sukses sebelumnya. Ini termasuk file yang disimpan selama penerapan 1. Namun, penerapan gagal karena alasan yang tidak terkait. |
| penyebaran 3 | revisi aplikasi 1 | MELESTARIKAN | | Karena auto rollback diaktifkan untuk grup penyebaran atau penyebaran, CodeDeploy menyebarkan revisi aplikasi bagus terakhir yang diketahui, revisi aplikasi 1.Namun, file yang ingin Anda simpan dalam penerapan 1 telah dihapus sebelum penerapan 2 gagal dan tidak dapat diambil oleh. AWS CodeDeploy Anda dapat menambahkannya ke instance sendiri jika diperlukan untuk revisi aplikasi 1, atau Anda dapat membuat revisi aplikasi baru. |
# Menyebarkan aplikasi di akun yang berbeda AWS
Organizations umumnya memiliki beberapa AWS akun yang mereka gunakan untuk tujuan yang berbeda (misalnya, satu untuk tugas administrasi sistem dan satu lagi untuk pengembangan, pengujian, dan tugas produksi atau yang terkait dengan lingkungan pengembangan dan pengujian dan lainnya terkait dengan lingkungan produksi).
Meskipun Anda mungkin melakukan pekerjaan terkait di akun yang berbeda, grup CodeDeploy penerapan, dan instans Amazon EC2 yang mereka gunakan terkait erat dengan akun tempat mereka dibuat. Anda tidak dapat, misalnya, menambahkan instance yang Anda luncurkan di satu akun ke grup penyebaran di akun lain.
Asumsikan Anda memiliki dua AWS akun: akun pengembangan dan akun produksi Anda. Anda bekerja terutama di akun pengembangan, tetapi Anda ingin dapat memulai penerapan di akun produksi Anda tanpa set lengkap kredensi di sana atau tanpa harus keluar dari akun pengembangan dan masuk ke akun produksi.
Setelah mengikuti langkah-langkah konfigurasi lintas akun, Anda dapat memulai penerapan yang dimiliki oleh akun organisasi Anda yang lain tanpa memerlukan set lengkap kredensional untuk akun lain tersebut. Anda melakukan ini, sebagian, dengan menggunakan kemampuan yang disediakan oleh AWS Security Token Service (AWS STS) yang memberi Anda akses sementara ke akun itu.
## Langkah 1: Buat bucket S3 di salah satu akun
Baik dalam akun pengembangan atau akun produksi:
+ Jika Anda belum melakukannya, buat bucket Amazon S3 tempat revisi aplikasi untuk akun produksi akan disimpan. Untuk selengkapnya, lihat [Membuat Bucket di Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/CreatingABucket.html). Anda bahkan dapat menggunakan bucket dan revisi aplikasi yang sama untuk kedua akun, menerapkan file yang sama ke lingkungan produksi yang Anda uji dan verifikasi di akun pengembangan Anda.
## Langkah 2: Berikan izin bucket Amazon S3 ke profil instans IAM akun produksi
Jika bucket Amazon S3 yang Anda buat di langkah 1 ada di akun produksi Anda, langkah ini tidak diperlukan. Peran yang Anda asumsikan nanti sudah memiliki akses ke bucket ini karena juga ada di akun produksi.
Jika Anda membuat bucket Amazon S3 di akun pengembangan, lakukan hal berikut:
+ Di akun produksi, buat profil instans IAM. Untuk informasi, lihat [Langkah 4: Buat profil instans IAM untuk instans Amazon EC2 Anda](getting-started-create-iam-instance-profile.md).
**catatan**
Catat ARN untuk profil instans IAM ini. Anda harus menambahkannya ke kebijakan cross-bucket yang Anda buat selanjutnya.
+ Di akun pengembangan, berikan akses ke bucket Amazon S3 yang Anda buat di akun pengembangan ke profil instans IAM yang baru saja Anda buat di akun produksi Anda. Untuk selengkapnya, lihat [Contoh 2: Pemilik bucket yang memberikan izin bucket lintas akun](https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-walkthroughs-managing-access-example2.html).
Perhatikan hal-hal berikut saat Anda menyelesaikan proses pemberian izin bucket lintas akun:
+ Dalam contoh panduan, Akun A mewakili akun pengembangan Anda dan Akun B mewakili akun produksi Anda.
+ Saat Anda [melakukan tugas Akun A (akun pengembangan)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-walkthroughs-managing-access-example2.html#access-policies-walkthrough-cross-account-permissions-acctA-tasks), ubah kebijakan bucket berikut untuk memberikan izin lintas akun alih-alih menggunakan kebijakan sampel yang disediakan dalam panduan.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "Cross-account permissions",
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::111122223333:role/role-name"
},
"Action": [
"s3:Get*",
"s3:List*"
],
"Resource": [
"arn:aws:s3:::bucket-name/*"
]
}
]
}
```
------
*account-id*mewakili nomor akun dari akun produksi tempat Anda baru saja membuat profil instans IAM.
*role-name*mewakili nama profil instans IAM yang baru saja Anda buat.
*bucket-name*mewakili nama bucket yang Anda buat di langkah 1. Pastikan untuk menyertakan `/*` nama bucket Anda untuk memberikan akses ke setiap file di dalam bucket.
## Langkah 3: Buat sumber daya dan peran lintas akun di akun produksi
Di akun produksi Anda:
+ Buat CodeDeploy sumber daya Anda — aplikasi, grup penerapan, konfigurasi penerapan, instans Amazon EC2, profil instans Amazon EC2, peran layanan, dan sebagainya — menggunakan petunjuk dalam panduan ini.
+ Buat peran tambahan, peran IAM lintas akun, yang dapat diasumsikan oleh pengguna di akun pengembangan Anda untuk melakukan CodeDeploy operasi di akun produksi ini.
Gunakan [Walkthrough: Delegasikan akses di seluruh AWS akun menggunakan peran IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/walkthru_cross-account-with-roles.html) sebagai panduan untuk membantu Anda membuat peran lintas akun. Alih-alih menambahkan izin sampel dalam panduan ke dokumen kebijakan Anda, Anda harus melampirkan, setidaknya, dua kebijakan yang AWS diberikan berikut ke peran tersebut:
+ `AmazonS3FullAccess`: Diperlukan hanya jika bucket S3 ada di akun pengembangan. Menyediakan peran akun produksi yang diasumsikan dengan akses penuh ke layanan dan sumber daya Amazon S3 di akun pengembangan, tempat revisi disimpan.
+ `AWSCodeDeployDeployerAccess`: Memungkinkan pengguna untuk mendaftar dan menyebarkan revisi.
Jika Anda ingin membuat dan mengelola grup penerapan dan tidak hanya memulai penerapan, tambahkan `AWSCodeDeployFullAccess` kebijakan sebagai ganti kebijakan. `AWSCodeDeployDeployerAccess` Untuk informasi selengkapnya tentang menggunakan kebijakan terkelola IAM guna memberikan izin CodeDeploy tugas, lihat. [AWS kebijakan terkelola (standar) untuk CodeDeploy](managed-policies.md)
Anda dapat melampirkan kebijakan tambahan jika ingin melakukan tugas di AWS layanan lain saat menggunakan peran lintas akun ini.
**penting**
Saat Anda membuat peran IAM lintas akun, catat detail yang Anda perlukan untuk mendapatkan akses ke akun produksi.
Untuk menggunakan Konsol Manajemen AWS untuk beralih peran, Anda harus menyediakan salah satu dari berikut ini:
URL untuk mengakses akun produksi dengan kredenal peran yang diasumsikan. Anda akan menemukan URL di halaman **Ulasan**, yang ditampilkan di akhir proses pembuatan peran lintas akun.
Nama peran lintas akun dan nomor ID akun atau alias.
Untuk menggunakan AWS CLI untuk beralih peran, Anda harus menyediakan yang berikut:
ARN dari peran lintas akun yang akan Anda asumsikan.
## Langkah 4: Unggah revisi aplikasi ke bucket Amazon S3
Di akun tempat Anda membuat bucket Amazon S3:
+ Unggah revisi aplikasi Anda ke bucket Amazon S3. Untuk informasi, lihat [Dorong revisi CodeDeploy ke Amazon S3 (hanya penerapan EC2/On-premise)](application-revisions-push.md).
## Langkah 5: Asumsikan peran lintas akun dan gunakan aplikasi
Di akun pengembangan, Anda dapat menggunakan AWS CLI atau Konsol Manajemen AWS untuk mengambil peran lintas akun dan memulai penyebaran di akun produksi.
Untuk petunjuk tentang cara menggunakan Konsol Manajemen AWS untuk beralih peran dan memulai penerapan, lihat [Beralih ke role ()Konsol Manajemen AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-console.html) dan. [Membuat penerapan Platform Komputasi EC2/Lokal (konsol)](deployments-create-console.md)
Untuk petunjuk tentang cara menggunakan peran lintas-akun dan memulai penerapan, lihat [Beralih ke peran IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-cli.html) () dan. AWS CLI AWS Command Line Interface[Membuat penerapan Platform Komputasi EC2/Lokal (CLI)](deployments-create-cli.md)
[Untuk informasi selengkapnya tentang mengasumsikan peran AWS STS, lihat [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)di [Panduan AWS Security Token Service Pengguna](https://docs.aws.amazon.com/STS/latest/APIReference/Welcome.html) dan peran asumsi di [Referensi Perintah](https://docs.aws.amazon.com/cli/latest/reference/sts/assume-role.html).AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/)
**Topik terkait:**
+ [CodeDeploy: Menyebarkan dari akun pengembangan ke akun produksi](https://aws.amazon.com/blogs/devops/aws-codedeploy-deploying-from-a-development-account-to-a-production-account/)
# Gunakan CodeDeploy agen untuk memvalidasi paket penerapan pada mesin lokal
Dengan menggunakan CodeDeploy agen, Anda dapat menyebarkan konten pada instance yang Anda masuki. Ini memungkinkan Anda untuk menguji integritas file spesifikasi aplikasi (AppSpec file) yang ingin Anda gunakan dalam penyebaran dan konten yang ingin Anda gunakan.
Anda tidak perlu membuat grup aplikasi dan penyebaran. Jika Anda ingin menyebarkan konten yang disimpan pada instance lokal, Anda bahkan tidak memerlukan AWS akun. Untuk pengujian yang paling sederhana, Anda dapat menjalankan **codedeploy-local** perintah, tanpa menentukan opsi apa pun, di direktori yang berisi AppSpec file dan konten yang akan digunakan. Ada opsi untuk kasus uji lain di alat ini.
Dengan memvalidasi paket penerapan pada mesin lokal, Anda dapat:
+ Uji integritas revisi aplikasi.
+ Uji isi AppSpec file.
+ Cobalah CodeDeploy untuk pertama kalinya dengan kode aplikasi yang ada.
+ Terapkan konten dengan cepat saat Anda sudah masuk ke sebuah instans.
Anda dapat menggunakan konten deploy yang disimpan di instans lokal atau dalam jenis repositori jarak jauh yang didukung (bucket Amazon S3 atau repositori publik). GitHub
## Prasyarat
Sebelum memulai penerapan lokal, selesaikan langkah-langkah berikut:
+ Buat atau gunakan jenis instance yang didukung oleh CodeDeploy agen. Untuk informasi, lihat [Sistem operasi yang didukung oleh CodeDeploy agen](codedeploy-agent.md#codedeploy-agent-supported-operating-systems).
+ Instal versi 1.0.1.1352 atau yang lebih baru dari agen. CodeDeploy Untuk informasi, lihat [Instal CodeDeploy agen](codedeploy-agent-operations-install.md).
+ Jika Anda menerapkan konten dari bucket GitHub atau repositori Amazon S3, sediakan pengguna untuk digunakan. CodeDeploy Untuk informasi, lihat [Langkah 1: Menyiapkan](getting-started-setting-up.md).
+ Jika Anda menerapkan revisi aplikasi dari bucket Amazon S3, buat bucket Amazon S3 di wilayah tempat Anda bekerja dan terapkan kebijakan bucket Amazon S3 ke bucket. Kebijakan ini memberi instans Anda izin yang diperlukan untuk mengunduh revisi aplikasi.
Misalnya, kebijakan bucket Amazon S3 berikut ini memungkinkan instans Amazon EC2 dengan profil instans IAM terlampir yang berisi `arn:aws:iam::444455556666:role/CodeDeployDemo` ARN untuk diunduh dari mana saja di bucket Amazon S3 bernama: `amzn-s3-demo-bucket`
```
{
"Statement": [
{
"Action": [
"s3:Get*",
"s3:List*"
],
"Effect": "Allow",
"Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*",
"Principal": {
"AWS": [
"arn:aws:iam::444455556666:role/CodeDeployDemo"
]
}
}
]
}
```
Kebijakan bucket Amazon S3 berikut memungkinkan instans lokal dengan pengguna IAM terkait yang berisi ARN `arn:aws:iam::444455556666:user/CodeDeployUser` dapat diunduh dari mana saja di bucket Amazon S3 yang diberi nama: `amzn-s3-demo-bucket`
```
{
"Statement": [
{
"Action": [
"s3:Get*",
"s3:List*"
],
"Effect": "Allow",
"Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*",
"Principal": {
"AWS": [
"arn:aws:iam::444455556666:user/CodeDeployUser"
]
}
}
]
}
```
Untuk informasi tentang cara membuat dan melampirkan kebijakan bucket Amazon S3, lihat contoh [kebijakan Bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html).
+ Jika Anda menerapkan revisi aplikasi dari bucket GitHub atau repositori Amazon S3, siapkan profil instans IAM dan lampirkan ke instance. Untuk informasi, lihat[Langkah 4: Buat profil instans IAM untuk instans Amazon EC2 Anda](getting-started-create-iam-instance-profile.md),[Membuat instans Amazon EC2 untuk CodeDeploy (AWS CLI atau konsol Amazon EC2)](instances-ec2-create.md), dan[Buat instans Amazon EC2 untuk CodeDeploy (template)CloudFormation](instances-ec2-create-cloudformation-template.md).
+ Jika Anda menyebarkan konten Anda dari GitHub, buat GitHub akun dan repositori publik. Untuk membuat GitHub akun, lihat [Bergabung GitHub](https://github.com/join). Untuk membuat GitHub repositori, lihat [Membuat repo](https://help.github.com/articles/create-a-repo/).
**catatan**
Repositori pribadi saat ini tidak didukung. Jika konten Anda disimpan dalam GitHub repositori pribadi, Anda dapat mengunduhnya ke instance dan menggunakan `--bundle-location` opsi untuk menentukan jalur lokalnya.
+ Siapkan konten (termasuk AppSpec file) yang ingin Anda terapkan ke instance dan letakkan di instans lokal, di bucket Amazon S3, atau di GitHub repositori Anda. Untuk informasi, lihat [Bekerja dengan revisi aplikasi untuk CodeDeploy](application-revisions.md).
+ Jika Anda ingin menggunakan nilai selain default untuk opsi konfigurasi lainnya, buat file konfigurasi dan letakkan di instance (untuk instance `/etc/codedeploy-agent/conf/codedeployagent.yml` Amazon Linux, RHEL, atau Ubuntu Server atau `C:\ProgramData\Amazon\CodeDeploy\conf.yml` untuk instance Windows Server). Untuk informasi, lihat [CodeDeploy referensi konfigurasi agen](reference-agent-configuration.md).
**catatan**
Jika Anda menggunakan file konfigurasi di Amazon Linux, RHEL, atau instance Server Ubuntu, Anda harus:
Gunakan `:log_dir:` variabel `:root_dir:` dan untuk menentukan lokasi selain default untuk folder direktori root dan log deployment.
Gunakan `sudo` untuk menjalankan perintah CodeDeploy agen.
## Buat penerapan lokal
Pada contoh di mana Anda ingin membuat penyebaran lokal, buka sesi terminal (Amazon Linux, RHEL, atau contoh Server Ubuntu) atau prompt perintah (Windows Server) untuk menjalankan perintah alat.
**catatan**
**codedeploy-local**Perintah diinstal di lokasi berikut:
Di Amazon Linux, RHEL, atau Server Ubuntu:`/opt/codedeploy-agent/bin`.
Di Windows Server:`C:\ProgramData\Amazon\CodeDeploy\bin`.
**Sintaks Perintah Dasar**
```
codedeploy-local [options]
```
**Sinopsis**
```
codedeploy-local
[--bundle-location ]
[--type ]
[--file-exists-behavior ]
[--deployment-group ]
[--events ]
[--agent-configuration-file ]
[--appspec-filename ]
```
**Pilihan**
**-l****, --bundle-lokasi**
Lokasi bundel revisi aplikasi. Jika Anda tidak menentukan lokasi, alat menggunakan direktori yang sedang Anda kerjakan secara default. Jika Anda menentukan `--bundle-location`, maka Anda juga harus menentukan nilai `--type`.
Contoh format lokasi bundel:
+ Instans Amazon Linux, RHEL, atau Server Ubuntu lokal: `/path/to/local/bundle.tgz`
+ Contoh Windows Server lokal: `C:/path/to/local/bundle`
+ Ember Amazon S3: `s3://amzn-s3-demo-bucket/bundle.tar`
+ GitHub repositori: `https://github.com/account-name/repository-name/`
**-t****, --tipe**
Format bundel revisi aplikasi. Jenis yang didukung meliputi`tgz`,`tar`,`zip`, dan`directory`. Jika Anda tidak menentukan jenis, alat ini menggunakan secara `directory` default. Jika Anda menentukan `--type`, maka Anda juga harus menentukan nilai `--bundle-location`.
**-b**, **-- file-exists-behavior**
Menunjukkan bagaimana file ditangani yang sudah ada di lokasi target penerapan tetapi bukan bagian dari penerapan yang berhasil sebelumnya. Opsi termasuk DISALLOW, OVERWRITE, RESTAIN. Untuk informasi selengkapnya, lihat [fileExistsBehavior](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_CreateDeployment.html#CodeDeploy-CreateDeployment-request-fileExistsBehavior)di *[Referensi AWS CodeDeploy API](https://docs.aws.amazon.com/codedeploy/latest/APIReference/)*.
**-g****, --deployment-group**
Jalur ke folder yang merupakan lokasi target untuk konten yang akan digunakan. Jika Anda tidak menentukan folder, alat akan membuat satu bernama *default-local-deployment-group*di dalam direktori root deployment Anda. *Untuk setiap penyebaran lokal yang Anda buat, alat ini membuat subdirektori di dalam folder ini dengan nama seperti d-98761234-local.*
**-e****, --event**
Satu set kait peristiwa siklus hidup timpa yang ingin Anda jalankan, secara berurutan, bukan peristiwa yang Anda cantumkan dalam file. AppSpec Beberapa kait dapat ditentukan, dipisahkan dengan koma. Anda dapat menggunakan opsi ini jika:
+ Anda ingin menjalankan serangkaian acara yang berbeda tanpa harus memperbarui AppSpec file.
+ Anda ingin menjalankan satu event hook sebagai pengecualian untuk apa yang ada di AppSpec file, seperti`ApplicationStop`.
Jika Anda tidak menentukan **DownloadBundle**dan **Menginstal** peristiwa dalam daftar penggantian, mereka akan berjalan sebelum semua kait acara yang Anda tentukan. Jika Anda menyertakan **DownloadBundle**dan **Menginstal** dalam daftar `--events` opsi, mereka harus didahului hanya oleh peristiwa yang biasanya berjalan sebelum mereka dalam CodeDeploy penerapan. Untuk informasi, lihat [AppSpec Bagian 'kait'](reference-appspec-file-structure-hooks.md).
**-c**, **-- agent-configuration-file**
Lokasi file konfigurasi yang akan digunakan untuk penyebaran, jika Anda menyimpannya di lokasi selain default. File konfigurasi menentukan alternatif untuk nilai dan perilaku default lainnya untuk penerapan.
Secara default, file konfigurasi disimpan di `/etc/codedeploy-agent/conf/codedeployagent.yml` (Amazon Linux, RHEL, atau contoh Server Ubuntu) atau `C:/ProgramData/Amazon/CodeDeploy/conf.yml` (Windows Server). Untuk informasi selengkapnya, lihat [CodeDeploy referensi konfigurasi agen](reference-agent-configuration.md).
**-A****, --appspec-nama file**
Nama AppSpec file. Untuk penerapan lokal, nilai yang diterima adalah `appspec.yml` dan. `appspec.yaml` Secara default, AppSpec file tersebut dipanggil`appspec.yml`.
**-h****, --membantu**
Menampilkan ringkasan konten bantuan.
**-v****, --versi**
Menampilkan nomor versi alat.
## Contoh
Berikut ini adalah contoh format perintah yang valid.
```
codedeploy-local
```
```
codedeploy-local --bundle-location /path/to/local/bundle/directory
```
```
codedeploy-local --bundle-location C:/path/to/local/bundle.zip --type zip --deployment-group my-deployment-group
```
```
codedeploy-local --bundle-location /path/to/local/directory --type directory --deployment-group my-deployment-group
```
Terapkan bundel dari Amazon S3:
```
codedeploy-local --bundle-location s3://amzn-s3-demo-bucket/bundle.tgz --type tgz
```
```
codedeploy-local --bundle-location s3://amzn-s3-demo-bucket/bundle.zip?versionId=1234&etag=47e8 --type zip --deployment-group my-deployment-group
```
Menyebarkan bundel dari GitHub repositori publik:
```
codedeploy-local --bundle-location https://github.com/awslabs/aws-codedeploy-sample-tomcat --type zip
```
```
codedeploy-local --bundle-location https://api.github.com/repos/awslabs/aws-codedeploy-sample-tomcat/zipball/master --type zip
```
```
codedeploy-local --bundle-location https://api.github.com/repos/awslabs/aws-codedeploy-sample-tomcat/zipball/HEAD --type zip
```
```
codedeploy-local --bundle-location https://api.github.com/repos/awslabs/aws-codedeploy-sample-tomcat/zipball/1a2b3c4d --type zip
```
Terapkan bundel yang menentukan beberapa peristiwa siklus hidup:
```
codedeploy-local --bundle-location /path/to/local/bundle.tar --type tar --application-folder my-deployment --events DownloadBundle,Install,ApplicationStart,HealthCheck
```
Menghentikan aplikasi yang digunakan sebelumnya menggunakan peristiwa ApplicationStop siklus hidup:
```
codedeploy-local --bundle-location /path/to/local/bundle.tgz --type tgz --deployment-group --events ApplicationStop
```
Terapkan menggunakan ID grup penerapan tertentu:
```
codedeploy-local --bundle-location C:/path/to/local/bundle/directory --deployment-group 1234abcd-5dd1-4774-89c6-30b107ac5dca
```
```
codedeploy-local --bundle-location C:/path/to/local/bundle.zip --type zip --deployment-group 1234abcd-5dd1-4774-89c6-30b107ac5dca
```