Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
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.
Topik
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.
-
Masuk ke AWS Management Console.
-
Di bilah navigasi atas, pilih AWS ikon. Halaman utama AWS Management Console tampilan.
-
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).
-
Masuk GitHub, arahkan ke repositori Anda. Pilih Kode, lalu pilih HTTPS. Salin jalurnya. Alamat untuk mengkloning repositori Git Anda disalin ke clipboard Anda.
-
Jalankan perintah berikut untuk mengkloning repositori.
git clone https://github.com/<account>/MyGitHubRepo.git
-
Masukkan GitHub akun Anda
Username
danPassword
saat diminta. UntukPassword
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
-
Masuk ke CodePipeline konsol di https://console.aws.amazon.com/codepipeline/
. -
Pada halaman Selamat Datang, halaman Memulai, atau halaman Alur, pilih Buat alur.
-
Di Langkah 1: Pilih pengaturan alur, di Nama alur, masukkan
MyGitHubTagsPipeline
. -
Dalam tipe Pipeline, pertahankan pilihan default di V2. Jenis pipa berbeda dalam karakteristik dan harga. Untuk informasi selengkapnya, lihat Jenis pipa.
-
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. -
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.
-
Pada halaman Langkah 2: Tambahkan tahap sumber, tambahkan tahap sumber:
-
Di penyedia Sumber, pilih GitHub (Versi 2).
-
Di bawah Koneksi, pilih koneksi yang ada atau buat yang baru. Untuk membuat atau mengelola koneksi untuk tindakan GitHub sumber Anda, lihatGitHub koneksi.
-
Dalam nama Repositori, pilih nama repositori Anda GitHub.
-
Di bawah pemicu Pipeline, pilih tag Git.
Di bidang Sertakan, masukkan
release*
.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.
-
-
Di Tambahkan tahap membangun, tambahkan sebuah tahap membangun:
-
Di Penyedia pembangunan, pilih AWS CodeBuild. Izinkan Wilayah ke default ke Wilayah alur.
-
Pilih Buat proyek.
-
Di Nama proyek, masukkan nama untuk proyek pembangunan ini.
-
Di Citra lingkungan, pilih Citra terkelola. Untuk Sistem operasi, pilih Ubuntu.
-
Untuk Waktu aktif, pilih Standar. Untuk Gambar, pilih aws/codebuild/standard:5.0.
-
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.
-
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
-
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.
-
Pilih Selanjutnya.
-
-
Pada halaman Langkah 4: Tambahkan tahap men-deploy, pilih Lewati tahap men-deploy, dan kemudian terima pesan peringatan dengan memilih Lewati lagi. Pilih Selanjutnya.
-
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.
-
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
-
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 filterrelease*
tag pipeline dan akan memulai pipeline.git tag release-1 49366bd
git push origin release-1
Langkah 4: Lepaskan perubahan dan lihat log
-
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.
-
Di halaman Riwayat, lihat kolom Pemicu. Lihat tipe pemicu GitTag : release-1.