Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Tutorial: Buat pipeline dengan AWS CloudFormation
<a name="tutorials-cloudformation"></a>

Contohnya menyediakan contoh templat yang memungkinkan Anda gunakan AWS CloudFormation untuk membuat pipeline yang menyebarkan aplikasi ke instance Anda setiap kali kode sumber berubah. Template sampel membuat pipeline yang dapat Anda lihat AWS CodePipeline. Pipeline mendeteksi kedatangan perubahan yang disimpan melalui Amazon CloudWatch Events.

**penting**  
Sebagai bagian dari pembuatan pipa, ember artefak S3 yang disediakan oleh pelanggan akan digunakan CodePipeline untuk artefak. (Ini berbeda dari bucket yang digunakan untuk aksi sumber S3.) Jika bucket artefak S3 berada di akun yang berbeda dari akun untuk pipeline Anda, pastikan bucket artefak S3 dimiliki oleh Akun AWS yang aman dan dapat diandalkan.

**Topics**
+ [Contoh 1: Buat AWS CodeCommit pipeline dengan AWS CloudFormation](tutorials-cloudformation-codecommit.md)
+ [Contoh 2: Buat pipeline Amazon S3 dengan AWS CloudFormation](tutorials-cloudformation-s3.md)

# Contoh 1: Buat AWS CodeCommit pipeline dengan AWS CloudFormation
<a name="tutorials-cloudformation-codecommit"></a>

Panduan ini menunjukkan cara menggunakan AWS CloudFormation konsol untuk membuat infrastruktur yang menyertakan pipeline yang terhubung ke repositori CodeCommit sumber. Dalam tutorial ini, Anda menggunakan file template sampel yang disediakan untuk membuat tumpukan sumber daya, yang mencakup penyimpanan artefak, pipeline, dan sumber daya deteksi perubahan, seperti aturan Amazon CloudWatch Events Anda. Setelah membuat tumpukan sumber daya AWS CloudFormation, Anda dapat melihat pipeline di AWS CodePipeline konsol. Pipa adalah pipa dua tahap dengan tahap CodeCommit sumber dan tahap CodeDeploy penyebaran.

**Prasyarat:**

Anda harus telah membuat sumber daya berikut untuk digunakan dengan template AWS CloudFormation sampel:
+ Anda harus telah membuat repositori sumber. Anda dapat menggunakan AWS CodeCommit repositori yang Anda buat. [Tutorial: Buat pipeline sederhana (CodeCommit repositori)](tutorials-simple-codecommit.md)
+ Anda harus telah membuat grup CodeDeploy aplikasi dan penyebaran. Anda dapat menggunakan CodeDeploy sumber daya yang Anda buat[Tutorial: Buat pipeline sederhana (CodeCommit repositori)](tutorials-simple-codecommit.md).
+ [Pilih salah satu tautan ini untuk mengunduh file AWS CloudFormation templat sampel untuk membuat pipeline: [YAMAL \$1 JSON](samples/codepipeline-codecommit-events-yaml.zip)](samples/codepipeline-codecommit-events-json.zip)

  Buka zip file dan letakkan di komputer lokal Anda.
+ Unduh file aplikasi sampel [SampleApp\$1Linux.zip](samples/SampleApp_Linux.zip).



**Buat pipeline Anda di AWS CloudFormation**

1. Buka zip file dari [SampleApp\$1Linux.zip](samples/SampleApp_Linux.zip) dan unggah file ke AWS CodeCommit repositori Anda. Anda harus mengunggah file yang tidak di-zip ke direktori root repositori Anda. Anda dapat mengikuti instruksi [Langkah 2: Tambahkan kode sampel ke CodeCommit repositori Anda](tutorials-simple-codecommit.md#codecommit-add-code) untuk mendorong file ke repositori Anda.

1. Buka AWS CloudFormation konsol dan pilih **Create Stack**. Pilih **Dengan sumber daya baru (standar)**.

1. Di bawah **Tentukan templat**, pilih **Unggah templat**. Pilih **Pilih file** dan kemudian pilih file template dari komputer lokal Anda. Pilih **Berikutnya**.

1. Dalam **nama Stack**, masukkan nama untuk pipeline Anda. Parameter yang ditentukan oleh template sampel ditampilkan. Masukkan parameter berikut: 

   1. Masuk **ApplicationName**, masukkan nama CodeDeploy aplikasi Anda.

   1. Masuk **BetaFleet**, masukkan nama grup CodeDeploy penyebaran Anda.

   1. Masuk **BranchName**, masukkan cabang repositori yang ingin Anda gunakan.

   1. Masuk **RepositoryName**, masukkan nama repositori CodeCommit sumber Anda.

1. Pilih **Berikutnya**. **Terima default pada halaman berikut, lalu pilih Berikutnya.**

1. Di **Capabilities**, pilih **I accept yang AWS CloudFormation mungkin membuat resource IAM**, lalu pilih **Create** stack.

1. Setelah pembuatan tumpukan Anda selesai, lihat daftar acara untuk memeriksa kesalahan apa pun.

   **Pemecahan Masalah**

   Pengguna IAM yang membuat pipeline AWS CloudFormation mungkin memerlukan izin tambahan untuk membuat sumber daya untuk pipeline. Izin berikut diperlukan dalam kebijakan AWS CloudFormation untuk memungkinkan pembuatan sumber daya CloudWatch Acara Amazon yang diperlukan untuk CodeCommit pipeline:

   ```
   {
        "Effect": "Allow",
        "Action": [
           "events:PutRule",
           "events:PutEvents",
           "events:PutTargets",
           "events:DeleteRule",
           "events:RemoveTargets",
           "events:DescribeRule"
        ],
        "Resource": "resource_ARN"
   }
   ```

1. Masuk ke Konsol Manajemen AWS dan buka CodePipeline konsol di [https://console.aws.amazon.com/codepipeline/](https://console.aws.amazon.com/codepipeline/).

   Di bawah **Pipelines**, pilih pipeline Anda dan pilih **View**. Diagram menunjukkan sumber pipa dan tahapan penerapan Anda.
**catatan**  
Untuk melihat pipeline yang telah dibuat, cari kolom **Logical ID** di bawah tab **Resources** untuk tumpukan Anda CloudFormation. Perhatikan nama di kolom **Physical ID** untuk pipeline. Di CodePipeline, Anda dapat melihat pipeline dengan ID Fisik (nama pipeline) yang sama di Wilayah tempat Anda membuat tumpukan.

1. Di repositori sumber Anda, komit dan dorong perubahan. Sumber daya deteksi perubahan Anda mengambil perubahan, dan pipeline Anda dimulai.

# Contoh 2: Buat pipeline Amazon S3 dengan AWS CloudFormation
<a name="tutorials-cloudformation-s3"></a>

Panduan ini menunjukkan cara menggunakan AWS CloudFormation konsol untuk membuat infrastruktur yang menyertakan pipeline yang terhubung ke bucket sumber Amazon S3. Dalam tutorial ini, Anda menggunakan file template sampel yang disediakan untuk membuat tumpukan sumber daya, yang mencakup bucket sumber, penyimpanan artefak, pipeline, dan sumber daya deteksi perubahan, seperti aturan dan jejak CloudWatch Acara Amazon Anda. CloudTrail Setelah membuat tumpukan sumber daya AWS CloudFormation, Anda dapat melihat pipeline di AWS CodePipeline konsol. Pipeline adalah pipa dua tahap dengan tahap sumber Amazon S3 dan tahap penerapan CodeDeploy.

**Prasyarat:**

Anda harus memiliki sumber daya berikut untuk digunakan dengan template AWS CloudFormation sampel:
+ Anda harus telah membuat instans Amazon EC2, tempat Anda menginstal CodeDeploy agen pada instans. Anda harus telah membuat grup CodeDeploy aplikasi dan penyebaran. Gunakan Amazon EC2 dan CodeDeploy sumber daya yang Anda buat. [Tutorial: Buat pipeline sederhana (CodeCommit repositori)](tutorials-simple-codecommit.md)
+ Pilih tautan berikut untuk mengunduh file AWS CloudFormation templat sampel untuk membuat pipeline dengan sumber Amazon S3: 
  + [Unduh contoh template untuk pipeline Anda: [YAMAL \$1 JSON](samples/codepipeline-s3-events-yaml.zip)](samples/codepipeline-s3-events-json.zip)
  + [Unduh template sampel untuk CloudTrail bucket dan trail Anda: [YAML\$1 JSON](samples/codepipeline-s3-cloudtrail-yaml.zip)](samples/codepipeline-s3-cloudtrail-json.zip)
  + Buka zip file dan letakkan di komputer lokal Anda.
+ Unduh aplikasi sampel dari [SampleApp\$1Linux.zip](samples/SampleApp_Linux.zip).

  Simpan file.zip di komputer lokal Anda. Anda mengunggah file.zip setelah tumpukan dibuat.

**Buat pipeline Anda di AWS CloudFormation**

1. Buka AWS CloudFormation konsol, dan pilih **Create Stack**. Pilih **Dengan sumber daya baru (standar)**.

1. Di **Pilih templat**, pilih **Unggah templat**. Pilih **Pilih file**, lalu pilih file template dari komputer lokal Anda. Pilih **Berikutnya**.

1. Dalam **nama Stack**, masukkan nama untuk pipeline Anda. Parameter yang ditentukan oleh template sampel ditampilkan. Masukkan parameter berikut: 

   1. Masuk **ApplicationName**, masukkan nama CodeDeploy aplikasi Anda. Anda dapat mengganti nama `DemoApplication` default.

   1. Masuk **BetaFleet**, masukkan nama grup CodeDeploy penyebaran Anda. Anda dapat mengganti nama `DemoFleet` default.

   1. Masuk **SourceObjectKey**, masuk`SampleApp_Linux.zip`. Anda mengunggah file ini ke bucket setelah template membuat bucket dan pipeline.

1. Pilih **Berikutnya**. **Terima default pada halaman berikut, lalu pilih Berikutnya.**

1. Di **Capabilities**, pilih **I accept yang AWS CloudFormation mungkin membuat resource IAM**, lalu pilih **Create** stack.

1. Setelah pembuatan tumpukan Anda selesai, lihat daftar acara untuk memeriksa kesalahan apa pun.

   **Pemecahan Masalah**

   Pengguna IAM yang membuat pipeline AWS CloudFormation mungkin memerlukan izin tambahan untuk membuat sumber daya untuk pipeline. Izin berikut diperlukan dalam kebijakan AWS CloudFormation untuk memungkinkan membuat sumber daya CloudWatch Acara Amazon yang diperlukan untuk pipeline Amazon S3:

   ```
   {
        "Effect": "Allow",
        "Action": [
           "events:PutRule",
           "events:PutEvents",
           "events:PutTargets",
           "events:DeleteRule",
           "events:RemoveTargets",
           "events:DescribeRule"
        ],
        "Resource": "resource_ARN"
   }
   ```

1. Di CloudFormation, di tab **Sumber Daya** untuk tumpukan Anda, lihat sumber daya yang dibuat untuk tumpukan Anda. 
**catatan**  
Untuk melihat pipeline yang telah dibuat, cari kolom **Logical ID** di bawah tab **Resources** untuk tumpukan Anda CloudFormation. Perhatikan nama di kolom **Physical ID** untuk pipeline. Di CodePipeline, Anda dapat melihat pipeline dengan ID Fisik (nama pipeline) yang sama di Wilayah tempat Anda membuat tumpukan.

   Pilih bucket S3 dengan `sourcebucket` label di namanya, seperti `s3-cfn-codepipeline-sourcebucket-y04EXAMPLE.` Jangan pilih bucket artefak pipa.

   Bucket sumber kosong karena sumber daya baru dibuat oleh CloudFormation. Buka konsol Amazon S3 dan temukan bucket Anda`sourcebucket`. Pilih **Unggah**, dan ikuti petunjuk untuk mengunggah `SampleApp_Linux.zip` file.zip Anda.
**catatan**  
Jika Amazon S3 adalah penyedia sumber untuk pipeline Anda, Anda harus mengunggah ke bucket semua file sumber yang dikemas sebagai satu file.zip. Jika tidak, tindakan sumber gagal.

1. Masuk ke Konsol Manajemen AWS dan buka CodePipeline konsol di [https://console.aws.amazon.com/codepipeline/](https://console.aws.amazon.com/codepipeline/).

   Di bawah **Pipelines**, pilih pipeline Anda, lalu pilih **View**. Diagram menunjukkan sumber pipa dan tahapan penerapan Anda.

1. Selesaikan langkah-langkah dalam prosedur berikut untuk membuat AWS CloudTrail sumber daya Anda.

**Buat AWS CloudTrail sumber daya Anda di AWS CloudFormation**

1. Buka AWS CloudFormation konsol, dan pilih **Create Stack**.

1. Di **Pilih templat**, pilih **Unggah templat ke Amazon S3**. Pilih **Browse**, lalu pilih file template untuk AWS CloudTrail sumber daya dari komputer lokal Anda. Pilih **Berikutnya**.

1. Dalam **nama Stack**, masukkan nama untuk tumpukan sumber daya Anda. Parameter yang ditentukan oleh template sampel ditampilkan. Masukkan parameter berikut: 

   1. Dalam **SourceObjectKey**, terima default untuk file zip aplikasi sampel.

1. Pilih **Berikutnya**. **Terima default pada halaman berikut, lalu pilih Berikutnya.**

1. **Di **Capabilities**, pilih **I accept yang AWS CloudFormation mungkin membuat resource IAM**, lalu pilih Create.**

1. Setelah pembuatan tumpukan Anda selesai, lihat daftar acara untuk memeriksa kesalahan apa pun.

   Izin berikut diperlukan dalam kebijakan AWS CloudFormation untuk memungkinkan pembuatan CloudTrail sumber daya yang diperlukan untuk pipeline Amazon S3:

   ```
   {
        "Effect": "Allow",
        "Action": [
           "cloudtrail:CreateTrail",
           "cloudtrail:DeleteTrail",
           "cloudtrail:StartLogging",
           "cloudtrail:StopLogging",
           "cloudtrail:PutEventSelectors"
        ],
        "Resource": "resource_ARN"
   }
   ```

1. Masuk ke Konsol Manajemen AWS dan buka CodePipeline konsol di [https://console.aws.amazon.com/codepipeline/](https://console.aws.amazon.com/codepipeline/).

   Di bawah **Pipelines**, pilih pipeline Anda, lalu pilih **View**. Diagram menunjukkan sumber pipa dan tahapan penerapan Anda.

1. Di ember sumber Anda, komit dan dorong perubahan. Sumber daya deteksi perubahan Anda mengambil perubahan dan pipeline Anda dimulai.