Tutorial: Buat pipeline empat tahap

Untuk mengkloning sampel dan mendorong ke repositori GitHub

1. Unduh kode sampel dari GitHub repositori, atau kloning repositori ke komputer lokal Anda. Ada dua paket sampel:

   • Jika Anda akan menerapkan sampel Anda ke instans Amazon Linux, RHEL, atau Ubuntu Server, pilih _linux.zip. codepipeline-jenkins-aws-codedeploy

   • Jika Anda akan menerapkan sampel Anda ke instance Windows Server, pilih CodePipeline-Jenkins- .zip. AWSCodeDeploy_Windows

2. Dari repositori, pilih Fork untuk mengkloning repo sampel menjadi repo di akun Github Anda. Untuk informasi lebih lanjut, lihat dokumentasi GitHub.

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

2. Di konsol IAM, di panel navigasi, pilih Peran, lalu pilih Buat peran.

3. Di bawah Pilih jenis entitas tepercaya, pilih Layanan AWS. Di bawah Pilih layanan yang akan menggunakan peran ini, pilih EC2. Di bawah Pilih kasus penggunaan Anda, pilih EC2.

4. Pilih Berikutnya: Izin. Pada halaman Lampirkan kebijakan izin, pilih kebijakan AWSCodePipelineCustomActionAccess terkelola, lalu pilih Berikutnya: Tag. Pilih Berikutnya: Tinjauan.

5. Pada halaman Tinjauan, dalam nama Peran, masukkan nama peran yang akan dibuat khusus untuk integrasi Jenkins (misalnya,JenkinsAccess), lalu pilih Buat peran.

Untuk menginstal Jenkins dan CodePipeline Plugin untuk Jenkins

1. Buat EC2 instance tempat Anda akan menginstal Jenkins, dan di Langkah 3: Konfigurasikan Detail Instance, pastikan Anda memilih peran instance yang Anda buat (misalnya,JenkinsAccess). Untuk informasi selengkapnya tentang membuat EC2 instance, lihat Meluncurkan EC2 instans Amazon di Panduan EC2 Pengguna Amazon.

   catatan

   Jika Anda sudah memiliki sumber daya Jenkins yang ingin Anda gunakan, Anda dapat melakukannya, tetapi Anda harus membuat pengguna IAM khusus, menerapkan kebijakan AWSCodePipelineCustomActionAccess terkelola ke pengguna itu, dan kemudian mengonfigurasi dan menggunakan kredensil akses untuk pengguna tersebut di sumber daya Jenkins Anda. Jika Anda ingin menggunakan UI Jenkins untuk menyediakan kredensialnya, konfigurasikan Jenkins untuk hanya mengizinkan HTTPS. Untuk informasi selengkapnya, lihat Pemecahan masalah CodePipeline.

2. Instal Jenkins pada EC2 instance. Untuk informasi lebih lanjut, lihat dokumentasi Jenkins untuk menginstal Jenkins dan memulai dan mengakses Jenkins, serta di. details of integration with Jenkins Integrasi produk dan layanan dengan CodePipeline

3. Luncurkan Jenkins, dan di halaman beranda, pilih Kelola Jenkins.

4. Pada halaman Kelola Jenkins, pilih Kelola Plugin.

5. Pilih tab Tersedia, dan di kotak pencarian Filter, masukkanAWS CodePipeline. Pilih CodePipeline Plugin untuk Jenkins dari daftar dan pilih Unduh sekarang dan instal setelah restart.

6. Pada halaman Instalasi Plugin/Upgrade, pilih Restart Jenkins ketika instalasi selesai dan tidak ada pekerjaan yang berjalan.

7. Pilih Kembali ke Dasbor.

8. Di halaman utama, pilih Item Baru.

9. Di Nama Item, masukkan nama untuk proyek Jenkins (misalnya,MyDemoProject). Pilih Freestyle project, lalu pilih OK.

   catatan

   Pastikan bahwa nama untuk proyek Anda memenuhi persyaratan untuk CodePipeline. Untuk informasi selengkapnya, lihat Kuota di AWS CodePipeline.

10. Pada halaman konfigurasi untuk proyek, pilih kotak centang Execute concurrent build jika perlu. Di Manajemen Kode Sumber, pilih AWS CodePipeline. Jika Anda telah menginstal Jenkins pada sebuah EC2 instance dan mengonfigurasi AWS CLI dengan profil untuk pengguna IAM yang Anda buat untuk integrasi antara CodePipeline dan Jenkins, biarkan semua bidang lainnya kosong.

11. Pilih Advanced, dan di Provider, masukkan nama untuk penyedia tindakan seperti yang akan muncul di CodePipeline (misalnya,MyJenkinsProviderName). Pastikan nama ini unik dan mudah diingat. Anda akan menggunakannya ketika Anda menambahkan tindakan build ke pipeline Anda nanti dalam tutorial ini, dan lagi ketika Anda menambahkan tindakan pengujian.

    catatan

    Nama tindakan ini harus memenuhi persyaratan penamaan untuk tindakan di CodePipeline. Untuk informasi selengkapnya, lihat Kuota di AWS CodePipeline.

12. Di Build Triggers, kosongkan kotak centang apa pun, lalu pilih Poll SCM. Dalam Jadwal, masukkan lima tanda bintang yang dipisahkan oleh spasi, sebagai berikut:

    * * * * *

    Jajak pendapat ini dilakukan CodePipeline setiap menit.

13. Di Build, pilih Add build step. Pilih Execute shell (Amazon Linux, RHEL, atau Ubuntu Server) Jalankan perintah batch (Windows Server), lalu masukkan yang berikut ini:

    rake

    catatan

    Pastikan lingkungan Anda dikonfigurasi dengan variabel dan pengaturan yang diperlukan untuk menjalankan rake; jika tidak, build akan gagal.

14. Pilih Add post-build action, lalu pilih AWS CodePipeline Publisher. Pilih Tambah, dan di Build Output Locations, biarkan lokasi kosong. Konfigurasi ini adalah default. Ini akan membuat file terkompresi di akhir proses pembuatan.

15. Pilih Simpan untuk menyimpan proyek Jenkins Anda.

Untuk membuat proses rilis CodePipeline otomatis

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

2. Jika perlu, gunakan pemilih Wilayah untuk mengubah Wilayah ke wilayah tempat sumber daya pipa Anda berada. Misalnya, jika Anda membuat sumber daya untuk tutorial sebelumnya dius-east-2, pastikan pemilih Region diatur ke US East (Ohio).

   Untuk informasi selengkapnya tentang Wilayah dan titik akhir yang tersedia CodePipeline, lihat AWS CodePipeline titik akhir dan kuota.

3. Pada halaman Selamat Datang, halaman Memulai, atau halaman Pipelines, pilih Buat pipeline.

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

5. Pada Langkah 2: Pilih halaman pengaturan pipeline, dalam nama Pipeline, masukkan nama untuk pipeline Anda.

6. 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 pipa. Untuk informasi tentang harga CodePipeline, lihat Harga.

7. Dalam peran Layanan, pilih Peran layanan baru CodePipeline untuk memungkinkan membuat peran layanan di IAM.

8. Biarkan pengaturan di bawah Pengaturan lanjutan pada defaultnya, dan pilih Berikutnya.

9. Pada Langkah 3: Tambahkan halaman tahap sumber, di penyedia Sumber, pilih GitHub.

10. Di bawah Koneksi, pilih koneksi yang ada atau buat yang baru. Untuk membuat atau mengelola koneksi untuk tindakan GitHub sumber Anda, lihatGitHub koneksi.

11. Pada Langkah 4: Tambahkan tahap build, pilih Add Jenkins. Di nama Provider, masukkan nama tindakan yang Anda berikan di CodePipeline Plugin untuk Jenkins (misalnyaMyJenkinsProviderName). Nama ini harus sama persis dengan nama di CodePipeline Plugin untuk Jenkins. Di URL Server, masukkan URL EC2 contoh tempat Jenkins diinstal. Dalam nama Proyek, masukkan nama proyek yang Anda buat di Jenkins, sepertiMyDemoProject, lalu pilih Berikutnya.

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

    Pilih Berikutnya.

13. Pada Langkah 6: Tambahkan tahap penerapan, gunakan kembali grup CodeDeploy aplikasi dan penyebaran yang Anda buat. Tutorial: Buat pipeline sederhana (ember S3) Di Penyedia Deploy, pilih CodeDeploy. Di Nama aplikasiCodePipelineDemoApplication, masukkan, atau pilih tombol refresh, lalu pilih nama aplikasi dari daftar. Di grup DeploymentCodePipelineDemoFleet, masukkan, atau pilih dari daftar, lalu pilih Berikutnya.

    catatan

    Anda dapat menggunakan CodeDeploy sumber daya Anda sendiri atau membuat yang baru, tetapi Anda mungkin dikenakan biaya tambahan.

14. Pada Langkah 7: Tinjau, tinjau informasinya, lalu pilih Buat pipeline.

15. Pipa secara otomatis memulai dan menjalankan sampel melalui pipa. Anda dapat melihat pesan kemajuan dan keberhasilan dan kegagalan saat pipeline membangun sampel Haml ke HTML dan menerapkannya sebagai halaman web ke setiap EC2 instans Amazon dalam penerapan. CodeDeploy

Untuk memverifikasi alamat IP dari sebuah instance tempat Anda menerapkan kode

1. Setelah Berhasil ditampilkan untuk status pipeline, di area status untuk tahap Pementasan, pilih Detail.

2. Di bagian Detail Deployment, di ID Instance, pilih ID instans dari salah satu instance yang berhasil diterapkan.

3. Salin alamat IP instance (misalnya,192.168.0.4). Anda akan menggunakan alamat IP ini dalam tes Jenkins Anda.

Untuk membuat proyek Jenkins

1. Pada contoh di mana Anda menginstal Jenkins, buka Jenkins dan dari halaman utama, pilih Item Baru.

2. Di Nama Item, masukkan nama untuk proyek Jenkins (misalnya,MyTestProject). Pilih Freestyle project, lalu pilih OK.

   catatan

   Pastikan bahwa nama untuk proyek Anda memenuhi CodePipeline persyaratan. Untuk informasi selengkapnya, lihat Kuota di AWS CodePipeline.

3. Pada halaman konfigurasi untuk proyek, pilih kotak centang Execute concurrent build jika perlu. Di Manajemen Kode Sumber, pilih AWS CodePipeline. Jika Anda telah menginstal Jenkins pada sebuah EC2 instance dan mengkonfigurasi AWS CLI dengan profil untuk pengguna IAM yang Anda buat untuk integrasi antara CodePipeline dan Jenkins, biarkan semua bidang lainnya kosong.

   penting

   Jika Anda mengonfigurasi proyek Jenkins dan tidak diinstal pada EC2 instans Amazon, atau diinstal pada instance yang menjalankan sistem operasi Windows, lengkapi bidang seperti yang dipersyaratkan oleh host proxy dan pengaturan port Anda, dan berikan kredensi pengguna IAM atau peran yang Anda konfigurasikan untuk integrasi antara Jenkins dan. EC2 CodePipeline

4. Pilih Advanced, dan di Kategori, pilih Test.

5. Di Provider, masukkan nama yang sama dengan yang Anda gunakan untuk proyek build (misalnya,MyJenkinsProviderName). Anda akan menggunakan nama ini ketika Anda menambahkan tindakan pengujian ke pipeline Anda nanti dalam tutorial ini.

   catatan

   Nama ini harus memenuhi persyaratan CodePipeline penamaan untuk tindakan. Untuk informasi selengkapnya, lihat Kuota di AWS CodePipeline.

6. Di Build Triggers, kosongkan kotak centang apa pun, lalu pilih Poll SCM. Dalam Jadwal, masukkan lima tanda bintang yang dipisahkan oleh spasi, sebagai berikut:

   * * * * *

   Jajak pendapat ini dilakukan CodePipeline setiap menit.

7. Di Build, pilih Add build step. Jika Anda menggunakan instance Amazon Linux, RHEL, atau Ubuntu Server, pilih Execute shell. Kemudian masukkan yang berikut ini, di mana alamat IP adalah alamat EC2 instance yang Anda salin sebelumnya:

   TEST_IP_ADDRESS=192.168.0.4 rake test

   Jika Anda menyebarkan ke instance Windows Server, pilih Jalankan perintah batch, lalu masukkan yang berikut ini, di mana alamat IP adalah alamat EC2 instance yang Anda salin sebelumnya:

   set TEST_IP_ADDRESS=192.168.0.4 rake test

   catatan

   Tes ini mengasumsikan port default 80. Jika Anda ingin menentukan port yang berbeda, tambahkan pernyataan port uji, sebagai berikut:

   TEST_IP_ADDRESS=192.168.0.4 TEST_PORT=8000 rake test

8. Pilih Add post-build action, lalu pilih AWS CodePipeline Publisher. Jangan pilih Tambah.

9. Pilih Simpan untuk menyimpan proyek Jenkins Anda.

Untuk menambahkan panggung ke pipeline Anda yang mencakup tindakan uji Jenkins

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

2. Di Nama, pilih nama pipeline yang Anda buat, MySecondPipeline.

3. Pada halaman detail pipeline, pilih Edit.

4. Pada halaman Edit, pilih + Stage untuk menambahkan stage segera setelah tahap Build.

5. Di bidang nama untuk tahap baru, masukkan nama (misalnya,Testing), lalu pilih + Tambahkan grup tindakan.

6. Dalam nama Action, masukkanMyJenkinsTest-Action. Di Penyedia uji, pilih nama penyedia yang Anda tentukan di Jenkins (misalnya,MyJenkinsProviderName). Dalam nama Proyek, masukkan nama proyek yang Anda buat di Jenkins (misalnya,MyTestProject). Di artefak Input, pilih artefak dari build Jenkins yang nama defaultnyaBuildArtifact, lalu pilih Selesai.

   catatan

   Karena tindakan pengujian Jenkins beroperasi pada aplikasi yang dibangun pada langkah pembuatan Jenkins, gunakan artefak build untuk artefak input ke tindakan pengujian.

   Untuk informasi lebih lanjut tentang artefak input dan output dan struktur pipa, lihat. CodePipeline referensi struktur pipa

7. Pada halaman Edit, pilih Simpan perubahan pipeline. Dalam kotak dialog Simpan perubahan pipeline, pilih Simpan dan lanjutkan.

8. Meskipun tahap baru telah ditambahkan ke pipeline Anda, status Tidak ada eksekusi belum ditampilkan untuk tahap itu karena tidak ada perubahan yang memicu proses pipeline lainnya. Untuk menjalankan sampel melalui pipeline yang direvisi, pada halaman detail pipeline, pilih Rilis perubahan.

   Tampilan pipeline menunjukkan tahapan dan tindakan dalam pipeline Anda dan status revisi yang berjalan melalui empat tahap tersebut. Waktu yang dibutuhkan pipa untuk berjalan melalui semua tahapan akan tergantung pada ukuran artefak, kompleksitas tindakan pembuatan dan pengujian Anda, dan faktor lainnya.

Untuk membersihkan sumber daya yang digunakan dalam tutorial ini

1. Buka sesi terminal di Linux, macOS, atau mesin Unix lokal Anda, atau prompt perintah di mesin Windows lokal Anda, dan jalankan delete-pipeline perintah untuk menghapus pipeline yang Anda buat. UntukMySecondPipeline, Anda akan memasukkan perintah berikut:

   aws codepipeline delete-pipeline --name "MySecondPipeline"

   Perintah ini tidak mengembalikan apa pun.

2. Untuk membersihkan CodeDeploy sumber daya Anda, ikuti instruksi di Membersihkan.

3. Untuk membersihkan sumber daya instans Anda, hapus EC2 instance tempat Anda menginstal Jenkins. Untuk informasi lebih lanjut, lihat Membersihkan instans Anda.

4. Jika Anda tidak bermaksud membuat lebih banyak saluran pipa atau menggunakan CodePipeline lagi, hapus bucket Amazon S3 yang digunakan untuk menyimpan artefak untuk pipeline Anda. Untuk menghapus ember, ikuti petunjuk di Menghapus ember.

5. Jika Anda tidak berniat menggunakan sumber daya lain untuk pipeline ini lagi, pertimbangkan untuk menghapusnya dengan mengikuti panduan untuk sumber daya tertentu. Misalnya, jika Anda ingin menghapus GitHub repositori, ikuti instruksi di Menghapus repositori di situs web. GitHub