Tutorial: Gunakan klon penuh dengan sumber pipa GitHub - 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 penuh dengan sumber pipa GitHub

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

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

catatan

Fitur ini tidak tersedia di Wilayah Asia Pacific (Hong Kong) dan Europe (Milan). Untuk referensi tindakan lain yang tersedia, lihatIntegrasi produk dan layanan dengan CodePipeline.

Prasyarat

Sebelum memulai, Anda harus melakukan hal berikut:

  • Buat repositori GitHub dengan akun GitHub Anda.

  • Siapkan kredensi GitHub Anda. Saat Anda menggunakanAWS Management ConsoleUntuk mengatur koneksi, Anda akan diminta untuk masuk dengan kredensi GitHub Anda.

Langkah 1: Membuat file README

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

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

  2. Untuk membuat file baru, pilihTambahkan file > Buat file baru. 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: Membuat alur Anda dan membangun proyek

Dalam bagian ini, Anda membuat alur dengan tindakan berikut:

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

  • Tahap membangun dengan tindakan membangun AWS CodeBuild.

Untuk membuat alur dengan wizard

  1. Masuk ke konsol CodePipeline 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 pipa, diNama pipa, masukkanMyGitHubPipeline.

  4. Di Peran layanan, pilih Buat peran layanan.

    catatan

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

  5. MasukToko Artifact, pilihLokasi defaultuntuk menggunakan toko artefak default

    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.

  6. Di Langkah 2: Tambahkan tahap sumberhalaman, tambahkan tahap sumber:

    1. MasukPenyedia sumber, pilihGitHub.

    2. Di bawahKoneksi, pilih koneksi yang ada atau buat yang baru. Untuk membuat atau mengelola koneksi untuk tindakan sumber GitHub Anda, lihatKoneksi GitHub.

    3. MasukNama repositori, pilih nama repositori GitHub Anda.

    4. MasukNama cabang, pilih cabang repositori yang ingin Anda gunakan.

    5. MemiilihKloning penuhuntuk mengaktifkan opsi git clone untuk repositori sumber. Hanya tindakan yang disediakan oleh CodeBuild dapat menggunakan opsi git clone. Anda akan menggunakanLangkah 3: Memperbarui kebijakan peran layanan CodeBuild untuk menggunakan koneksidalam tutorial ini untuk memperbarui izin untuk peran layanan proyek CodeBuild Anda untuk menggunakan opsi ini.

    Pilih Selanjutnya.

  7. 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 Citra, pilih aws/codebuild/standard:4.0.

    6. Untuk Peran layanan, pilih Peran layanan baru.

      catatan

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

    7. Pada Buildspec, untuk Spesifikasi membangun, pilih Sisipkan perintah membangun. MemiilihBeralih ke editor, dan tempel berikut di bawahMembangun perintah.

      catatan

      Dienvbagian dari spesifikasi build, pastikan helper credential 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: 10 # 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. Hal ini mengembalikan ke konsol CodePipeline dan membuat sebuah proyek CodeBuild yang menggunakan perintah membangun Anda untuk konfigurasi. Proyek membangun menggunakan peran layanan untuk mengelolaAWSizin layanan. Langkah ini mungkin memakan waktu beberapa menit.

    9. Pilih Selanjutnya.

  8. PadaLangkah 4: Tambahkan tahaphalaman, pilihLewati tahap, dan kemudian menerima pesan peringatan dengan memilihLewatilagi. Pilih Selanjutnya.

  9. PadaLangkah 5: Tinjau, pilihMembuat alur.

Langkah 3: Memperbarui kebijakan peran layanan CodeBuild untuk menggunakan koneksi

Jalankan pipeline awal akan gagal karena peran layanan CodeBuild harus diperbarui dengan izin untuk menggunakan koneksi. Tambahkancodestar-connections:UseConnectionIAM izin untuk kebijakan peran layanan Anda. Untuk petunjuk untuk memperbarui kebijakan di konsol IAM, lihatTambahkan CodeBuild Izin GitClone untuk koneksi ke Bitbucket, GitHub, atau GitHub Server Perusahaan.

Langkah 4: Lihat perintah repositori dalam output build

  1. Saat peran layanan Anda berhasil diperbarui, pilihCoba ulangpada tahap CodeBuild gagal.

  2. Setelah alur berjalan dengan sukses, pada tahap membangun Anda yang berhasil, pilihRincian.

    Pada Detail eksekusi, lihat output pembangunan CodeBuild. Perintah outputREADME.mdisi file, daftar file dalam direktori, mengkloning repositori, melihat log, dan arsip repositori sebagai file ZIP.