Tutorial: Buat pipeline sederhana (CodeCommit repositori)

Untuk membuat CodeCommit repositori

1. Buka CodeCommit konsol di https://console.aws.amazon.com/codecommit/.

2. Di pemilih Wilayah, pilih Wilayah AWS tempat Anda ingin membuat repositori dan pipeline. Untuk informasi lebih lanjut, lihat Wilayah AWS dan Titik Akhir.

3. Pada halaman Repositori, pilih Buat repositori.

4. Pada halaman Buat repositori, dalam Nama Repositori, ketikkan nama untuk repositori Anda, (misalnya MyDemoRepo).

5. Pilih Buat.

Untuk mengatur repositori lokal

Pada langkah ini, Anda mengatur repositori lokal untuk terhubung ke reposit CodeCommit ori jarak jauh Anda.

1. Dengan repositori baru Anda terbuka di konsol, pilih Clone URL di kanan atas halaman, lalu pilih Clone SSH. Alamat untuk mengkloning repositori Git Anda disalin ke clipboard Anda.

2. Di terminal atau baris perintah Anda, navigasikan ke direktori lokal tempat Anda ingin repositori lokal Anda disimpan. Dalam tutorial ini, kita menggunakan /tmp

3. Jalankan perintah berikut untuk mengkloning repositori, mengganti alamat SSH dengan yang Anda salin pada langkah sebelumnya. Perintah ini membuat direktori yang disebutMyDemoRepo. Anda menyalin aplikasi sampel ke direktori ini.

   git clone ssh://git-codecommit.us-west-2.amazonaws.com/v1/repos/MyDemoRepo

1. Selanjutnya, unduh sampel dan simpan ke folder atau direktori di komputer lokal Anda.

   1. Pilih salah satu dari berikut ini. Pilih SampleApp_Linux.zip jika Anda ingin mengikuti langkah-langkah dalam tutorial ini untuk instance Linux.

      • Jika Anda ingin menerapkan ke instans Amazon Linux menggunakan CodeDeploy, unduh contoh aplikasi di sini: SampleApp _ Linux.zip.

      • Jika Anda ingin menerapkan ke instans Windows Server menggunakan CodeDeploy, unduh aplikasi sampel di sini: SampleApp _ Windows.zip.

      Contoh aplikasi berisi file berikut untuk digunakan dengan: CodeDeploy

      • appspec.yml- File spesifikasi aplikasi (AppSpecfile) adalah file berformat YAML yang digunakan oleh CodeDeploy untuk mengelola penerapan. Untuk informasi selengkapnya tentang AppSpec file, lihat Referensi CodeDeploy AppSpec file di Panduan AWS CodeDeploy Pengguna.

      • index.html- File indeks berisi halaman beranda untuk aplikasi sampel yang digunakan.

      • LICENSE.txt- File lisensi berisi informasi lisensi untuk aplikasi sampel.

      • File untuk skrip — Aplikasi sampel menggunakan skrip untuk menulis file teks ke lokasi pada instance Anda. Satu file ditulis untuk masing-masing dari beberapa peristiwa siklus hidup CodeDeploy penerapan sebagai berikut:

        • F scripts older (Hanya sampel Linux) - Folder berisi skrip shell berikut untuk menginstal dependensi dan memulai dan menghentikan aplikasi sampel untuk penerapan otomatis:install_dependencies,start_server, danstop_server.

        • (Hanya contoh Windows) before-install.bat - Ini adalah skrip batch untuk peristiwa siklus hidup BeforeInstall penerapan, yang akan dijalankan untuk menghapus file lama yang ditulis selama penerapan sebelumnya dari sampel ini dan membuat lokasi pada instance Anda untuk menulis file baru.

   2. Unduh file terkompresi (zip).

2. Unzip file dari SampleApp _ Linux.zip ke direktori lokal yang Anda buat sebelumnya (misalnya, /tmp/MyDemoRepo atauc:\temp\MyDemoRepo).

   Pastikan untuk menempatkan file langsung ke repositori lokal Anda. Jangan menyertakan SampleApp_Linux folder. Pada mesin Linux, macOS, atau Unix lokal Anda, misalnya, direktori dan hierarki file Anda akan terlihat seperti ini:

   /tmp
      └-- MyDemoRepo
          │-- appspec.yml
          │-- index.html
          │-- LICENSE.txt
          └-- scripts
              │-- install_dependencies
              │-- start_server
              └-- stop_server

3. Untuk mengunggah file ke repositori Anda, gunakan salah satu metode berikut.

   1. Untuk menggunakan CodeCommit konsol untuk mengunggah file Anda:

      1. Buka CodeCommit konsol, dan pilih repositori Anda dari daftar Repositories.

      2. Pilih Tambah file, lalu pilih Unggah file.

      3. Pilih Pilih file, lalu telusuri file Anda. Untuk menambahkan file di bawah folder, pilih Buat file dan kemudian masukkan nama folder dengan nama file, sepertiscripts/install_dependencies. Tempelkan isi file ke file baru.

         Lakukan perubahan dengan memasukkan nama pengguna dan alamat email Anda.

         Pilih Perubahan commit.

      4. Ulangi langkah ini untuk setiap file.

         Konten repositori Anda akan terlihat seperti ini:

         
                │-- appspec.yml
                │-- index.html
                │-- LICENSE.txt
                └-- scripts
                    │-- install_dependencies
                    │-- start_server
                    └-- stop_server

   2. Untuk menggunakan perintah git untuk mengunggah file Anda:

      1. Ubah direktori ke repo lokal Anda:

         (For Linux, macOS, or Unix) cd /tmp/MyDemoRepo
         (For Windows) cd c:\temp\MyDemoRepo

      2. Jalankan perintah berikut untuk mementaskan semua file Anda sekaligus:

         git add -A

      3. Jalankan perintah berikut untuk mengkomit file dengan pesan commit:

         git commit -m "Add sample application files"

      4. Jalankan perintah berikut untuk mendorong file dari repo lokal Anda ke CodeCommit repositori Anda:

         git push

4. File yang Anda unduh dan tambahkan ke repo lokal Anda sekarang telah ditambahkan ke main cabang di CodeCommit MyDemoRepo repositori Anda dan siap untuk disertakan dalam pipeline.

Untuk membuat peran instance

1. Buka konsol IAM di https://console.aws.amazon.com/iam/.

2. Dari dasbor konsol, pilih Per an.

3. Pilih Buat peran.

4. Di bawah Pilih jenis entitas tepercaya, pilih Layanan AWS. Di bawah Pilih kasus penggunaan, pilih EC2. Di bawah Pilih kasus penggunaan Anda, pilih EC2. Pilih Berikutnya: Izin.

5. Cari dan pilih kebijakan bernama AmazonEC2RoleforAWSCodeDeploy.

6. Cari dan pilih kebijakan bernama AmazonSSMManagedInstanceCore. Pilih Berikutnya: Tanda.

7. Pilih Berikutnya: Tinjau. Masukkan nama untuk peran (misalnya,EC2InstanceRole).

   catatan

   Catat nama peran Anda untuk langkah selanjutnya. Anda memilih peran ini saat Anda membuat instance Anda.

   Pilih Buat peran.

Untuk meluncurkan sebuah instans

1. Buka konsol Amazon EC2 di https://console.aws.amazon.com/ec2/.

2. Dari navigasi samping, pilih Inst ans, dan pilih Luncur kan instance dari bagian atas halaman.

3. Di Nama, masukkan MyCodePipelineDemo. Ini menetapkan instance tag Key dari Name dan tag Value of. MyCodePipelineDemo Kemudian, Anda membuat CodeDeploy aplikasi yang menerapkan aplikasi sampel ke instance ini. CodeDeploymemilih instance untuk digunakan berdasarkan tag.

4. Di bawah Aplikasi dan Gambar OS (Amazon Machine Image), cari opsi Amazon Linux AMI dengan AWS logo, dan pastikan itu dipilih. (AMI ini digambarkan sebagai Amazon Linux 2 AMI (HVM) dan diberi label “Free tier”.)

5. Di bawah Jenis instans, pilih t2.micro jenis yang memenuhi syarat tingkat gratis sebagai konfigurasi perangkat keras untuk instans Anda.

6. Di bawah Pasangan kunci (login), pilih pasangan kunci atau buat satu.

   Anda juga dapat memilih Lanjutkan tanpa pasangan kunci.

   catatan

   Untuk keperluan tutorial ini, Anda dapat melanjutkan tanpa pasangan kunci. Untuk menggunakan SSH untuk terhubung ke instans Anda, buat atau gunakan pasangan kunci.

7. Di bawah Pengaturan jaringan, lakukan hal berikut.

   Di IP Pu Auto-assign blik, pastikan statusnya adalah Aktifkan.

   Untuk grup keamanan yang dibuat, pilih HTTP, lalu di bawah Jenis sumber, pilih IP Saya.

8. Perluas detail lanjutan. Di profil instance IAM, pilih peran IAM yang Anda buat dalam prosedur sebelumnya (misalnya,EC2InstanceRole).

9. Di bawah Ringkasan, di bawah Jumlah instance, masukkan1.

10. Pilih Luncurkan instans.

11. Anda dapat melihat status peluncuran di halaman Instans. Saat Anda meluncurkan instans, status awalnya adalah pending. Setelah instans dimulai, statusnya berubah menjadi running, dan ia menerima nama DNS publik. (Jika kolom DNS Publik tidak ditampilkan, pilih Show/Hide ikon, lalu pilih DNS Publik.)

Untuk membuat peran CodeDeploy layanan

1. Buka konsol IAM di https://console.aws.amazon.com/iam/.

2. Dari dasbor konsol, pilih Per an.

3. Pilih Buat peran.

4. Di bawah Pilih entitas tepercaya, pilih Layanan AWS. Di bawah Kasus penggunaan, pilih CodeDeploy. Pilih CodeDeploy dari opsi yang tercantum. Pilih Berikutnya. Kebijakan yang AWSCodeDeployRole dikelola sudah melekat pada peran.

5. Pilih Berikutnya.

6. Masukkan nama untuk peran (misalnya,CodeDeployRole), lalu pilih Buat peran.

Untuk membuat aplikasi di CodeDeploy

1. Buka CodeDeploy konsol di https://console.aws.amazon.com/codedeploy.

2. Jika halaman Aplikasi tidak muncul, pada menu, pilih Aplikasi.

3. Pilih Create application (Buat aplikasi).

4. Di Nama aplikasi, masukkanMyDemoApplication.

5. Di Compute Platform, pilih EC2/On-premises.

6. Pilih Create application (Buat aplikasi).

Untuk membuat grup penerapan di CodeDeploy

Grup penerapan adalah sumber daya yang mendefinisikan pengaturan terkait penerapan seperti instans mana yang akan digunakan dan seberapa cepat penerapannya.

1. Pada halaman yang menampilkan aplikasi Anda, pilih Buat grup penerapan.

2. Di Nama grup Deployment, masukkanMyDemoDeploymentGroup.

3. Di Peran Layanan, pilih ARN dari peran layanan yang Anda buat sebelumnya (misalnya,arn:aws:iam::account_ID:role/CodeDeployRole).

4. Di bawah Jenis pener apan, pilih In-place.

5. Di bawah Konfigurasi lingkungan, pilih Inst ans Amazon EC2. Di bidang Kunci, masukkanName. Di bidang Nilai, masukkan nama yang Anda gunakan untuk menandai instance (misalnya,MyCodePipelineDemo).

6. Di bawah Konfigurasi agen dengan Manajer AWS Sistem, pilih Sekarang dan jadwalkan pembaruan. Ini menginstal agen pada instance. Instance Linux sudah dikonfigurasi dengan agen SSM dan sekarang akan diperbarui dengan CodeDeploy agen.

7. Di bawah Konfigurasi pener apan, pilihCodeDeployDefault.OneAtaTime.

8. Di bawah Load Balancer, pastikan Aktifkan penyeimbangan beban tidak dipilih. Anda tidak perlu mengatur penyeimbang beban atau memilih grup target untuk contoh ini.

9. Pilih Buat grup penerapan.

Untuk membuat CodePipeline pipa

1. Masuk ke Konsol Manajemen AWS dan buka CodePipeline konsol di http://console.aws.amazon.com/codesuite/codepipeline/home.

   Buka CodePipeline konsol di https://console.aws.amazon.com/codepipeline/.

2. Pada halaman Selamat Datang, halaman Mem ulai, atau halaman Pipelines, pilih Buat pipeline.

3. Pada Langkah 1: Pilih halaman opsi pembuatan, di bawah Opsi pembuatan, pilih opsi Build custom pipeline. Pilih Berikutnya.

4. Di Langkah 2: Pilih pengaturan pipa, di Nama Pipeline, masukkanMyFirstPipeline.

5. CodePipeline menyediakan pipa tipe V1 dan V2, yang berbeda dalam karakteristik dan harga. Jenis V2 adalah satu-satunya jenis yang dapat Anda pilih di konsol. Untuk informasi selengkapnya, lihat Jenis jalur. Untuk informasi tentang penetapan harga untuk CodePipeline, lihat Harga.

6. Di Peran layanan, pilih Peran layanan baru untuk memungkinkan CodePipeline untuk membuat peran layanan di IAM.

7. Biarkan pengaturan di bawah Peng aturan lanj utan pada defaultnya, lalu pilih Ber ikutnya.

8. Pada Langkah 3: Tambahkan tahap sumber, di Penye dia Sumber, pilih CodeCommit. Di Nama Repositori, pilih nama CodeCommit repositori yang Anda buatLangkah 1: Buat CodeCommit repositori. Di Nama cabang, pilihmain, lalu pilih Langkah berikutnya.

   Setelah Anda memilih nama repositori dan cabang, sebuah pesan menampilkan aturan Amazon CloudWatch Events yang akan dibuat untuk pipeline ini.

   Di bawah Opsi deteksi perubahan, tinggalkan default. Hal ini CodePipeline memungkinkan Anda menggunakan Amazon CloudWatch Events untuk mendeteksi perubahan pada repositori sumber Anda.

   Pilih Berikutnya.

9. Pada Langkah 4: Tambahkan tahap build, pilih Lewati tahap build, lalu terima pesan peringatan dengan memilih Le wati lagi. Pilih Berikutnya.

   catatan

   Dalam tutorial ini, Anda menerapkan kode yang tidak memerlukan layanan build, sehingga Anda dapat melewati langkah ini. Namun, jika kode sumber Anda perlu dibuat sebelum digunakan ke instance, Anda dapat mengonfigurasi CodeBuild pada langkah ini.

10. Pada Langkah 5: Tambahkan tahap pengujian, pilih Lewati tahap pengujian, lalu terima pesan peringatan dengan memilih Le wati lagi.

    Pilih Berikutnya.

11. Pada Langkah 6: Tambahkan tahap penerapan, di Penyedia Deplo y, pilih CodeDeploy. Di Nama aplikasi, pilihMyDemoApplication. Di grup Deployment MyDemoDeploymentGroup, pilih, lalu pilih Langkah berikutnya.

12. Pada Langkah 7: Tinjau, tinjau informasi, lalu pilih Buat pipeline.

13. Pipa mulai berjalan setelah dibuat. Ini mengunduh kode dari CodeCommit repositori Anda dan membuat CodeDeploy penerapan ke instance EC2 Anda. Anda dapat melihat kemajuan dan pesan keberhasilan dan kegagalan saat CodePipeline sampel menyebarkan halaman web ke instans Amazon EC2 dalam penerapan CodeDeploy .

    

Untuk memverifikasi bahwa pipeline Anda berhasil berjalan

1. Lihat kemajuan awal pipa. Status setiap tahap berubah dari Belum ada eksekusi menjadi Sedang Ber jalan, dan kemudian menjadi Sukses atau Gag al. Pipa harus menyelesaikan proses pertama dalam beberapa menit.

2. Setelah Suk ses ditampilkan untuk status pipeline, di area status untuk tahap De ploy, pilih CodeDeploy. Ini membuka CodeDeploy konsol. Jika Suk ses tidak ditampilkan, lihatPemecahan masalah CodePipeline.

3. Pada tab Deployments, pilih ID penerapan. Pada halaman untuk penerapan, di bawah Peristiwa siklus hidup pener apan, pilih ID instans. Ini membuka konsol EC2.

4. Pada tab Deskripsi, di DNS Publik, salin alamat (misalnya,ec2-192-0-2-1.us-west-2.compute.amazonaws.com), lalu tempelkan ke bilah alamat browser web Anda.

   Halaman web ditampilkan untuk aplikasi sampel yang Anda unduh dan dorong ke CodeCommit repositori Anda.

1. Ubah direktori ke repo lokal Anda:

   (For Linux, macOS, or Unix) cd /tmp/MyDemoRepo
   (For Windows) cd c:\temp\MyDemoRepo

2. Gunakan editor teks untuk memodifikasi index.html file:

   (For Linux or Unix)gedit index.html
   (For OS X)open –e index.html
   (For Windows)notepad index.html

3. Merevisi isi index.html file untuk mengubah warna latar belakang dan beberapa teks di halaman web, lalu simpan file.

   <!DOCTYPE html>
   <html>
   <head>
     <title>Updated Sample Deployment</title>
     <style>
       body {
         color: #000000;
         background-color: #CCFFCC;
         font-family: Arial, sans-serif;  
         font-size:14px;
       }
           
       h1 {
         font-size: 250%;
         font-weight: normal;
         margin-bottom: 0;
       }
       
       h2 {
         font-size: 175%;
         font-weight: normal;
         margin-bottom: 0;
       }
     </style>
   </head>
   <body>
     <div align="center"><h1>Updated Sample Deployment</h1></div>
     <div align="center"><h2>This application was updated using CodePipeline, CodeCommit, and CodeDeploy.</h2></div>
     <div align="center">
       <p>Learn more:</p> 
       <p><a href="https://docs.aws.amazon.com/codepipeline/latest/userguide/">CodePipeline User Guide</a></p>
       <p><a href="https://docs.aws.amazon.com/codecommit/latest/userguide/">CodeCommit User Guide</a></p>
       <p><a href="https://docs.aws.amazon.com/codedeploy/latest/userguide/">CodeDeploy User Guide</a></p>
     </div>
   </body>
   </html>

4. Komit dan dorong perubahan Anda ke CodeCommit repositori Anda dengan menjalankan perintah berikut, satu per satu:

   git commit -am "Updated sample application files"

   git push

Untuk memverifikasi bahwa pipeline berjalan dengan sukses

1. Lihat kemajuan awal pipa. Status setiap tahap berubah dari Belum ada eksekusi menjadi Sedang Ber jalan, dan kemudian menjadi Sukses atau Gag al. Jalur pipa harus selesai dalam beberapa menit.

2. Setelah Suk ses ditampilkan untuk status tindakan, segarkan halaman demo yang Anda akses sebelumnya di browser Anda.

   Halaman web yang diperbarui ditampilkan.

Untuk membersihkan sumber daya yang digunakan dalam tutorial ini

1. Untuk membersihkan CodePipeline sumber daya Anda, ikuti petunjuk di Hapus pipeline di AWS CodePipeline.

2. Untuk membersihkan CodeDeploy sumber daya Anda, ikuti petunjuk di Sumber Daya Panduan Pem bersihan Penyebaran.

3. Untuk menghapus CodeCommit repositori, ikuti petunjuk di H apus CodeCommit repositori.