Menambahkan Sumber Daya ke Proyek

Setiap AWS CodeStar template untuk semua proyek dilengkapi dengan AWS CloudFormation file yang memodelkan dependensi AWS runtime aplikasi Anda, seperti tabel database dan fungsi Lambda. Ini disimpan di repositori sumber Anda dalam file. /template.yml

catatan

Anda dapat menggunakan langkah-langkah ini untuk proyek-proyek berikut, yang dibuat dengan perubahan dukungan proyek berikut:

• Proyek Lambda apa pun.

• Untuk proyek Amazon EC2 atau Elastic Beanstalk yang dibuat setelah 3 Agustus 2018AWS CodeStar, menyediakan file di repositori proyek. /template.yml

Anda dapat memodifikasi file ini dengan menambahkan AWS CloudFormation sumber daya ke Resources bagian. Memodifikasi template.yml file AWS CloudFormation memungkinkan AWS CodeStar dan menambahkan sumber daya baru ke proyek Anda. Beberapa sumber daya mengharuskan Anda menambahkan izin lain ke kebijakan untuk peran CloudFormation pekerja proyek Anda. Untuk informasi tentang elemen template dan pemformatan, lihat Referensi Jenis AWS Sumber Daya.

Setelah Anda menentukan sumber daya mana yang harus Anda tambahkan ke proyek Anda, ini adalah langkah-langkah tingkat tinggi yang harus diikuti untuk menyesuaikan template. Untuk daftar AWS CloudFormation sumber daya dan properti yang diperlukan, lihat Referensi Jenis AWS Sumber Daya.

1. Langkah 1: Edit Peran CloudFormation Pekerja di IAM(jika perlu)

2. Langkah 2: Memodifikasi Template.ymlFile

3. Langkah 3: Komit dan Dorong Perubahan Template Anda

4. Langkah 4: Pantau Pembaruan AWS CloudFormation Stack

5. Langkah 5: Tambahkan Izin Sumber Daya dengan Kebijakan Inline

Gunakan langkah-langkah di bagian ini untuk memodifikasi template AWS CodeStar proyek Anda untuk menambahkan sumber daya dan kemudian memperluas izin peran CloudFormation pekerja proyek di IAM. Dalam contoh ini, AWS::SQS::Queuesumber daya ditambahkan ke template.yml file. Perubahan memulai respons otomatis AWS CloudFormation yang menambahkan antrean Amazon Simple Queue Service ke project Anda.

Langkah 1: Edit Peran CloudFormation Pekerja di IAM

Anda harus masuk sebagai administrator untuk melakukan langkah 1 dan 5.

catatan

Anda dapat melewati langkah ini jika proyek Anda telah disediakan dengan kebijakan batas izin.

Untuk proyek yang dibuat setelah 6 Desember 2018 PDT, AWS CodeStar berikan proyek Anda dengan kebijakan batas izin.

1. Masuk ke AWS Management Console dan buka AWS CodeStar konsol, di https://console.aws.amazon.com/codestar/.

2. Buat proyek atau pilih proyek yang sudah ada dengantemplate.yml file, lalu buka halaman Sumber daya proyek.

3. Di bawah Sumber Daya Proyek, temukan peran IAM yang dibuat untuk AWS CloudFormation peran CodeStarWorker/dalam daftar sumber daya. Nama peran mengikuti format ini:role/CodeStarWorker-Project_name-CloudFormation.

4. Peran terbuka di konsol IAM. Pada tab Izin, di Kebijakan Sebaris, perluas baris untuk kebijakan peran layanan Anda, dan pilih Edit Kebijakan.

5. Pilih tab JSON untuk mengedit kebijakan.

   catatan

   Kebijakan yang melekat pada peran pekerja adalahCodeStarWorkerCloudFormationRolePolicy.

6. Di bidang JSON, tambahkan pernyataan kebijakan berikut dalam Statement elemen.

   {
     "Action": [
       "sqs:CreateQueue",
       "sqs:DeleteQueue",
       "sqs:GetQueueAttributes",
       "sqs:SetQueueAttributes",
       "sqs:ListQueues",
       "sqs:GetQueueUrl"
     ],
     "Resource": [
       "*"
     ],
     "Effect": "Allow"
   }

7. Pilih Kebijakan tinjauan untuk memastikan kebijakan tidak mengandung kesalahan, lalu pilih Simpan perubahan.

Langkah 2: Memodifikasi Template.ymlFile

1. Buka AWS CodeStar konsol di https://console.aws.amazon.com/codestar/.

2. Pilih proyek tanpa server Anda dan kemudian buka halaman Kode. Di tingkat atas repositori Anda, catat lokasi. template.yml

3. Gunakan IDE, konsol, atau baris perintah di repositori lokal Anda untuk mengedit template.yml file di repositori Anda. Tempelkan sumber daya ke Resources bagian. Dalam contoh ini, ketika teks berikut disalin, ia menambahkan Resources bagian.

   Resources:
     TestQueue:
       Type: AWS::SQS::Queue

   Contoh ini menunjukkan template yang dimodifikasi:

   

Langkah 3: Komit dan Dorong Perubahan Template Anda

• Komit dan dorong perubahan pada template.yml file yang Anda simpan di langkah 2.

  catatan

  Ini memulai pipa Anda. Jika Anda melakukan perubahan sebelum memperbarui izin IAM, pipeline Anda dimulai dan pembaruan AWS CloudFormation tumpukan menemukan kesalahan, yang menyebabkan pembaruan tumpukan dibatalkan. Jika ini terjadi, perbaiki izin dan kemudian restart pipeline Anda.

Langkah 4: Pantau Pembaruan AWS CloudFormation Stack

1. Saat pipeline untuk proyek Anda memulai tahap Deploy, pembaruan AWS CloudFormation tumpukan dimulai. Anda dapat memilih AWS CloudFormation tahapan di pipeline Anda di AWS CodeStar dasbor Anda untuk melihat pembaruan tumpukan.

   Pemecahan masalah:

   Pembaruan tumpukan gagal jika izin sumber daya yang diperlukan tidak ada. Lihat status kegagalan dalam tampilan AWS CodeStar dasbor untuk pipeline proyek Anda.

   Pilih CloudFormationtautan di tahap Deploy pipeline Anda untuk memecahkan masalah kegagalan di konsol. AWS CloudFormation Di konsol, dalam daftar Acara, pilih proyek Anda untuk melihat detail pembuatan tumpukan. Ada pesan dengan detail kegagalan. Dalam contoh ini, sqs:CreateQueue izin tidak ada.

   

   Tambahkan izin yang hilang dengan mengedit kebijakan yang dilampirkan pada peran AWS CloudFormation pekerja proyek Anda. Lihat Langkah 1: Edit Peran CloudFormation Pekerja di IAM.

2. Setelah berhasil menjalankan pipeline Anda, sumber daya dibuat di AWS CloudFormation tumpukan Anda. Dalam daftar Resources diAWS CloudFormation, lihat sumber daya yang dibuat untuk proyek Anda. Dalam contoh ini, TestQueue antrian tercantum di bagian Sumber Daya.

   URL antrian tersedia diAWS CloudFormation. URL antrian mengikuti format ini:

   https://{REGION_ENDPOINT}/queue.|api-domain|/{YOUR_ACCOUNT_NUMBER}/{YOUR_QUEUE_NAME}

   Untuk informasi selengkapnya, lihat Mengirim Pesan Amazon SQS, Menerima Pesan dari Antrian Amazon SQS, dan Menghapus Pesan dari Antrian Amazon SQS.

Langkah 5: Tambahkan Izin Sumber Daya dengan Kebijakan Inline

Berikan anggota tim akses ke sumber daya baru Anda dengan menambahkan kebijakan inline yang sesuai ke peran pengguna. Tidak semua sumber daya mengharuskan Anda menambahkan izin. Untuk melakukan langkah-langkah berikut, Anda harus masuk ke konsol baik sebagai pengguna root, pengguna administrator di akun, atau pengguna IAM atau pengguna gabungan dengan kebijakan AdministratorAccess terkelola atau yang setara.

Untuk menggunakan editor kebijakan JSON untuk membuat kebijakan

1. Masuk ke AWS Management Console dan buka konsol IAM di https://console.aws.amazon.com/iam/.

2. Di panel navigasi di sebelah kiri, pilih Kebijakan.

   Jika ini pertama kalinya Anda memilih Kebijakan, akan muncul laman Selamat Datang di Kebijakan Terkelola. Pilih Memulai.

3. Di bagian atas halaman, pilih Buat kebijakan.

4. Di bagian Editor kebijakan, pilih opsi JSON.

5. Masukkan dokumen kebijakan JSON berikut:

    {
     "Action": [
       "sqs:CreateQueue",
       "sqs:DeleteQueue",
       "sqs:GetQueueAttributes",
       "sqs:SetQueueAttributes",
       "sqs:ListQueues",
       "sqs:GetQueueUrl"
     ],
     "Resource": [
       "*"
     ],
     "Effect": "Allow"
   } 

6. Pilih Selanjutnya.

   catatan

   Anda dapat beralih antara opsi editor Visual dan JSON kapan saja. Namun, jika Anda membuat perubahan atau memilih Berikutnya di editor Visual, IAM mungkin merestrukturisasi kebijakan Anda untuk mengoptimalkannya untuk editor visual. Untuk informasi selengkapnya, lihat Restrukturisasi kebijakan dalam Panduan Pengguna IAM.

7. Pada halaman Tinjau dan buat, masukkan nama Kebijakan dan Deskripsi (opsional) untuk kebijakan yang Anda buat. Tinjau Izin yang ditentukan dalam kebijakan ini untuk melihat izin yang diberikan oleh kebijakan Anda.

8. Pilih Buat kebijakan untuk menyimpan kebijakan baru Anda.