Buat pipeline di CodePipeline - AWS CodePipeline

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

Buat pipeline di CodePipeline

Anda dapat menggunakan AWS CodePipeline konsol atau AWS CLI untuk membuat pipeline. Pipa harus memiliki setidaknya dua tahap. Tahap pertama pipa harus menjadi tahap sumber. Pipeline harus memiliki setidaknya satu tahap lain yaitu tahap build atau deployment.

Anda dapat menambahkan tindakan ke pipeline yang berada di AWS Wilayah yang berbeda dari pipeline Anda. Tindakan lintas wilayah adalah tindakan di mana an Layanan AWS adalah penyedia tindakan dan tipe tindakan atau tipe penyedia berada di AWS Wilayah yang berbeda dari pipeline Anda. Untuk informasi selengkapnya, lihat Menambahkan tindakan Lintas wilayah diCodePipeline.

Anda juga dapat membuat pipeline yang membangun dan menyebarkan aplikasi berbasis container dengan menggunakan Amazon ECS sebagai penyedia penyebaran. Sebelum Anda membuat pipeline yang menyebarkan aplikasi berbasis container dengan Amazon ECS, Anda harus membuat file definisi gambar seperti yang dijelaskan dalam. Referensi berkas definisi gambar

CodePipeline menggunakan metode deteksi perubahan untuk memulai pipeline Anda saat perubahan kode sumber didorong. Metode deteksi ini didasarkan pada jenis sumber:

  • CodePipeline menggunakan Amazon CloudWatch Events untuk mendeteksi perubahan di repositori CodeCommit sumber dan cabang atau bucket sumber S3 Anda.

catatan

Saat Anda menggunakan konsol untuk membuat atau mengedit pipeline, sumber daya deteksi perubahan akan dibuat untuk Anda. Jika Anda menggunakan AWS CLI untuk membuat pipeline, Anda harus membuat sumber daya tambahan sendiri. Untuk informasi selengkapnya, lihat CodeCommit tindakan sumber dan EventBridge.

Buat pipeline (konsol)

Untuk membuat pipeline di konsol, Anda harus memberikan lokasi file sumber dan informasi tentang penyedia yang akan Anda gunakan untuk tindakan Anda.

Saat Anda menggunakan konsol untuk membuat pipeline, Anda harus menyertakan tahap sumber dan salah satu atau kedua hal berikut:

  • Panggung membangun.

  • Tahap penyebaran.

Saat Anda menggunakan wizard pipeline, CodePipeline buat nama tahapan (source, build, staging). Nama-nama ini tidak dapat diubah. Anda dapat menggunakan nama yang lebih spesifik (misalnya, BuildToGamma atau DeployToProd) ke tahapan yang Anda tambahkan nanti.

Langkah 1: Buat dan beri nama pipeline Anda
  1. Masuk ke AWS Management Console dan buka CodePipeline konsol di http://console.aws.amazon.com/codesuite/codepipeline/home.

  2. Pada halaman Selamat Datang, pilih Buat pipeline.

    Jika ini adalah pertama kalinya Anda menggunakan CodePipeline, pilih Memulai.

  3. Pada Langkah 1: Pilih halaman pengaturan pipeline, dalam nama Pipeline, masukkan nama untuk pipeline Anda.

    Dalam satu AWS akun, setiap pipeline yang Anda buat di AWS Wilayah harus memiliki nama yang unik. Nama dapat digunakan kembali untuk jaringan pipa di berbagai Wilayah.

    catatan

    Setelah Anda membuat pipeline, Anda tidak dapat mengubah namanya. Untuk informasi tentang batasan lainnya, lihatKuota di AWS CodePipeline.

  4. Dalam tipe Pipeline, pilih salah satu opsi berikut. Jenis pipa berbeda dalam karakteristik dan harga. Untuk informasi selengkapnya, lihat Jenis pipa.

    • Pipa tipe V1 memiliki struktur JSON yang berisi pipa standar, tahap, dan parameter tingkat aksi.

    • Pipeline tipe V2 memiliki struktur yang sama dengan tipe V1, bersama dengan dukungan parameter tambahan, seperti pemicu pada tag Git dan variabel tingkat pipa.

  5. Dalam peran Layanan, lakukan salah satu hal berikut:

    • Pilih Peran layanan baru CodePipeline untuk memungkinkan membuat peran layanan baru di IAM.

    • Pilih Peran layanan yang ada untuk menggunakan peran layanan yang sudah dibuat di IAM. Di ARN Peran, pilih ARN peran layanan Anda dari daftar.

    catatan

    Bergantung pada kapan peran layanan Anda dibuat, Anda mungkin perlu memperbarui izinnya untuk mendukung tambahanLayanan AWS. Untuk informasi, lihat Menambahkan izin ke peran CodePipeline layanan.

    Untuk informasi selengkapnya tentang peran layanan dan pernyataan kebijakannya, lihatKelola peran CodePipeline layanan.

  6. (Opsional) Di bawah Variabel, pilih Tambahkan variabel untuk menambahkan variabel di tingkat pipeline.

    Untuk informasi lebih lanjut tentang variabel di tingkat pipa, lihatVariabel. Untuk tutorial dengan variabel tingkat pipa yang dilewatkan pada saat eksekusi pipeline, lihat. Tutorial: Gunakan variabel tingkat pipa

    catatan

    Meskipun opsional untuk menambahkan variabel pada tingkat pipa, untuk pipeline yang ditentukan dengan variabel pada tingkat pipa di mana tidak ada nilai yang disediakan, eksekusi pipeline akan gagal.

  7. (Opsional) Perluas pengaturan lanjutan.

  8. Di toko Artifact, lakukan salah satu hal berikut:

    1. Pilih lokasi default untuk menggunakan penyimpanan artefak default, seperti bucket artefak S3 yang ditetapkan sebagai default, untuk pipeline di pipeline yang telah Wilayah AWS Anda pilih untuk pipeline Anda.

    2. Pilih Lokasi khusus jika Anda sudah memiliki toko artefak, seperti bucket artefak S3, di Wilayah yang sama dengan pipeline Anda. Di Bucket, pilih nama bucket.

    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. Saat membuat atau mengedit pipeline, Anda harus memiliki bucket artefak di Region pipeline dan satu bucket artefak per AWS Wilayah tempat Anda menjalankan tindakan.

    Lihat informasi yang lebih lengkap di Artefak input dan output dan CodePipeline referensi struktur pipa.

  9. Dalam kunci Enkripsi, lakukan salah satu hal berikut:

    1. Untuk menggunakan CodePipeline default AWS KMS key untuk mengenkripsi data di penyimpanan artefak pipeline (bucket S3), pilih Default AWS Managed Key.

    2. Untuk menggunakan kunci terkelola pelanggan Anda untuk mengenkripsi data di toko artefak pipeline (bucket S3), pilih Kunci yang Dikelola Pelanggan. Pilih ID kunci, kunci ARN, atau alias ARN.

  10. Pilih Berikutnya.

Langkah 2: Buat tahap sumber
  • Pada Langkah 2: Tambahkan halaman tahap sumber, di Penyedia sumber, pilih jenis repositori tempat kode sumber Anda disimpan, tentukan opsi yang diperlukan, lalu pilih Langkah berikutnya.

    • Untuk Bitbucket Cloud, GitHub (Versi 2), Server GitHub Perusahaan, GitLab .com, atau dikelola GitLab sendiri:

      1. Di bawah Koneksi, pilih koneksi yang ada atau buat yang baru. Untuk membuat atau mengelola koneksi untuk tindakan GitHub sumber Anda, lihatGitHub koneksi.

      2. Pilih repositori yang ingin Anda gunakan sebagai lokasi sumber untuk pipeline Anda.

        Pilih untuk menambahkan pemicu atau filter pada jenis pemicu untuk memulai pipeline Anda. Untuk informasi lebih lanjut tentang bekerja dengan pemicu, lihatFilter pemicu pada permintaan push atau pull kode. Untuk informasi selengkapnya tentang pemfilteran dengan pola glob, lihat. Bekerja dengan pola glob dalam sintaks

      3. Dalam format artefak Output, pilih format untuk artefak Anda.

        • Untuk menyimpan artefak keluaran dari GitHub tindakan menggunakan metode default, pilih CodePipelinedefault. Tindakan mengakses file dari GitHub repositori dan menyimpan artefak dalam file ZIP di toko artefak pipa.

        • Untuk menyimpan file JSON yang berisi referensi URL ke repositori sehingga tindakan hilir dapat melakukan perintah Git secara langsung, pilih klon Penuh. Opsi ini hanya dapat digunakan oleh tindakan CodeBuild hilir.

          Jika Anda memilih opsi ini, Anda perlu memperbarui izin untuk peran layanan CodeBuild proyek Anda seperti yang ditunjukkan padaPemecahan masalah CodePipeline. Untuk tutorial yang menunjukkan cara menggunakan opsi klon Penuh, lihatTutorial: Gunakan klon lengkap dengan sumber GitHub pipa.

    • Untuk Amazon S3:

      1. Di lokasi Amazon S3, berikan nama bucket S3 dan path ke objek dalam bucket dengan versi diaktifkan. Format nama bucket dan path terlihat seperti ini:

        s3://bucketName/folderName/objectName
        catatan

        Jika Amazon S3 adalah penyedia sumber untuk pipeline Anda, Anda dapat mem-zip file sumber atau file ke dalam satu .zip dan mengunggah.zip ke bucket sumber Anda. Anda juga dapat mengunggah satu file yang tidak di-zip; namun, tindakan hilir yang mengharapkan file.zip akan gagal.

      2. Setelah Anda memilih bucket sumber S3, CodePipeline buat aturan Amazon CloudWatch Events dan AWS CloudTrail jejak yang akan dibuat untuk pipeline ini. Terima default di bawah Ubah opsi deteksi. Hal ini memungkinkan Anda CodePipeline untuk menggunakan Amazon CloudWatch Events dan AWS CloudTrail mendeteksi perubahan pada pipeline baru Anda. Pilih Berikutnya.

    • Untuk AWS CodeCommit:

      • Dalam nama Repositori, pilih nama CodeCommit repositori yang ingin Anda gunakan sebagai lokasi sumber untuk pipeline Anda. Di Nama cabang, dari daftar drop-down, pilih cabang yang ingin Anda gunakan.

      • Dalam format artefak Output, pilih format untuk artefak Anda.

        • Untuk menyimpan artefak keluaran dari CodeCommit tindakan menggunakan metode default, pilih CodePipelinedefault. Tindakan mengakses file dari CodeCommit repositori dan menyimpan artefak dalam file ZIP di toko artefak pipa.

        • Untuk menyimpan file JSON yang berisi referensi URL ke repositori sehingga tindakan hilir dapat melakukan perintah Git secara langsung, pilih klon Penuh. Opsi ini hanya dapat digunakan oleh tindakan CodeBuild hilir.

          Jika Anda memilih opsi ini, Anda perlu menambahkan codecommit:GitPull izin ke peran CodeBuild layanan Anda seperti yang ditunjukkan padaMenambahkan CodeBuild GitClone izin untuk tindakan CodeCommit sumber. Anda juga perlu menambahkan codecommit:GetRepository izin ke peran CodePipeline layanan Anda seperti yang ditunjukkan padaMenambahkan izin ke peran CodePipeline layanan. Untuk tutorial yang menunjukkan cara menggunakan opsi klon Penuh, lihatTutorial: Gunakan klon lengkap dengan sumber GitHub pipa.

      • Setelah Anda memilih nama CodeCommit repositori dan cabang, pesan akan ditampilkan di Ubah opsi deteksi yang menunjukkan aturan Amazon CloudWatch Events yang akan dibuat untuk pipeline ini. Terima default di bawah Ubah opsi deteksi. Hal ini CodePipeline memungkinkan Anda menggunakan Amazon CloudWatch Events untuk mendeteksi perubahan pada pipeline baru Anda.

    • Untuk Amazon ECR:

      • Dalam nama Repositori, pilih nama repositori Amazon ECR Anda.

      • Di tag Gambar, tentukan nama dan versi gambar, jika berbeda dari TERBARU.

      • Di artefak Output, pilih artefak keluaran default MyApp, seperti, yang berisi nama gambar dan informasi URI repositori yang ingin digunakan tahap selanjutnya.

        Untuk tutorial tentang membuat pipeline untuk Amazon ECS dengan penerapan CodeDeploy biru-hijau yang menyertakan tahap sumber Amazon ECR, lihat. Tutorial: Membuat pipeline dengan sumber Amazon ECR dan penerapan ECS-to- CodeDeploy

      Saat Anda menyertakan tahap sumber ECR Amazon dalam pipeline, tindakan sumber akan menghasilkan imageDetail.json file sebagai artefak keluaran saat Anda melakukan perubahan. Untuk informasi tentang imageDetail.json file, lihatFile ImageDetail.json untuk tindakan penyebaran biru/hijau Amazon ECS.

    catatan

    Objek dan jenis file harus kompatibel dengan sistem penyebaran yang Anda rencanakan untuk digunakan (misalnya, Elastic Beanstalk atau). CodeDeploy Jenis file yang didukung mungkin termasuk file.zip, .tar, dan .tgz. Untuk informasi selengkapnya tentang jenis kontainer yang didukung untuk Elastic Beanstalk, lihat Menyesuaikan dan Mengonfigurasi Lingkungan Elastic Beanstalk dan Platform yang Didukung. Untuk informasi selengkapnya tentang menerapkan revisi dengan CodeDeploy, lihat Mengunggah Revisi Aplikasi Anda dan Mempersiapkan Revisi.

Langkah 3: Buat tahap build

Langkah ini opsional jika Anda berencana untuk membuat tahap penerapan.

  • Pada Langkah 3: Tambahkan halaman tahap build, lakukan salah satu hal berikut, lalu pilih Berikutnya:

    • Pilih Lewati tahap build jika Anda berencana membuat tahap penerapan.

    • Dari penyedia Build, pilih penyedia tindakan khusus untuk layanan build, dan berikan detail konfigurasi untuk penyedia tersebut. Untuk contoh cara menambahkan Jenkins sebagai penyedia build, lihatTutorial: Buat pipeline empat tahap.

    • Dari penyedia Build, pilih AWS CodeBuild.

      Di Wilayah, pilih AWS Wilayah tempat sumber daya ada. Bidang Region menentukan tempat AWS sumber daya dibuat untuk tipe tindakan dan jenis penyedia ini. Bidang ini hanya ditampilkan untuk tindakan di mana penyedia tindakan adalahLayanan AWS. Bidang Region default ke AWS Region yang sama dengan pipeline Anda.

      Dalam nama Project, pilih proyek build Anda. Jika Anda telah membuat proyek build di CodeBuild, pilihlah. Atau Anda dapat membuat proyek build CodeBuild dan kemudian kembali ke tugas ini. Ikuti petunjuk di Buat Pipeline yang Digunakan CodeBuild di Panduan CodeBuild Pengguna.

      Dalam variabel Lingkungan, untuk menambahkan variabel CodeBuild lingkungan ke tindakan build Anda, pilih Tambahkan variabel lingkungan. Setiap variabel terdiri dari tiga entri:

      • Dalam Nama, masukkan nama atau kunci variabel lingkungan.

      • Dalam Nilai, masukkan nilai variabel lingkungan. Jika Anda memilih Parameter untuk tipe variabel, pastikan nilai ini adalah nama parameter yang telah Anda simpan di AWS Systems Manager Parameter Store.

        catatan

        Kami sangat tidak menyarankan penggunaan variabel lingkungan untuk menyimpan nilai sensitif, terutama AWS kredensil. Saat Anda menggunakan CodeBuild konsol atau AWS CLI, variabel lingkungan ditampilkan dalam teks biasa. Untuk nilai sensitif, kami sarankan Anda menggunakan tipe Parameter sebagai gantinya.

      • (Opsional) Dalam Jenis, masukkan jenis variabel lingkungan. Nilai yang valid adalah Plaintext atau Parameter. Defaultnya adalah Plaintext.

      (Opsional) Dalam tipe Build, pilih salah satu dari berikut ini:

      • Untuk menjalankan setiap build dalam satu eksekusi aksi build, pilih Single build.

      • Untuk menjalankan beberapa build dalam eksekusi aksi build yang sama, pilih Batch build.

      (Opsional) Jika Anda memilih untuk menjalankan build batch, Anda dapat memilih Gabungkan semua artefak dari batch ke satu lokasi untuk menempatkan semua artefak build ke dalam artefak keluaran tunggal.

Langkah 4: Buat tahap penyebaran

Langkah ini opsional jika Anda telah membuat tahap build.

  • Pada Langkah 4: Tambahkan halaman tahap penerapan, lakukan salah satu hal berikut, lalu pilih Berikutnya:

    • Pilih Lewati tahap penerapan jika Anda membuat tahap build di langkah sebelumnya.

      catatan

      Opsi ini tidak muncul jika Anda telah melewati tahap build.

    • Di penyedia Deploy, pilih tindakan kustom yang telah Anda buat untuk penyedia penerapan.

      Di Wilayah, hanya untuk tindakan Lintas wilayah, pilih AWS Wilayah tempat sumber daya dibuat. Bidang Region menentukan tempat AWS sumber daya dibuat untuk tipe tindakan dan jenis penyedia ini. Bidang ini hanya menampilkan tindakan di mana penyedia tindakan adalahLayanan AWS. Bidang Region default ke AWS Region yang sama dengan pipeline Anda.

    • Di penyedia Deploy, bidang tersedia untuk penyedia default sebagai berikut:

      • CodeDeploy

        Dalam nama Aplikasi, masukkan atau pilih nama CodeDeploy aplikasi yang ada. Di grup Deployment, masukkan nama grup penyebaran untuk aplikasi. Pilih Berikutnya. Anda juga dapat membuat aplikasi, grup penyebaran, atau keduanya di CodeDeploy konsol.

      • AWS Elastic Beanstalk

        Pada nama Aplikasi, masukkan atau pilih nama aplikasi Elastic Beanstalk yang ada. Dalam nama Lingkungan, masukkan lingkungan untuk aplikasi. Pilih Berikutnya. Anda juga dapat membuat aplikasi, lingkungan, atau keduanya di konsol Elastic Beanstalk.

      • AWS OpsWorks Stacks

        Di Stack, masukkan atau pilih nama tumpukan yang ingin Anda gunakan. Di Layer, pilih layer yang menjadi milik instance target Anda. Di App, pilih aplikasi yang ingin Anda perbarui dan terapkan. Jika Anda perlu membuat aplikasi, pilih Buat yang baru di AWS OpsWorks.

        Untuk informasi tentang menambahkan aplikasi ke tumpukan dan lapisanAWS OpsWorks, lihat Menambahkan Aplikasi di Panduan AWS OpsWorks Pengguna.

        Untuk end-to-end contoh cara menggunakan pipeline sederhana CodePipeline sebagai sumber kode yang Anda jalankan pada AWS OpsWorks lapisan, lihat Menggunakan CodePipeline dengan AWS OpsWorks Stacks.

      • AWS CloudFormation

        Lakukan salah satu dari cara berikut:

        • Dalam mode Tindakan, pilih Buat atau perbarui tumpukan, masukkan nama tumpukan dan nama file templat, lalu pilih nama peran AWS CloudFormation untuk diasumsikan. Secara opsional, masukkan nama file konfigurasi dan pilih opsi kemampuan IAM.

        • Dalam mode Tindakan, pilih Buat atau ganti set perubahan, masukkan nama tumpukan dan ubah nama set, lalu pilih nama peran AWS CloudFormation untuk diasumsikan. Secara opsional, masukkan nama file konfigurasi dan pilih opsi kemampuan IAM.

        Untuk informasi tentang mengintegrasikan AWS CloudFormation kemampuan ke dalam pipeline CodePipeline, lihat Pengiriman Berkelanjutan dengan CodePipeline di Panduan AWS CloudFormation Pengguna.

      • Amazon ECS

        Dalam nama Cluster, masukkan atau pilih nama cluster Amazon ECS yang ada. Di Nama layanan, masukkan atau pilih nama layanan yang berjalan di cluster. Anda juga dapat membuat cluster dan layanan. Dalam nama file Image, masukkan nama file definisi gambar yang menjelaskan wadah dan gambar layanan Anda.

        catatan

        Tindakan penyebaran Amazon ECS memerlukan imagedefinitions.json file sebagai masukan untuk tindakan penerapan. Nama file default untuk fille adalah imagedefinitions.json. Jika Anda memilih untuk menggunakan nama file yang berbeda, Anda harus menyediakannya saat membuat tahap penerapan pipeline. Untuk informasi selengkapnya, lihat file imagedefinitions.json untuk tindakan penerapan standar Amazon ECS.

        Pilih Berikutnya.

        catatan

        Pastikan klaster Amazon ECS Anda dikonfigurasi dengan dua instans atau lebih. Cluster Amazon ECS harus berisi setidaknya dua instans sehingga satu dipertahankan sebagai instans utama dan yang lain digunakan untuk mengakomodasi penerapan baru.

        Untuk tutorial tentang penerapan aplikasi berbasis container dengan pipeline Anda, lihat Tutorial: Continuous Deployment with. CodePipeline

      • Amazon ECS (Biru/Hijau)

        Masukkan grup CodeDeploy aplikasi dan penyebaran, definisi tugas Amazon ECS, dan informasi AppSpec file, lalu pilih Berikutnya.

        catatan

        Tindakan Amazon ECS (Biru/Hijau) memerlukan file ImageDetail.json sebagai artefak masukan untuk tindakan penerapan. Karena tindakan sumber Amazon ECR membuat file ini, saluran pipa dengan tindakan sumber Amazon ECR tidak perlu menyediakan file. imageDetail.json Untuk informasi selengkapnya, lihat File ImageDetail.json untuk tindakan penyebaran biru/hijau Amazon ECS.

        Untuk tutorial tentang membuat pipeline untuk penerapan biru-hijau ke cluster Amazon ECS dengan, lihat. CodeDeploy Tutorial: Membuat pipeline dengan sumber Amazon ECR dan penerapan ECS-to- CodeDeploy

      • AWS Service Catalog

        Pilih Masukkan konfigurasi penerapan jika Anda ingin menggunakan bidang di konsol untuk menentukan konfigurasi Anda, atau pilih File konfigurasi jika Anda memiliki file konfigurasi terpisah. Masukkan informasi produk dan konfigurasi, lalu pilih Berikutnya.

        Untuk tutorial tentang menerapkan perubahan produk ke Service Catalog dengan pipeline Anda, lihatTutorial: Buat pipeline yang di-deploy ke Service Catalog.

      • Kit Keterampilan Alexa

        Di Alexa Skill ID, masukkan ID keterampilan untuk keterampilan Alexa Anda. Dalam ID Klien dan rahasia Klien, masukkan kredensil yang dihasilkan menggunakan profil keamanan Login with Amazon (LWA). Di token Refresh, masukkan token penyegaran yang Anda buat menggunakan perintah ASK CLI untuk mengambil token penyegaran. Pilih Berikutnya.

        Untuk tutorial tentang menerapkan keterampilan Alexa dengan pipeline Anda dan menghasilkan kredenal LWA, lihat. Tutorial: Buat pipeline yang menerapkan keterampilan Amazon Alexa

      • Amazon S3

        Di Bucket, masukkan nama bucket S3 yang ingin Anda gunakan. Pilih Ekstrak file sebelum menerapkan jika artefak input ke tahap penerapan Anda adalah file ZIP. Jika Ekstrak file sebelum penerapan dipilih, Anda dapat secara opsional memasukkan nilai untuk jalur Deployment tempat file ZIP Anda akan dibuka ritsletingnya. Jika tidak dipilih, Anda diminta untuk memasukkan nilai dalam kunci objek S3.

        catatan

        Sebagian besar artefak keluaran tahap sumber dan build di-zip. Semua penyedia sumber pipeline kecuali Amazon S3 mem-zip file sumber Anda sebelum menyediakannya sebagai artefak input ke tindakan selanjutnya.

        (Opsional) Di ACL Kalengan, masukkan ACL kalengan untuk diterapkan ke objek yang disebarkan ke Amazon S3.

        catatan

        Menerapkan ACL kalengan menimpa ACL yang ada yang diterapkan ke objek.

        (Opsional) Dalam kontrol Cache, tentukan parameter kontrol cache untuk permintaan mengunduh objek dari ember. Untuk daftar nilai yang valid, lihat bidang Cache-Controlheader untuk operasi HTTP. Untuk memasukkan beberapa nilai dalam kontrol Cache, gunakan koma di antara setiap nilai. Anda dapat menambahkan spasi setelah setiap koma (opsional), seperti yang ditunjukkan dalam contoh ini.

        Contoh entri sebelumnya ditampilkan di CLI sebagai berikut:

        "CacheControl": "public, max-age=0, no-transform"

        Pilih Berikutnya.

        Untuk tutorial tentang membuat pipeline dengan penyedia tindakan penerapan Amazon S3, lihat. Tutorial: Membuat pipeline yang menggunakan Amazon S3 sebagai penyedia penerapan

Langkah 5: Tinjau pipa
  • Pada Langkah 5: Tinjau halaman, tinjau konfigurasi pipeline Anda, lalu pilih Buat pipeline untuk membuat pipeline atau Sebelumnya untuk kembali dan mengedit pilihan Anda. Untuk keluar dari wizard tanpa membuat pipeline, pilih Batal.

Sekarang setelah Anda membuat pipeline, Anda dapat melihatnya di konsol. Pipeline mulai berjalan setelah Anda membuatnya. Untuk informasi selengkapnya, lihat Lihat saluran pipa dan detailnya di CodePipeline. Untuk informasi selengkapnya tentang membuat perubahan pada pipeline Anda, lihatEdit pipa di CodePipeline.

Buat pipeline (CLI)

Untuk menggunakan AWS CLI untuk membuat pipeline, Anda membuat file JSON untuk menentukan struktur pipa, dan kemudian menjalankan create-pipeline perintah dengan --cli-input-json parameter.

penting

Anda tidak dapat menggunakan AWS CLI untuk membuat pipeline yang mencakup tindakan mitra. Anda harus menggunakan CodePipeline konsol sebagai gantinya.

Untuk informasi selengkapnya tentang struktur pipeline, lihat CodePipeline referensi struktur pipa dan buat-pipeline di Referensi API. CodePipeline

Untuk membuat file JSON, gunakan file JSON pipeline sampel, edit, lalu panggil file itu saat Anda menjalankan perintah. create-pipeline

Prasyarat:

Anda memerlukan ARN dari peran layanan yang Anda buat CodePipeline . Memulai dengan CodePipeline Anda menggunakan ARN peran CodePipeline layanan dalam file JSON pipeline saat Anda menjalankan perintah. create-pipeline Untuk informasi selengkapnya tentang pembuatan peran layanan, lihat Buat peran CodePipeline layanan. Berbeda dengan konsol, menjalankan create-pipeline perintah di AWS CLI tidak memiliki opsi untuk membuat peran CodePipeline layanan untuk Anda. Peran layanan harus sudah ada.

Anda memerlukan nama ember S3 tempat artefak untuk pipa disimpan. Bucket ini harus berada di Wilayah yang sama dengan pipa. Anda menggunakan nama bucket dalam file JSON pipeline saat Anda menjalankan create-pipeline perintah. Berbeda dengan konsol, menjalankan create-pipeline perintah di AWS CLI tidak membuat bucket S3 untuk menyimpan artefak. Bucket harus sudah ada.

catatan

Anda juga dapat menggunakan get-pipeline perintah untuk mendapatkan salinan struktur JSON dari pipeline itu, dan kemudian memodifikasi struktur itu dalam editor teks biasa.

Topik
    Untuk membuat file JSON
    1. Di terminal (Linux, macOS, atau Unix) atau command prompt (Windows), buat file teks baru di direktori lokal.

    2. (Opsional) Anda dapat menambahkan satu atau lebih variabel di tingkat pipa. Anda dapat mereferensikan nilai ini dalam konfigurasi CodePipeline tindakan. Anda dapat menambahkan nama dan nilai variabel saat membuat pipeline, dan Anda juga dapat memilih untuk menetapkan nilai saat memulai pipeline di konsol.

      catatan

      Meskipun opsional untuk menambahkan variabel pada tingkat pipa, untuk pipeline yang ditentukan dengan variabel pada tingkat pipa di mana tidak ada nilai yang disediakan, eksekusi pipeline akan gagal.

      Variabel pada tingkat pipa diselesaikan pada waktu proses pipa. Semua variabel tidak dapat diubah, artinya tidak dapat diperbarui setelah nilai ditetapkan. Variabel pada tingkat pipeline dengan nilai yang diselesaikan akan ditampilkan dalam riwayat untuk setiap eksekusi.

      Anda menyediakan variabel pada tingkat pipeline menggunakan atribut variabel dalam struktur pipa. Dalam contoh berikut, variabel Variable1 memiliki nilaiValue1.

      "variables": [ { "name": "Timeout", "defaultValue": "1000", "description": "description" } ]

      Tambahkan struktur ini ke JSON pipeline Anda, atau ke contoh JSON pada langkah berikut. Untuk informasi selengkapnya tentang variabel, termasuk informasi namespace, lihat. Variabel

    3. Buka file di editor teks biasa dan edit nilainya untuk mencerminkan struktur yang ingin Anda buat. Minimal, Anda harus mengubah nama pipa. Anda juga harus mempertimbangkan apakah Anda ingin berubah:

      • Bucket S3 tempat artefak untuk pipa ini disimpan.

      • Lokasi sumber untuk kode Anda.

      • Penyedia penyebaran.

      • Bagaimana Anda ingin kode Anda diterapkan.

      • Tag untuk pipeline Anda.

      Struktur pipa sampel dua tahap berikut menyoroti nilai yang harus Anda pertimbangkan untuk diubah untuk pipa Anda. Pipeline Anda kemungkinan berisi lebih dari dua tahap:

      { "pipeline": { "roleArn": "arn:aws:iam::80398EXAMPLE::role/AWS-CodePipeline-Service", "stages": [ { "name": "Source", "actions": [ { "inputArtifacts": [], "name": "Source", "actionTypeId": { "category": "Source", "owner": "AWS", "version": "1", "provider": "S3" }, "outputArtifacts": [ { "name": "MyApp" } ], "configuration": { "S3Bucket": "awscodepipeline-demobucket-example-date", "S3ObjectKey": "ExampleCodePipelineSampleBundle.zip", "PollForSourceChanges": "false" }, "runOrder": 1 } ] }, { "name": "Staging", "actions": [ { "inputArtifacts": [ { "name": "MyApp" } ], "name": "Deploy-CodeDeploy-Application", "actionTypeId": { "category": "Deploy", "owner": "AWS", "version": "1", "provider": "CodeDeploy" }, "outputArtifacts": [], "configuration": { "ApplicationName": "CodePipelineDemoApplication", "DeploymentGroupName": "CodePipelineDemoFleet" }, "runOrder": 1 } ] } ], "artifactStore": { "type": "S3", "location": "codepipeline-us-east-2-250656481468" }, "name": "MyFirstPipeline", "version": 1, "variables": [ { "name": "Timeout", "defaultValue": "1000", "description": "description" } ] }, "triggers": [ { "providerType": "CodeStarSourceConnection", "gitConfiguration": { "sourceActionName": "Source", "push": [ { "tags": { "includes": [ "v1" ], "excludes": [ "v2" ] } } ] } } ] "metadata": { "pipelineArn": "arn:aws:codepipeline:us-east-2:80398EXAMPLE:MyFirstPipeline", "updated": 1501626591.112, "created": 1501626591.112 }, "tags": [{ "key": "Project", "value": "ProjectA" }] }

      Contoh ini menambahkan penandaan ke pipeline dengan menyertakan kunci Project tag dan ProjectA nilai pada pipeline. Untuk informasi selengkapnya tentang menandai sumber daya CodePipeline, lihatPenandaan pada sumber daya .

      Pastikan PollForSourceChanges parameter dalam file JSON Anda diatur sebagai berikut:

      "PollForSourceChanges": "false",

      CodePipeline menggunakan Amazon CloudWatch Events untuk mendeteksi perubahan di repositori CodeCommit sumber dan cabang atau bucket sumber S3 Anda. Langkah selanjutnya mencakup instruksi untuk membuat sumber daya ini secara manual untuk pipeline Anda. Menyetel bendera untuk false menonaktifkan pemeriksaan berkala, yang tidak diperlukan saat Anda menggunakan metode deteksi perubahan yang disarankan.

    4. Untuk membuat tindakan build, test, atau deploy di Region yang berbeda dari pipeline, Anda harus menambahkan hal berikut ke struktur pipeline. Untuk petunjuk, lihat Menambahkan tindakan Lintas wilayah diCodePipeline.

      • Tambahkan Region parameter ke struktur pipeline tindakan Anda.

      • Gunakan artifactStores parameter untuk menentukan bucket artefak untuk setiap AWS Wilayah tempat Anda memiliki tindakan.

    5. Ketika Anda puas dengan strukturnya, simpan file Anda dengan nama sepertipipeline.json.

    Untuk membuat pipa
    1. Jalankan create-pipeline perintah dan gunakan --cli-input-json parameter untuk menentukan file JSON yang Anda buat sebelumnya.

      Untuk membuat pipeline bernama MySecondPipelinedengan file JSON bernama pipeline.json yang menyertakan nama "MySecondPipeline" sebagai nilai untuk name di JSON, perintah Anda akan terlihat seperti berikut:

      aws codepipeline create-pipeline --cli-input-json file://pipeline.json
      penting

      Pastikan untuk menyertakan file:// sebelum nama file. Diperlukan dalam perintah ini.

      Perintah ini mengembalikan struktur seluruh pipeline yang Anda buat.

    2. Untuk melihat pipeline, buka CodePipeline konsol dan pilih dari daftar pipeline, atau gunakan get-pipeline-state perintah. Untuk informasi selengkapnya, lihat Lihat saluran pipa dan detailnya di CodePipeline.

    3. Jika Anda menggunakan CLI untuk membuat pipeline, Anda harus secara manual membuat sumber daya deteksi perubahan yang direkomendasikan untuk pipeline Anda: