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.
# Menyebarkan ke dalam Akun AWS dan VPCs
Dengan menggunakan [CodeCatalyst alur kerja](workflow.md), Anda dapat menerapkan aplikasi dan sumber daya lain untuk menargetkan Akun AWS s dan Amazon VPCs di AWS cloud. Untuk mengaktifkan penerapan ini, Anda harus mengatur CodeCatalyst lingkungan.
CodeCatalyst *Lingkungan*[, jangan dikelirukan dengan [Lingkungan Pengembang](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment.html), mendefinisikan target Akun AWS dan VPC Amazon opsional yang terhubung dengan CodeCatalyst alur kerja.](workflow.md) Lingkungan juga mendefinisikan [peran IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) yang dibutuhkan alur kerja untuk mengakses AWS layanan dan sumber daya dalam akun target.
Anda dapat menyiapkan beberapa lingkungan dan memberinya nama seperti pengembangan, pengujian, penahapan, dan produksi. Saat Anda menerapkan ke lingkungan ini, informasi tentang penerapan akan muncul di tab **aktivitas CodeCatalyst Deployment** dan **target Deployment** di lingkungan.
## Bagaimana cara memulai dengan lingkungan?
Langkah-langkah tingkat tinggi untuk menambah dan menggunakan CodeCatalyst lingkungan adalah sebagai berikut:
1. Di CodeCatalyst ruang Anda, **hubungkan satu atau beberapa AWS akun**. Selama proses ini, tambahkan peran IAM yang diperlukan alur kerja Anda untuk mengakses sumber daya di Anda. Akun AWS Untuk informasi selengkapnya, lihat [Memungkinkan akses ke AWS sumber daya yang terhubung Akun AWS](ipa-connect-account.md).
1. Dalam CodeCatalyst proyek Anda, **buat lingkungan** yang mencakup salah satu peran Akun AWS s dan IAM dari langkah 1. Untuk informasi selengkapnya, lihat [Pembuatan lingkungan](deploy-environments-creating-environment.md).
1. Dalam CodeCatalyst proyek Anda, dalam alur kerja, **tambahkan [tindakan](workflows-actions.md) yang menunjuk ke lingkungan yang** Anda buat di langkah 2. Untuk informasi selengkapnya, lihat [Menambahkan tindakan ke alur kerja](workflows-add-action.md).
Anda sekarang telah mengkonfigurasi lingkungan. Tindakan sekarang dapat menyebarkan sumber daya ke dalam yang Akun AWS ditentukan di lingkungan.
**catatan**
Anda juga dapat menambahkan VPC Amazon ke lingkungan. Untuk informasi selengkapnya, lihat [Menambahkan koneksi VPC untuk spasi](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-vpcs.add.html) di *Panduan CodeCatalyst Administrasi* dan. [Mengaitkan VPC dengan lingkungan](deploy-environments-associate-vpc.md)
## Dapatkah beberapa lingkungan ada dalam satu alur kerja?
Ya. Jika alur kerja menyertakan beberapa tindakan, setiap tindakan tersebut dapat ditetapkan suatu lingkungan. Misalnya, Anda dapat memiliki alur kerja yang menyertakan dua tindakan penerapan, di mana satu ditetapkan `my-staging-enviroment` lingkungan dan yang lain ditetapkan lingkungan. `my-production-environment`
## Tindakan alur kerja mana yang mendukung lingkungan?
Setiap tindakan alur kerja yang menyebarkan sumber daya ke AWS cloud, atau berkomunikasi dengan AWS layanan karena alasan lain (seperti pemantauan dan pelaporan), mendukung lingkungan.
## Tindakan mana yang mendukung agar informasi penerapannya ditampilkan? CodeCatalyst
Dari tindakan alur kerja yang mendukung lingkungan, hanya sedikit yang mendukung agar informasi penerapannya ditampilkan di halaman **aktivitas Deployment** dan **target Deployment** di konsol. CodeCatalyst
Tindakan alur kerja berikut mendukung agar informasi penerapannya ditampilkan:
+ **Menyebarkan CloudFormation tumpukan** - Untuk informasi selengkapnya, lihat [Menyebarkan tumpukan CloudFormation](deploy-action-cfn.md)
+ **Menyebarkan ke Amazon ECS** - Untuk informasi selengkapnya, lihat [Menyebarkan ke Amazon ECS dengan alur kerja](deploy-action-ecs.md)
+ **Terapkan ke klaster Kubernetes** — Untuk informasi selengkapnya, lihat [Menerapkan ke Amazon EKS dengan alur kerja](deploy-action-eks.md)
+ **AWS CDK deploy** — Untuk informasi selengkapnya, lihat [Menerapkan AWS CDK aplikasi dengan alur kerja](cdk-dep-action.md)
## Wilayah yang Didukung
Halaman **Lingkungan** dapat menampilkan sumber daya di AWS Wilayah mana pun.
## Apakah lingkungan wajib?
Lingkungan adalah wajib jika tindakan alur kerja yang ditugaskan menyebarkan sumber daya ke AWS cloud, atau berkomunikasi dengan AWS layanan karena alasan lain (seperti pemantauan dan pelaporan).
Misalnya, jika Anda memiliki tindakan build yang membangun aplikasi tetapi tidak perlu berkomunikasi dengan VPC Anda Akun AWS atau Amazon, maka Anda tidak perlu menetapkan lingkungan untuk tindakan tersebut. Namun, jika tindakan build mengirimkan log ke CloudWatch layanan Amazon di Anda Akun AWS, maka tindakan tersebut harus memiliki lingkungan yang ditetapkan.
**Topics**
+ [Bagaimana cara memulai dengan lingkungan?](#deploy-environments-get-started)
+ [Dapatkah beberapa lingkungan ada dalam satu alur kerja?](#deploy-environments-multiple)
+ [Tindakan alur kerja mana yang mendukung lingkungan?](#deploy-environments-supported)
+ [Tindakan mana yang mendukung agar informasi penerapannya ditampilkan? CodeCatalyst](#deploy-environments-supported-targets)
+ [Wilayah yang Didukung](#deploy-environments-supported-regions)
+ [Apakah lingkungan wajib?](#deploy-environments-optional-or-mandatory)
+ [Pembuatan lingkungan](deploy-environments-creating-environment.md)
+ [Mengaitkan lingkungan dengan tindakan](deploy-environments-add-app-to-environment.md)
+ [Mengaitkan VPC dengan lingkungan](deploy-environments-associate-vpc.md)
+ [Mengaitkan Akun AWS dengan lingkungan](deploy-environments-associate-account.md)
+ [Mengubah peran IAM dari suatu tindakan](deploy-environments-switch-role.md)
# Pembuatan lingkungan
Gunakan petunjuk berikut untuk membuat lingkungan yang nantinya dapat Anda kaitkan dengan tindakan alur kerja.
**Sebelum Anda mulai**
Anda membutuhkan yang berikut ini:
+ Sebuah CodeCatalyst ruang. Untuk informasi selengkapnya, lihat [Siapkan dan masuk ke CodeCatalystSiapkan dan masuk ke CodeCatalyst](setting-up-topnode.md).
+ Sebuah CodeCatalyst proyek. Untuk informasi selengkapnya, lihat [Membuat proyek dengan cetak biru](projects-create.md#projects-create-console-template).
+ Koneksi AWS akun yang menyertakan peran IAM yang perlu diakses oleh tindakan alur kerja Anda. AWS Untuk informasi tentang membuat koneksi akun, lihat[Memungkinkan akses ke AWS sumber daya yang terhubung Akun AWS](ipa-connect-account.md). Anda dapat menggunakan maksimal satu koneksi akun per lingkungan.
**catatan**
Anda dapat membuat lingkungan tanpa koneksi akun; Namun, Anda harus kembali dan menambahkan koneksi nanti.
+ Salah satu CodeCatalyst peran berikut:
+ **Administrator ruang**
+ **Administrator proyek**
+ **Kontributor**
**catatan**
Jika Anda memiliki **peran Kontributor**, Anda akan dapat membuat lingkungan tetapi Anda tidak akan dapat mengaitkannya dengan Akun AWS koneksi. Anda harus meminta seseorang dengan **administrator Space** atau peran **administrator Proyek** untuk mengaitkan lingkungan dengan Akun AWS koneksi.
Untuk informasi selengkapnya tentang izin dan peran, lihat[Memberikan izin proyek kepada pengguna](projects-members.md).
**Untuk membuat lingkungan**
1. Buka CodeCatalyst konsol di [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Pilih proyek Anda.
1. **Di panel navigasi, pilih **CI/CD**, lalu pilih Lingkungan.**
1. Dalam **nama Lingkungan**, masukkan nama, seperti **Production** atau**Staging**.
1. Dalam **jenis Lingkungan**, pilih salah satu dari berikut ini:
+ **Non-produksi** — Lingkungan di mana Anda dapat menguji aplikasi Anda untuk memastikannya berfungsi sebagaimana dimaksud sebelum memindahkannya ke produksi.
+ **Produksi** - Lingkungan 'langsung' yang tersedia untuk umum dan menjadi tuan rumah aplikasi akhir Anda.
Jika Anda memilih **Produksi**, lencana **Produksi** akan muncul di UI di samping tindakan apa pun yang terkait dengan lingkungan. Lencana membantu Anda melihat dengan cepat tindakan mana yang di-deploy ke produksi. Selain penampilan lencana, tidak ada perbedaan antara lingkungan produksi dan non-produksi.
1. (Opsional) Dalam **Deskripsi**, masukkan deskripsi seperti**Production environment for the hello-world app**.
1. **Akun AWS Sehubungan - opsional**, pilih koneksi AWS akun yang ingin Anda kaitkan dengan lingkungan ini. Tindakan alur kerja yang ditetapkan lingkungan ini akan dapat terhubung ke yang terkait Akun AWS. Untuk informasi selengkapnya tentang membuat Akun AWS koneksi di CodeCatalyst, lihat[Memungkinkan akses ke AWS sumber daya yang terhubung Akun AWS](ipa-connect-account.md).
Jika Akun AWS koneksi yang ingin Anda gunakan tidak terdaftar, itu mungkin karena tidak diizinkan dalam proyek Anda. *Untuk informasi selengkapnya, lihat [Mengonfigurasi koneksi akun yang dibatasi proyek di Panduan Administrator](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-accounts-restriction.html) Amazon. CodeCatalyst *
1. Dalam **peran IAM Default**, pilih peran IAM yang ingin Anda kaitkan dengan lingkungan ini. Tindakan alur kerja yang ditetapkan lingkungan ini akan mewarisi peran IAM ini, dan akan dapat menggunakannya untuk terhubung ke layanan dan sumber daya di Anda. Akun AWS
Jika Anda perlu menetapkan lingkungan ke beberapa tindakan, dan tindakan tersebut memerlukan peran IAM yang berbeda dari peran default yang ditentukan di sini, maka Anda dapat menentukan peran yang berbeda pada tab **Konfigurasi** setiap tindakan, menggunakan opsi **Beralih peran**. Untuk informasi selengkapnya, lihat [Mengubah peran IAM dari suatu tindakan](deploy-environments-switch-role.md).
Jika peran IAM yang ingin Anda gunakan sebagai default tidak terdaftar, mungkin karena Anda belum menambahkannya ke Akun AWS koneksi Anda. Untuk menambahkan peran IAM ke koneksi akun, lihat[Menambahkan peran IAM ke koneksi akun](ipa-connect-account-addroles.md).
1. (Opsional) Dalam koneksi **VPC, pilih koneksi** VPC yang ingin Anda kaitkan dengan lingkungan ini. Untuk informasi selengkapnya tentang membuat koneksi VPC, lihat Mengelola [Awan Pribadi Virtual Amazon](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-vpcs.html) di Panduan * CodeCatalyst Administrator Amazon*.
Jika koneksi VPC yang ingin Anda gunakan tidak terdaftar, mungkin karena koneksi VPC menyertakan Akun AWS koneksi yang tidak diizinkan dalam proyek Anda. *Untuk informasi selengkapnya, lihat [Mengonfigurasi koneksi akun yang dibatasi proyek di Panduan Administrator](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-accounts-restriction.html) Amazon. CodeCatalyst *
1. Pilih **Buat lingkungan**. CodeCatalyst menciptakan lingkungan yang kosong.
**Langkah selanjutnya**
+ Sekarang Anda telah menciptakan lingkungan, Anda siap untuk mengaitkannya dengan tindakan alur kerja. Lihat informasi yang lebih lengkap di [Mengaitkan lingkungan dengan tindakan](deploy-environments-add-app-to-environment.md).
# Mengaitkan lingkungan dengan tindakan
Saat Anda mengaitkan lingkungan dengan [tindakan alur kerja yang didukung](deploy-environments.md#deploy-environments-supported), peran IAM default lingkungan Akun AWS, dan VPC Amazon opsional akan ditetapkan ke tindakan tersebut. Tindakan kemudian dapat terhubung dan menyebarkan ke Akun AWS menggunakan peran IAM, dan juga terhubung ke Amazon VPC opsional.
Gunakan instruksi berikut untuk mengaitkan lingkungan dengan tindakan.
## Langkah 1: Kaitkan lingkungan dengan tindakan alur kerja
Gunakan prosedur berikut untuk mengaitkan lingkungan dengan tindakan alur kerja.
------
#### [ Visual ]
**Untuk mengaitkan lingkungan dengan tindakan alur kerja menggunakan 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. Pilih **Visual**.
1. Dalam diagram alur kerja, pilih tindakan yang didukung dengan lingkungan. Untuk informasi selengkapnya, lihat [Tindakan mana yang mendukung agar informasi penerapannya ditampilkan? CodeCatalyst](deploy-environments.md#deploy-environments-supported-targets).
1. Pilih tab **Konfigurasi**, dan tentukan informasi di bidang **Lingkungan**, sebagai berikut.
**Lingkungan**
Tentukan CodeCatalyst lingkungan yang akan digunakan dengan tindakan. Tindakan terhubung ke Akun AWS dan VPC Amazon opsional yang ditentukan di lingkungan yang dipilih. Tindakan ini menggunakan peran IAM default yang ditentukan di lingkungan untuk terhubung ke Akun AWS, dan menggunakan peran IAM yang ditentukan dalam [koneksi VPC Amazon untuk terhubung ke VPC](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-vpcs.add.html) Amazon.
**catatan**
Jika peran IAM default tidak memiliki izin yang diperlukan oleh tindakan, Anda dapat mengonfigurasi tindakan untuk menggunakan peran yang berbeda. Untuk informasi selengkapnya, lihat [Mengubah peran IAM dari suatu tindakan](deploy-environments-switch-role.md).
Untuk informasi lebih lanjut tentang lingkungan, lihat [Menyebarkan ke dalam Akun AWS dan VPCs](deploy-environments.md) dan[Pembuatan lingkungan](deploy-environments-creating-environment.md).
1. (Opsional) Ubah peran IAM yang terkait dengan tindakan. Anda mungkin ingin mengubah peran jika berisi kumpulan izin yang salah untuk tindakan tersebut.
Untuk mengubah peran:
1. Dalam **Apa yang ada di*my-environment*?** kotak, dan pilih ikon elipsis vertikal ()![\[Ellipsis.\]](http://docs.aws.amazon.com/id_id/codecatalyst/latest/userguide/images/flows/elipsis.png).
1. Pilih salah satu cara berikut:
+ **Beralih peran**. Pilih opsi ini untuk mengubah peran IAM yang digunakan oleh tindakan ini, dan hanya tindakan ini. Tindakan lain terus menggunakan peran IAM default yang ditentukan dalam lingkungan terkait. Untuk informasi selengkapnya, lihat [Mengubah peran IAM dari suatu tindakan](deploy-environments-switch-role.md).
+ **Edit lingkungan**. Pilih opsi ini untuk mengubah peran IAM default yang tercantum di lingkungan Anda. Bila Anda memilih opsi ini, tindakan Anda—dan tindakan lain yang terkait dengan lingkungan yang sama—mulai menggunakan peran IAM default yang baru.
**penting**
Berhati-hatilah saat memperbarui peran IAM default. Mengubah peran dapat menyebabkan kegagalan tindakan jika izin dalam peran tidak cukup untuk semua tindakan yang berbagi lingkungan.
1. (Opsional) Pilih **Validasi** untuk memvalidasi kode YAMAL alur kerja sebelum melakukan.
1. Pilih **Komit**, masukkan pesan komit, dan pilih **Komit** lagi.
------
#### [ YAML ]
**Untuk mengaitkan lingkungan dengan tindakan alur kerja menggunakan editor YAMAL**
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. Dalam tindakan alur kerja yang ingin Anda kaitkan dengan lingkungan, tambahkan kode yang mirip dengan berikut ini:
```
action-name:
Environment:
Name: environment-name
```
Untuk informasi lebih lanjut, lihat [Jenis tindakan](workflows-actions.md#workflows-actions-types) topiknya. Topik ini memiliki tautan ke dalam dokumentasi untuk setiap tindakan, termasuk referensi YAML-nya.
1. (Opsional) Jika Anda ingin tindakan menggunakan peran yang berbeda dari peran IAM default yang tercantum di lingkungan, tambahkan `Connections:` bagian yang menyertakan peran yang ingin Anda gunakan. Untuk informasi selengkapnya, lihat [Mengubah peran IAM dari suatu tindakan](deploy-environments-switch-role.md).
1. (Opsional) Pilih **Validasi** untuk memvalidasi kode YAMAL alur kerja sebelum melakukan.
1. Pilih **Komit**, masukkan pesan komit, dan pilih **Komit** lagi.
------
## Langkah 2: Isi halaman aktivitas penerapan
Setelah mengaitkan lingkungan dengan tindakan alur kerja, Anda dapat mengisi halaman **target **aktivitas Deployment** dan Deployment** di bagian **Lingkungan** konsol dengan informasi penerapan. CodeCatalyst Gunakan petunjuk berikut untuk mengisi halaman ini.
**catatan**
Hanya beberapa tindakan yang mendukung agar informasi penerapannya ditampilkan di CodeCatalyst konsol. Untuk informasi selengkapnya, lihat [Tindakan mana yang mendukung agar informasi penerapannya ditampilkan? CodeCatalyst](deploy-environments.md#deploy-environments-supported-targets).
**Untuk menambahkan informasi penyebaran ke CodeCatalyst**
1. Jika alur kerja tidak dimulai secara otomatis saat Anda melakukan perubahan[Langkah 1: Kaitkan lingkungan dengan tindakan alur kerja](#deploy-environments-add-app-to-environment-assoc), mulailah menjalankan secara manual sebagai berikut:
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 **Jalankan**.
Proses alur kerja memulai penerapan baru, yang CodeCatalyst menyebabkan penambahan informasi penerapan. CodeCatalyst
1. Verifikasi bahwa aktivitas penerapan telah ditambahkan ke CodeCatalyst konsol:
1. **Di panel navigasi, pilih **CI/CD**, lalu pilih Lingkungan.**
1. Pilih lingkungan Anda (misalnya,`Production`).
1. **Pilih tab **aktivitas Deployment**, dan verifikasi bahwa penerapan muncul dengan **Status** SUCCEEDED.** Ini menunjukkan bahwa alur kerja berjalan berhasil menyebarkan sumber daya aplikasi Anda.
1. Pilih tab **Target Deployment**, dan verifikasi apakah resource aplikasi Anda muncul.
# Mengaitkan VPC dengan lingkungan
Ketika suatu tindakan dikonfigurasi dengan lingkungan yang memiliki koneksi VPC, tindakan akan berjalan terhubung ke VPC, mengikuti aturan jaringan dan mengakses sumber daya yang ditentukan oleh VPC terkait. Koneksi VPC yang sama dapat digunakan oleh satu atau lebih lingkungan.
Gunakan petunjuk berikut untuk mengaitkan koneksi VPC dengan lingkungan.
**Untuk mengaitkan koneksi VPC dengan lingkungan**
1. Buka CodeCatalyst konsol di [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Pilih proyek Anda.
1. **Di panel navigasi, pilih **CI/CD**, lalu pilih Lingkungan.**
1. Pilih lingkungan Anda (misalnya,`Production`).
1. Pilih tab **Properti Lingkungan**.
1. **Pilih **Kelola koneksi VPC, pilih koneksi** VPC yang Anda inginkan, dan pilih Konfirmasi.** Ini mengaitkan koneksi VPC pilihan Anda dengan lingkungan ini.
**catatan**
Jika koneksi VPC yang ingin Anda gunakan tidak terdaftar, mungkin karena koneksi VPC menyertakan Akun AWS koneksi yang tidak diizinkan dalam proyek Anda. *Untuk informasi selengkapnya, lihat [Mengonfigurasi koneksi akun yang dibatasi proyek di Panduan Administrator](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-accounts-restriction.html) Amazon. CodeCatalyst*
Untuk informasi selengkapnya, lihat [Mengelola Awan Pribadi Virtual Amazon](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-vpcs.html) di *Panduan CodeCatalyst Administrator*.
# Mengaitkan Akun AWS dengan lingkungan
Gunakan instruksi berikut untuk mengaitkan Akun AWS dengan lingkungan. Ketika Anda mengaitkan Akun AWS dengan lingkungan, tindakan alur kerja yang ditetapkan lingkungan akan dapat terhubung ke Akun AWS.
Untuk informasi selengkapnya tentang koneksi akun, lihat[Memungkinkan akses ke AWS sumber daya yang terhubung Akun AWS](ipa-connect-account.md).
**Sebelum Anda mulai**
Anda membutuhkan yang berikut ini:
+ Sambungan AWS akun yang menyertakan peran IAM yang perlu diakses oleh tindakan alur kerja Anda. AWS Untuk informasi tentang membuat koneksi akun, lihat[Memungkinkan akses ke AWS sumber daya yang terhubung Akun AWS](ipa-connect-account.md). Anda dapat menggunakan maksimal satu koneksi akun per lingkungan.
+ Salah satu CodeCatalyst peran berikut: **Administrator ruang** atau **administrator Proyek**. Untuk informasi selengkapnya, lihat [Memberikan izin proyek kepada pengguna](projects-members.md).
**Untuk mengasosiasikan Akun AWS dengan lingkungan**
1. Buka CodeCatalyst konsol di [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Pilih proyek Anda.
1. **Di panel navigasi, pilih **CI/CD**, lalu pilih Lingkungan.**
1. Pilih lingkungan Anda (misalnya,`Production`).
1. Pilih **Edit lingkungan**.
1. Di bawah **properti Lingkungan**, dalam **Akun AWS koneksi - daftar drop-down opsional**, pilih yang Anda inginkan Akun AWS.
Jika Akun AWS koneksi yang ingin Anda gunakan tidak terdaftar, itu mungkin karena tidak diizinkan dalam proyek Anda. *Untuk informasi selengkapnya, lihat [Mengonfigurasi koneksi akun yang dibatasi proyek di Panduan Administrator](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-accounts-restriction.html) Amazon. CodeCatalyst *
1. Dalam peran **IAM default, pilih peran** IAM yang ingin Anda kaitkan dengan lingkungan ini. Tindakan alur kerja yang ditetapkan lingkungan ini akan mewarisi peran IAM ini, dan akan dapat menggunakannya untuk terhubung ke layanan dan sumber daya di Anda. Akun AWS
Jika peran IAM yang ingin Anda gunakan sebagai default tidak terdaftar, mungkin karena Anda belum menambahkannya ke Akun AWS koneksi Anda. Untuk menambahkan peran IAM ke koneksi akun, lihat[Menambahkan peran IAM ke koneksi akun](ipa-connect-account-addroles.md).
# Mengubah peran IAM dari suatu tindakan
Secara default, saat Anda mengaitkan [lingkungan](deploy-environments.md) dengan [tindakan alur kerja, tindakan](workflows-actions.md) tersebut mewarisi peran IAM default yang ditentukan dalam lingkungan. Anda dapat mengubah perilaku ini sehingga tindakan menggunakan peran yang berbeda. Anda mungkin ingin tindakan menggunakan peran yang berbeda jika peran IAM default tidak memiliki izin yang diperlukan tindakan untuk beroperasi di AWS cloud.
Untuk menetapkan peran IAM yang berbeda ke tindakan, Anda dapat menggunakan opsi **Beralih peran** di editor visual atau `Connections:` properti di editor YAMAL. Peran baru mengganti peran IAM default yang ditentukan di lingkungan, memungkinkan Anda mempertahankan peran IAM default apa adanya. Anda mungkin ingin mempertahankan peran IAM default apa adanya jika ada tindakan lain yang menggunakannya.
Gunakan petunjuk berikut untuk mengonfigurasi tindakan agar menggunakan peran IAM yang berbeda dari peran yang ditentukan di lingkungannya.
------
#### [ Visual ]
**Untuk menetapkan peran IAM yang berbeda ke tindakan (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. Pilih kotak yang mewakili tindakan yang peran IAM yang ingin Anda perbarui.
1. Pilih tab **Konfigurasi**.
1. Dalam **Apa yang ada di*my-environment*?** kotak, pilih ikon elipsis vertikal ()![\[Ellipsis.\]](http://docs.aws.amazon.com/id_id/codecatalyst/latest/userguide/images/flows/elipsis.png).
1. Pilih **Beralih peran**.
1. Di kotak dialog **Beralih peran**, dalam daftar drop-down **peran IAM**, pilih peran IAM yang ingin digunakan tindakan. Peran ini akan mengganti peran IAM default di lingkungan. Jika peran yang ingin Anda gunakan tidak ada dalam daftar, pastikan Anda telah menambahkannya ke ruang Anda. Untuk informasi selengkapnya, lihat [Menambahkan peran IAM ke koneksi akun](ipa-connect-account-addroles.md).
Peran yang dipilih sekarang muncul di **What's in*my-environment*?** kotak bersama dengan lencana **Didefined in workflow**. Peran juga muncul di file definisi alur kerja, di `Connections:` bagian.
1. (Opsional) Pilih **Validasi** untuk memvalidasi kode YAMAL alur kerja sebelum melakukan.
1. Pilih **Komit**, masukkan pesan komit, dan pilih **Komit** lagi.
------
#### [ YAML ]
**Untuk menetapkan peran IAM yang berbeda ke tindakan (editor YAMAL)**
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. Dalam tindakan alur kerja di mana Anda ingin menggunakan peran IAM yang berbeda, tambahkan `Connections:` bagian, mirip dengan berikut ini:
```
action-name:
Environment:
Name: environment-name
Connections:
- Name: account-connection-name
Role: iam-role-name
```
Pada kode sebelumnya, ganti *account-connection-name* dengan nama [koneksi akun](ipa-connect-account.md) yang berisi peran IAM, dan ganti *iam-role-name* dengan nama peran IAM yang ingin Anda gunakan. Peran ini akan mengganti peran IAM default di lingkungan. Pastikan Anda telah menambahkan peran ke ruang Anda. Untuk informasi selengkapnya, lihat [Menambahkan peran IAM ke koneksi akun](ipa-connect-account-addroles.md).
Untuk informasi lebih lanjut, lihat [Jenis tindakan](workflows-actions.md#workflows-actions-types) topiknya. Topik ini memiliki tautan ke dalam dokumentasi untuk setiap tindakan, termasuk referensi YAML-nya.
------