View a markdown version of this page

Tutorial: Gunakan klon penuh dengan sumber CodeCommit pipeline - AWS CodePipeline
PrasyaratLangkah 1: Buat file READMELangkah 2: Buat pipeline Anda dan bangun proyekLangkah 3: Perbarui kebijakan peran CodeBuild layanan untuk mengkloning repositoriLangkah 4: Lihat perintah repositori dalam output build

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 CodeCommit pipeline

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

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

catatan

CodeBuild tindakan 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 kloning penuh berhasil.

penting

Sebagai bagian dari pembuatan pipeline, bucket artefak S3 yang disediakan oleh pelanggan akan digunakan oleh 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 itu aman dan dapat diandalkan.

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 Tam bah file > Buat file. Beri nama file README.md 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 tindakan CodeCommit sumber.

  • Tahap membangun dengan aksi AWS CodeBuild membangun.

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. Pada Langkah 1: Pilih halaman opsi pembuatan, di bawah Opsi pembuatan, pilih opsi Build custom pipeline. Pilih Berikutnya.

  4. Di Langkah 2: Pilih pengaturan pipa, di Nama Pipeline, masukkanMyCodeCommitPipeline.

  5. CodePipeline menyediakan pipa tipe V1 dan V2, yang berbeda dalam karakteristik dan harga. Jenis V2 adalah satu-satunya jenis yang dapat Anda pilih di konsol. Untuk informasi selengkapnya, lihat Jenis jalur. Untuk informasi tentang penetapan harga untuk CodePipeline, lihat Harga.

  6. Di Peran Layanan, lakukan salah satu hal berikut:

  7. Di bawah Pengaturan lanj utan, tinggalkan default. Pilih Berikutnya.

  8. Pada Langkah 3: Tambahkan halaman tahap sumber, lakukan hal berikut:

    1. Di Penyedia Sumber, pilih CodeCommit.

    2. Di Nama Repositori, pilih nama repositori Anda.

    3. Di Nama cabang, pilih nama cabang Anda.

    4. Pastikan opsi Mulai pipa 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 CodeBuild yang dapat menggunakan opsi klon Git.

    Pilih Berikutnya.

  9. Pada Langkah 4: Tambahkan tahap 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

      Catat nama peran CodeBuild layanan Anda. Anda akan memerlukan nama peran untuk langkah terakhir dalam tutorial ini.

    7. Pada Buildspec, untuk Spesifikasi membangun, pilih Sisipkan perintah membangun. Pilih Beralih ke editor, dan kemudian di bawah perintah build tempel 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 Anda untuk konfigurasi. Proyek build menggunakan peran layanan untuk mengelola Layanan AWS izin. Langkah ini mungkin memakan waktu beberapa menit.

    9. Pilih Berikutnya.

  10. Pada Langkah 5: Tambahkan tahap pengujian, pilih Lewati tahap pengujian, lalu terima pesan peringatan dengan memilih Le wati lagi.

    Pilih Berikutnya.

  11. Pada halaman Langkah 6: Tambahkan tahap penerapan, pilih Lewati tahap pener apan, lalu terima pesan peringatan dengan memilih Le wati lagi. Pilih Berikutnya.

  12. Pada Langkah 7: Tinjau, pilih Buat pipeline.

Langkah 3: Perbarui kebijakan peran CodeBuild layanan untuk mengkloning repositori

Jalur pipa 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 untuk memperbarui kebijakan di konsol IAM, lihatTambahkan CodeBuild GitClone izin untuk tindakan CodeCommit sumber.

Langkah 4: Lihat perintah repositori dalam output build

Untuk melihat keluaran build

  1. Ketika peran layanan Anda berhasil diperbarui, pilih C oba lagi pada CodeBuild tahap gagal.

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

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

    Perintah menampilkan konten README.md file, mencantumkan file di direktori, mengkloning repositori, melihat log, dan jalankangit describe --all.