Tutorial: Gunakan klon lengkap dengan sumber GitHub pipa - AWS CodePipeline

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Tutorial: Gunakan klon lengkap dengan sumber GitHub pipa

Anda dapat memilih opsi klon lengkap untuk tindakan GitHub sumber Anda di CodePipeline. Gunakan opsi ini untuk menjalankan CodeBuild perintah untuk metadata Git dalam tindakan pembuatan pipeline Anda.

catatan

Opsi klon lengkap yang dijelaskan di sini mengacu pada menentukan apakah CodePipeline harus mengkloning metadata repositori, yang hanya dapat digunakan oleh perintah. CodeBuild Untuk menggunakan token akses GitHub pengguna untuk digunakan dengan CodeBuild proyek, ikuti langkah-langkah di sini untuk menginstal AWS Konektor untuk GitHub aplikasi dan kemudian biarkan bidang Instalasi aplikasi kosong. CodeConnections akan menggunakan token akses pengguna untuk koneksi.

penting

Sebagai bagian dari pembuatan pipa, ember artefak S3 yang disediakan oleh pelanggan akan digunakan CodePipeline untuk artefak. (Ini berbeda dari bucket yang digunakan untuk aksi sumber S3.) Jika bucket artefak S3 berada di akun yang berbeda dari akun untuk pipeline Anda, pastikan bucket artefak S3 dimiliki oleh Akun AWS yang aman dan dapat diandalkan.

Dalam tutorial ini, Anda akan membuat pipeline yang terhubung ke GitHub repositori Anda, menggunakan opsi klon lengkap untuk data sumber, dan menjalankan CodeBuild build yang mengkloning repositori Anda dan melakukan perintah Git untuk repositori.

catatan

Fitur ini tidak tersedia di Asia Pasifik (Hong Kong), Afrika (Cape Town), Timur Tengah (Bahrain), Eropa (Zurich), atau AWS GovCloud (AS-Barat). 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 kredensyal Anda.

Langkah 1: Buat README file

Setelah Anda membuat GitHub repositori Anda, gunakan langkah-langkah ini untuk menambahkan file. README

  1. Masuk ke repositori Anda dan pilih GitHub repositori Anda.

  2. Untuk membuat file baru, pilih Tambah file > Buat file baru. Beri nama fileREADME.md. file dan tambahkan teks berikut.

    This is a GitHub repository!
  3. Pilih Perubahan commit.

    Pastikan file README.md berada di tingkat root repositori Anda..

Langkah 2: Buat pipeline Anda dan bangun proyek

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 MyGitHubPipeline.

  4. Dalam tipe Pipeline, pilih V1 untuk keperluan tutorial ini. Anda juga dapat memilih V2; Namun, perhatikan bahwa 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 codestar-connections:UseConnection IAM izin 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.

      Anda menginstal satu aplikasi untuk semua koneksi Anda ke penyedia tertentu. Jika Anda telah menginstal AWS Connector for GitHub app, pilih dan lewati langkah ini.

      catatan

      Jika Anda ingin membuat token akses pengguna, pastikan Anda telah menginstal AWS Connector for GitHub app lalu biarkan bidang Instalasi aplikasi kosong. CodeConnections akan menggunakan token akses pengguna untuk koneksi. Untuk informasi selengkapnya, lihat Mengakses penyedia sumber Anda di CodeBuild.

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

    4. Dalam nama Branch, pilih cabang repositori yang ingin Anda gunakan.

    5. Pastikan opsi Mulai pipeline pada perubahan kode sumber dipilih.

    6. Di bawah Format artefak keluaran, pilih Klon penuh untuk mengaktifkan opsi klon Git untuk repositori sumber. Hanya tindakan yang disediakan oleh yang CodeBuild dapat menggunakan opsi klon Git. Anda akan menggunakan Langkah 3: Perbarui kebijakan peran CodeBuild layanan untuk menggunakan koneksi dalam tutorial ini untuk memperbarui izin untuk peran layanan CodeBuild proyek Anda untuk menggunakan opsi ini.

    Pilih Berikutnya.

  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.

      catatan

      Di env bagian spesifikasi build, pastikan credential helper untuk perintah git diaktifkan seperti yang ditunjukkan dalam contoh ini.

      version: 0.2 env: 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 # name: version #commands: # - command # - command pre_build: commands: - ls -lt - cat README.md build: commands: - git log | head -100 - git status - ls - git archive --format=zip HEAD > application.zip #post_build: #commands: # - command # - command artifacts: files: - application.zip # - 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 Layanan AWS 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: Perbarui kebijakan peran CodeBuild layanan untuk menggunakan koneksi

Proses pipeline awal akan gagal karena peran CodeBuild layanan harus diperbarui dengan izin untuk menggunakan koneksi. Tambahkan codestar-connections:UseConnection IAM izin ke kebijakan peran layanan Anda. Untuk petunjuk memperbarui kebijakan di IAM konsol, lihatTambahkan CodeBuild GitClone izin untuk koneksi ke Bitbucket,, GitHub Enterprise Server GitHub, atau .com GitLab.

Langkah 4: Lihat perintah repositori dalam output build

  1. Jika peran layanan Anda berhasil diperbarui, pilih Coba lagi pada CodeBuild tahap yang gagal.

  2. Setelah pipeline berjalan dengan sukses, pada tahap build yang berhasil, pilih Lihat detail.

    Pada halaman detail, pilih tab Log. Lihat output CodeBuild build. Perintah menampilkan nilai variabel yang dimasukkan.

    Perintah menampilkan isi README.md file, daftar file dalam direktori, mengkloning repositori, melihat log, dan mengarsipkan repositori sebagai file. ZIP