Tutorial: Membuat pipa empat tahap

Untuk mengkloning sampel dan mendorong ke GitHub repositori

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 codepipeline-jenkins-aws-codedeploy_linux.zip.

   • Jika Anda akan menerapkan sampel Anda ke instans Windows Server, pilih CodePipeline-Jenkins-AWSCodeDeploy _ Windows.zip.

2. Dari repositori, pilih Fork untuk mengkloning repo sampel ke repo di akun Anda GitHub . Lihat informasi yang lebih lengkap dalam dokumentasi GitHub.

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

2. Di konsol IAM, di panel navigasi, pilih Per an, 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 ter AWSCodePipelineCustomActionAccess kelola, lalu pilih Ber ikutnya: Tag. Pilih Berikutnya: Tinjauan.

5. Pada halaman Tinjauan, di 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 instance EC2 tempat Anda akan menginstal Jenkins, dan di Langkah 3: Konfigurasikan Detail Instans, pastikan Anda memilih peran instans yang Anda buat (misalnya,JenkinsAccess). Untuk informasi selengkapnya tentang membuat instans EC2, lihat Meluncurkan instans Amazon EC2 di Panduan Pengguna Amazon EC2.

   catatan

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

2. Instal Jenkins pada instance EC2. 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 Kel ola Jen kins.

4. Pada halaman Kel ola Jenkins, pilih Kel ola 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 Plugins/Upgrades halaman Instalasi, pilih Restart Jenkins saat instalasi selesai dan tidak ada pekerjaan yang berjalan.

7. Pilih Kem bali ke Dasbor.

8. Pada halaman utama, pilih I tem Baru.

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

   catatan

   Pastikan 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 Jalankan build bersamaan jika perlu. Di Manajemen Kode Sumber, pilih AWS CodePipeline. Jika Anda telah menginstal Jenkins pada instance EC2 dan mengonfigurasinya AWS CLI dengan profil untuk pengguna IAM yang Anda buat untuk integrasi antara CodePipeline dan Jenkins, biarkan semua bidang lainnya kosong.

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

    catatan

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

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

    * * * * *

    Ini jajak pendapat CodePipeline setiap menit.

13. Di Build, pilih Add build step. Pilih Execute shell (Amazon Linux, RHEL, atau Ubuntu Server) J alankan 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 Tambahkan tindakan pasca-pembuatan, lalu pilih AWS CodePipeline Penerbit. Pilih Tambah, dan di Build Output Locations, biarkan lokasi kosong. Konfigurasi ini adalah default. Ini akan membuat file terkompresi di akhir proses build.

15. Pilih Simpan untuk menyimpan proyek Jenkins Anda.

Untuk membuat proses rilis CodePipeline otomatis

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

2. Jika perlu, gunakan pemilih Wilayah untuk mengubah Wilayah ke lokasi sumber daya pipeline Anda. Misalnya, jika Anda membuat sumber daya untuk tutorial sebelumnya dius-east-2, pastikan bahwa pemilih Wilayah diatur ke AS Timur (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 Mem ulai, 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 halaman Langkah 2: Pilih pengaturan pipeline, di 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 jalur. Untuk informasi tentang penetapan harga untuk CodePipeline, lihat Harga.

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

8. Biarkan pengaturan di bawah Peng aturan lanjutan pada defaultnya, dan pilih Ber ikutnya.

9. Pada Langkah 3: Tambahkan halaman tahap sumber, di Penye dia 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 Tambahkan Jenkins. Di Nama Penye dia, 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 instance EC2 tempat Jenkins diinstal. Di Nama proyek, masukkan nama proyek yang Anda buat di Jenkins, sepertiMyDemoProject, lalu pilih Ber ikutnya.

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

    Pilih Berikutnya.

13. Pada Langkah 6: Tambahkan tahap penerapan, gunakan kembali CodeDeploy aplikasi dan grup penerapan yang Anda buatTutorial: Buat pipeline sederhana (bucket S3). Di Penye dia Deplo y, pilih CodeDeploy. Di Nama aplikasi CodePipelineDemoApplication, masukkan, atau pilih tombol refresh, lalu pilih nama aplikasi dari daftar. Di grup Deployment CodePipelineDemoFleet, masukkan, atau pilih dari daftar, lalu pilih Ber ikutnya.

    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 informasi, lalu pilih Buat pipeline.

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

Untuk memverifikasi alamat IP dari instance tempat Anda menerapkan kode

1. Setelah Suk ses ditampilkan untuk status pipeline, di area status untuk tahap Staging, pilih Detail.

2. Di bagian Detil Deployment, di Inst ance ID, pilih ID instance dari salah satu instans yang berhasil digunakan.

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 I tem, masukkan nama untuk proyek Jenkins (misalnya,MyTestProject). Pilih proyek Freestyle, lalu pilih OK.

   catatan

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

3. Pada halaman konfigurasi untuk proyek, pilih kotak centang Jalankan build bersamaan jika perlu. Di Manajemen Kode Sumber, pilih AWS CodePipeline. Jika Anda telah menginstal Jenkins pada instance EC2 dan mengonfigurasinya 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 proyek tersebut tidak diinstal pada instans Amazon EC2, atau diinstal pada instans EC2 yang menjalankan sistem operasi Windows, lengkapi bidang seperti yang dipersyaratkan oleh host proxy dan pengaturan port Anda, dan berikan kredenSIAL pengguna atau peran IAM yang Anda konfigurasikan untuk integrasi antara Jenkins dan. CodePipeline

4. Pilih Lanjutan, dan di Kategori, pilih Tes.

5. Di Penye dia, masukkan nama yang sama 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 Trigg ers, kosongkan kotak centang apa pun, lalu pilih Poll SCM. Di Jadwal, masukkan lima tanda bintang yang dipisahkan oleh spasi, sebagai berikut:

   * * * * *

   Ini jajak pendapat CodePipeline setiap menit.

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

   TEST_IP_ADDRESS=192.168.0.4 rake test

   Jika Anda menerapkan ke instans Windows Server, pilih Jalan kan perintah batch, lalu masukkan yang berikut, di mana alamat IP adalah alamat instans EC2 yang Anda salin sebelumnya:

   set TEST_IP_ADDRESS=192.168.0.4 rake test

   catatan

   Tes 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 Tambahkan tindakan pasca-pembuatan, lalu pilih AWS CodePipeline Penerbit. Jangan pilih Tam bah.

9. Pilih Simpan untuk menyimpan proyek Jenkins Anda.

Untuk menambahkan tahap ke pipeline Anda yang menyertakan tindakan pengujian Jenkins

1. Masuk ke Konsol Manajemen AWS 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 rincian pipeline, pilih Edit.

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

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

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

   catatan

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

   Untuk informasi lebih lanjut tentang artefak input dan output serta struktur pipa, lihatCodePipeline referensi struktur pipa.

7. Pada halaman Edit, pilih S impan perubahan pipeline. Di kotak dialog Simpan perubahan pipeline, pilih S impan dan lanjutkan.

8. Meskipun tahap baru telah ditambahkan ke pipeline Anda, status Belum ada eksekusi ditampilkan untuk tahap tersebut karena tidak ada perubahan yang memicu proses pipeline lain. Untuk menjalankan sampel melalui pipeline yang direvisi, pada halaman detail pipeline, pilih R ilis perubahan.

   Tampilan pipeline menunjukkan tahapan dan tindakan dalam pipeline Anda dan status revisi yang berjalan melalui empat tahap tersebut. Waktu yang dibutuhkan pipeline 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 mesin Linux, macOS, atau Unix lokal Anda, atau command prompt 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 petunjuk di Membersihkan.

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

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

5. Jika Anda tidak bermaksud 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 petunjuk di Menghapus repositori di GitHub situs web.