Buat pipeline, tahapan, dan tindakan

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 JSON struktur 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 baruIAM.

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

   catatan

   Bergantung pada kapan peran layanan Anda dibuat, Anda mungkin perlu memperbarui izinnya untuk mendukung tambahan Layanan 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, lihatReferensi variabel. 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 Wilayah pipeline dan satu bucket artefak per AWS Wilayah tempat Anda menjalankan tindakan.

   Untuk informasi selengkapnya, silakan lihat 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, kunciARN, atau aliasARN.

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 selengkapnya 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 ZIP file di toko artefak pipa.

       • Untuk menyimpan JSON file yang berisi URL referensi 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 ZIP file di toko artefak pipa.

      • Untuk menyimpan JSON file yang berisi URL referensi 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 padaTambahkan 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 dariLATEST.

    • Di artefak Output, pilih artefak keluaran default, seperti MyApp, yang berisi nama gambar dan URI informasi repositori yang Anda inginkan untuk digunakan pada tahap berikutnya.

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

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

  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 adalah Layanan 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 kredenal. 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 adalah Layanan 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 lapisan AWS 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 hal berikut ini:

      • 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 IAM kemampuan.

      • 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 IAM kemampuan.

      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 ECS cluster Amazon 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 ECS penyebaran Amazon 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 ECS klaster Amazon Anda dikonfigurasi dengan dua instans atau lebih. ECSCluster Amazon harus berisi setidaknya dua instance sehingga satu dipertahankan sebagai instance 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 ECS tugas Amazon, dan informasi AppSpec file, lalu pilih Berikutnya.

      catatan

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

      Untuk tutorial tentang membuat pipeline untuk penerapan biru-hijau ke ECS cluster Amazon dengan, lihat. CodeDeploy Tutorial: Membuat pipeline dengan ECR sumber Amazon dan ECS -to- deployment 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. Di Client ID dan Client secret, masukkan kredensi yang dihasilkan menggunakan profil keamanan Login with Amazon (LWA). Di token Refresh, masukkan token penyegaran yang Anda buat menggunakan ASK CLI perintah untuk mengambil token penyegaran. Pilih Berikutnya.

      Untuk tutorial tentang menerapkan keterampilan Alexa dengan pipeline Anda dan menghasilkan LWA kredensialnya, 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 ZIP file 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 Canned ACL, masukkan kaleng ACL untuk diterapkan ke objek yang disebarkan ke Amazon S3.

      catatan

      Menerapkan kaleng ACL menimpa apa pun yang ada yang ACL 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 HTTP operasi. 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 dalam 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.

Untuk membuat JSON file

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 pipeline AndaJSON, atau ke contoh JSON di langkah berikut. Untuk informasi selengkapnya tentang variabel, termasuk informasi namespace, lihat. Referensi 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": "amzn-s3-demo-source-bucket",
                               "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 JSON file 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, silakan lihat Menambahkan tindakan Lintas wilayah di CodePipeline.

   • 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 JSON file yang Anda buat sebelumnya.

   Untuk membuat pipeline bernama MySecondPipeline dengan JSON file bernama pipeline.json yang menyertakan nama”MySecondPipeline“sebagai nilai untuk name diJSON, 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 detail di CodePipeline.

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

   • Untuk pipeline dengan CodeCommit repositori, Anda harus membuat aturan CloudWatch Peristiwa secara manual, seperti yang dijelaskan dalam. Buat EventBridge aturan untuk CodeCommit sumber (CLI)

   • Untuk pipeline dengan sumber Amazon S3, Anda harus membuat aturan dan AWS CloudTrail jejak CloudWatch Acara secara manual, seperti yang dijelaskan dalam. Menghubungkan ke tindakan sumber Amazon S3 yang menggunakan dan EventBridge AWS CloudTrail