Tutorial: Gunakan tag Git untuk memulai pipeline Anda

Dalam tutorial ini, Anda akan membuat pipeline yang terhubung ke GitHub repositori Anda di mana tindakan sumber dikonfigurasi untuk jenis pemicu tag Git. Ketika tag Git dibuat pada komit, pipeline Anda dimulai. Contoh ini menunjukkan cara membuat pipeline yang memungkinkan pemfilteran tag berdasarkan sintaks nama tag. Untuk informasi selengkapnya tentang pemfilteran dengan pola glob, lihat. Bekerja dengan pola glob dalam sintaks

Tutorial ini terhubung ke GitHub melalui tipe CodeStarSourceConnection tindakan.

catatan

Fitur ini tidak tersedia di Wilayah Asia Pasifik (Hong Kong), Afrika (Cape Town), Timur Tengah (Bahrain), atau Eropa (Zurich). Untuk mereferensikan tindakan lain yang tersedia, lihatIntegrasi produk dan layanan dengan CodePipeline. Untuk pertimbangan dengan tindakan ini di Wilayah Eropa (Milan), lihat catatan diCodeStarSourceConnection untuk Bitbucket Cloud, GitHub Enterprise Server GitHub, GitLab .com, dan tindakan yang dikelola GitLab sendiri.

Prasyarat

Sebelum Anda mulai, Anda harus melakukan hal berikut:

• Buat GitHub repositori dengan akun Anda GitHub .

• Siapkan GitHub kredensialmu. Ketika Anda menggunakan AWS Management Console untuk mengatur koneksi, Anda diminta untuk masuk dengan GitHub kredensi Anda.

Langkah 1: Buka CloudShell dan kloning repositori Anda

Anda dapat menggunakan antarmuka baris perintah untuk mengkloning repositori Anda, membuat komit, dan menambahkan tag. Tutorial ini meluncurkan CloudShell contoh untuk antarmuka baris perintah.

1. Masuk ke AWS Management Console.

2. Di bilah navigasi atas, pilih AWS ikon. Halaman utama AWS Management Console tampilan.

3. Di bilah navigasi atas, pilih AWS CloudShell ikon. CloudShell terbuka. Tunggu sementara CloudShell lingkungan dibuat.

   catatan

   Jika Anda tidak melihat CloudShell ikon, pastikan Anda berada di Wilayah yang didukung oleh CloudShell. Tutorial ini mengasumsikan Anda berada di Wilayah AS Barat (Oregon).

4. Masuk GitHub, arahkan ke repositori Anda. Pilih Kode, lalu pilih HTTPS. Salin jalurnya. Alamat untuk mengkloning repositori Git Anda disalin ke clipboard Anda.

5. Jalankan perintah berikut untuk mengkloning repositori.

   git clone https://github.com/<account>/MyGitHubRepo.git

6. Masukkan GitHub akun Anda Username dan Password saat diminta. Untuk Password entri, Anda harus menggunakan token yang dibuat pengguna daripada kata sandi akun Anda.

Langkah 2: Buat pipeline untuk memicu tag Git

Dalam bagian ini, Anda membuat alur dengan tindakan berikut:

• Tahap sumber dengan koneksi ke GitHub repositori dan tindakan Anda.

• Tahap build dengan aksi AWS CodeBuild build.

Untuk membuat alur dengan wizard

1. Masuk ke CodePipeline konsol di https://console.aws.amazon.com/codepipeline/.

2. Pada halaman Selamat Datang, halaman Memulai, atau halaman Alur, pilih Buat alur.

3. Di Langkah 1: Pilih pengaturan alur, di Nama alur, masukkan MyGitHubTagsPipeline.

4. Dalam tipe Pipeline, pertahankan pilihan default di V2. Jenis pipa berbeda dalam karakteristik dan harga. Untuk informasi selengkapnya, lihat Jenis pipa.

5. Di Peran layanan, pilih Peran layanan baru.

   catatan

   Jika Anda memilih untuk menggunakan peran CodePipeline layanan yang ada, pastikan Anda telah menambahkan izin codestar-connections:UseConnection IAM ke kebijakan peran layanan Anda. Untuk petunjuk tentang peran CodePipeline layanan, lihat Menambahkan izin ke peran CodePipeline layanan.

6. Di bawah Pengaturan lanjutan, biarkan default. Di Penyimpanan artifact, pilih Lokasi default untuk menggunakan penyimpanan artifact default, seperti bucket artifact Amazon S3 yang ditetapkan sebagai default, untuk alur Anda di Wilayah yang Anda pilih untuk alur Anda.

   catatan

   Ini bukan bucket sumber untuk kode sumber Anda. Ini adalah penyimpanan artifact untuk alur Anda. Penyimpanan artifact terpisah, seperti bucket S3, diperlukan untuk setiap alur.

   Pilih Selanjutnya.

7. Pada halaman Langkah 2: Tambahkan tahap sumber, tambahkan tahap sumber:

   1. Di penyedia Sumber, pilih GitHub (Versi 2).

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

   3. Dalam nama Repositori, pilih nama repositori Anda GitHub.

   4. Di bawah pemicu Pipeline, pilih tag Git.

      Di bidang Sertakan, masukkanrelease*.

      Di cabang Default, pilih cabang yang ingin Anda tentukan saat pipeline dimulai secara manual atau dengan peristiwa sumber yang bukan tag Git. Jika sumber perubahan bukan pemicu atau jika eksekusi pipeline dimulai secara manual, maka perubahan yang digunakan akan menjadi komit HEAD dari cabang default.

      penting

      Pipeline yang dimulai dengan jenis pemicu tag Git akan dikonfigurasi untuk peristiwa WebHookv2 dan tidak akan menggunakan peristiwa Webhook (deteksi perubahan pada semua peristiwa push) untuk memulai pipeline.

   Pilih Selanjutnya.

8. Di Tambahkan tahap membangun, tambahkan sebuah tahap membangun:

   1. Di Penyedia pembangunan, pilih AWS CodeBuild. Izinkan Wilayah ke default ke Wilayah alur.

   2. Pilih Buat proyek.

   3. Di Nama proyek, masukkan nama untuk proyek pembangunan ini.

   4. Di Citra lingkungan, pilih Citra terkelola. Untuk Sistem operasi, pilih Ubuntu.

   5. Untuk Waktu aktif, pilih Standar. Untuk Gambar, pilih aws/codebuild/standard:5.0.

   6. Untuk Peran layanan, pilih Peran layanan baru.

      catatan

      Perhatikan nama peran CodeBuild layanan Anda. Anda akan membutuhkan nama peran untuk langkah terakhir dalam tutorial ini.

   7. Pada Buildspec, untuk Spesifikasi membangun, pilih Sisipkan perintah membangun. Pilih Beralih ke editor, dan tempel yang berikut ini di bawah perintah Build.

      version: 0.2
      #env:
        #variables:
           # key: "value"
           # key: "value"
        #parameter-store:
           # key: "value"
           # key: "value"
        #git-credential-helper: yes
      phases:
        install:
          #If you use the Ubuntu standard image 2.0 or later, you must specify runtime-versions.
          #If you specify runtime-versions and use an image other than Ubuntu standard image 2.0, the build fails.
          runtime-versions:
            nodejs: 12
          #commands:
            # - command
            # - command
        #pre_build:
          #commands:
            # - command
            # - command
        build:
          commands:
            - 
        #post_build:
          #commands:
            # - command
            # - command
      artifacts:
        files:
           - '*'
          # - location
        name: $(date +%Y-%m-%d)
        #discard-paths: yes
        #base-directory: location
      #cache:
        #paths:
          # - paths

   8. Pilih Lanjutkan ke CodePipeline. Ini kembali ke CodePipeline konsol dan membuat CodeBuild proyek yang menggunakan perintah build Anda untuk konfigurasi. Proyek build menggunakan peran layanan untuk mengelola AWS layanan izin. Langkah ini mungkin memakan waktu beberapa menit.

   9. Pilih Selanjutnya.

9. Pada halaman Langkah 4: Tambahkan tahap men-deploy, pilih Lewati tahap men-deploy, dan kemudian terima pesan peringatan dengan memilih Lewati lagi. Pilih Selanjutnya.

10. Pada Langkah 5: Tinjauan, pilih Buat alur.

Langkah 3: Tandai komit Anda untuk rilis

Setelah Anda membuat pipeline dan menentukan tag Git, Anda dapat menandai commit di GitHub repositori Anda. Dalam langkah-langkah ini, Anda akan menandai komit dengan release-1 tag. Setiap komit dalam repositori Git harus memiliki tag Git yang unik. Saat Anda memilih komit dan menandainya, ini memungkinkan Anda untuk memasukkan perubahan dari cabang yang berbeda ke dalam penerapan pipeline Anda. Perhatikan bahwa rilis nama tag tidak berlaku untuk konsep rilis di GitHub.

1. Referensikan ID komit yang disalin yang ingin Anda tag. Untuk melihat komit di setiap cabang, di CloudShell terminal, masukkan perintah berikut untuk menangkap ID komit yang ingin Anda tag:

   git log

2. Di CloudShell terminal, masukkan perintah untuk menandai komit Anda dan dorong ke asal. Setelah Anda menandai komit Anda, Anda menggunakan perintah git push untuk mendorong tag ke asal. Dalam contoh berikut, masukkan perintah berikut untuk menggunakan release-1 tag untuk komit kedua dengan ID49366bd. Tag ini akan disaring oleh filter release* tag pipeline dan akan memulai pipeline.

   git tag release-1 49366bd

   git push origin release-1

   

Langkah 4: Lepaskan perubahan dan lihat log

1. Setelah pipeline berjalan dengan sukses, pada tahap build yang berhasil, pilih Lihat log.

   Di bawah Log, lihat keluaran CodeBuild build. Perintah menampilkan nilai variabel yang dimasukkan.

2. Di halaman Riwayat, lihat kolom Pemicu. Lihat tipe pemicu GitTag : release-1.