Tutorial: Gunakan klon lengkap dengan sumber CodeCommit pipa

Anda dapat memilih opsi klon lengkap untuk tindakan CodeCommit sumber Anda di CodePipeline. Gunakan opsi ini CodeBuild untuk mengizinkan akses metadata Git dalam tindakan pembuatan pipeline Anda.

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

catatan

CodeBuild action adalah satu-satunya tindakan hilir yang mendukung penggunaan metadata Git yang tersedia dengan opsi klon Git. Selain itu, meskipun pipeline Anda dapat berisi tindakan lintas akun, CodeCommit tindakan dan CodeBuild tindakan harus berada di akun yang sama agar opsi klon lengkap berhasil.

Prasyarat

Sebelum memulai, Anda harus membuat CodeCommit repositori di AWS akun dan Wilayah yang sama dengan pipeline Anda.

Langkah 1: Buat file README

Gunakan langkah-langkah ini untuk menambahkan file README ke repositori sumber Anda. File README menyediakan file sumber contoh untuk tindakan CodeBuild hilir untuk dibaca.

Untuk menambahkan file README

1. Masuk ke repositori Anda dan pilih repositori Anda.

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

   This is a CodeCommit 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 aksi CodeCommit sumber.

• 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 MyCodeCommitPipeline.

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. Dalam peran Layanan, lakukan salah satu hal berikut:

   • Pilih Peran layanan yang ada.

   • Pilih peran CodePipeline layanan Anda yang ada. Peran ini harus memiliki izin codecommit:GetRepository IAM untuk kebijakan peran layanan Anda. Lihat Menambahkan izin ke peran CodePipeline layanan.

6. Di bawah Pengaturan lanjutan, biarkan default. Pilih Selanjutnya.

7. Pada Langkah 2: Tambahkan halaman tahap sumber, lakukan hal berikut:

   1. Di penyedia Sumber, pilih CodeCommit.

   2. Dalam nama Repositori, pilih nama repositori Anda.

   3. Di Nama cabang, pilih nama cabang Anda.

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

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

   Pilih Selanjutnya.

8. Di tahap Add build, lakukan hal berikut:

   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, lalu di bawah perintah Build paste kode berikut.

      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 describe --all
        #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 mengembalikan Anda ke CodePipeline konsol dan membuat CodeBuild proyek yang menggunakan perintah build 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: Perbarui kebijakan peran CodeBuild layanan untuk mengkloning repositori

Proses pipeline awal akan gagal karena Anda perlu memperbarui peran CodeBuild layanan dengan izin untuk menarik dari repositori Anda.

Tambahkan izin codecommit:GitPull IAM ke kebijakan peran layanan Anda. Untuk petunjuk memperbarui kebijakan di konsol IAM, lihatTambahkan CodeBuild GitClone izin untuk tindakan CodeCommit sumber.

Langkah 4: Lihat perintah repositori dalam output build

Untuk melihat 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 menjalankan. git describe --all