Buat pipa 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 pipa di CodePipeline

Anda dapat menggunakanAWS CodePipelinekonsol atauAWS CLIuntuk membuat pipa. Pipa harus memiliki setidaknya dua tahap. Tahap pertama dari pipa harus menjadi tahap sumber. Pipa harus memiliki setidaknya satu tahap lain yang merupakan tahap membangun atau penyebaran.

Anda dapat menambahkan tindakan ke saluran pipa yang ada diAWSWilayah berbeda dari pipa Anda. Sebuah tindakan lintas wilayah adalah salah satu di manaAWSlayanan adalah penyedia untuk tindakan dan jenis tindakan atau jenis penyedia berada dalamAWSWilayah berbeda dari pipa Anda. Untuk informasi selengkapnya, lihat Tambahkan aksi lintas Wilayah di CodePipeline.

Anda juga dapat membuat jaringan pipa yang membangun dan menerapkan aplikasi berbasis kontainer dengan menggunakan Amazon ECS sebagai penyedia penyebaran. Sebelum membuat pipeline yang menyebarkan aplikasi berbasis kontainer dengan Amazon ECS, Anda harus membuat file definisi gambar seperti yang dijelaskan diReferensi file definisi gambar.

CodePipeline menggunakan metode deteksi perubahan untuk memulai pipa Anda ketika perubahan kode sumber didorong. Metode deteksi ini didasarkan pada tipe sumber:

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

catatan

Bila Anda menggunakan konsol untuk membuat atau mengedit pipeline, sumber daya deteksi perubahan dibuat untuk Anda. Jika Anda menggunakanAWSCLI untuk membuat pipa, Anda harus membuat sumber daya tambahan sendiri. Untuk informasi selengkapnya, lihat CodeCommit tindakan sumber dan CloudWatch Peristiwa.

Buat pipeline (konsol)

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

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

  • Tahap build.

  • Tahap deployment.

Ketika Anda menggunakan wizard pipa, CodePipeline menciptakan nama tahapan (sumber, membangun, pementasan). Nama-nama ini tidak dapat diubah. Anda dapat menggunakan nama yang lebih spesifik (misalnya, BuildToGamma atau DeployToProd) untuk tahapan yang Anda tambahkan nanti.

Langkah 1: Buat dan beri nama pipa Anda

  1. Masuk keAWS Management Consoledan buka konsol CodePipeline dihttp://console.aws.amazon.com/codesuite/codepipeline/home.

  2. PadaSelamat datanghalaman, pilihMembuat Alur.

    Jika ini adalah pertama kalinya Anda menggunakan CodePipeline, pilihMemulai.

  3. Di Langkah 1: Pilih pengaturan pipahalaman, diNama pipa, masukkan nama untuk alur Anda.

    Dalam satuAWSakun, setiap pipa yang Anda buat dalamAWSWilayah harus memiliki nama yang unik. Nama dapat digunakan kembali untuk jaringan pipa di berbagai Daerah.

    catatan

    Setelah membuat alur, Anda tidak dapat mengubah namanya. Untuk informasi tentang batasan lainnya, lihatQuotaAWSCodePipeline.

  4. MasukPeran layanan, lakukan salah satu hal berikut:

    • PilihPeran layanan baruuntuk memungkinkan CodePipeline untuk membuat peran layanan baru di IAM.

    • PilihPeran layanan yang adauntuk menggunakan peran layanan yang sudah dibuat di IAM. MasukARN Peran, pilih peran layanan Anda dari daftar.

    catatan

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

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

  5. (Opsional) MemperluasPengaturan lanjutan.

  6. MasukToko Artifact, lakukan salah satu hal berikut:

    1. PilihLokasi defaultuntuk menggunakan penyimpanan artifact default, seperti bucket artifact S3 yang ditetapkan sebagai default, untuk alur Anda diWilayah AWSAnda telah memilih untuk alur Anda.

    2. PilihLokasi kustomjika Anda sudah memiliki toko artifact, seperti bucket artifact S3, di Wilayah yang sama dengan alur Anda. MasukBucket, 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. Ketika Anda membuat atau mengedit pipa, Anda harus memiliki ember artefak di daerah pipa dan satu ember artefak perAWSWilayah di mana Anda menjalankan tindakan.

    Untuk informasi selengkapnya, lihat artefak input dan Referensi struktur pipa CodePipeline.

  7. MasukKunci enkripsi, lakukan salah satu hal berikut:

    1. Untuk menggunakan default CodePipelineAWS KMS keyuntuk mengenkripsi data di toko artefak pipa (S3 ember), pilihDefaultAWSKunci Terkelola.

    2. Menggunakankunci yang dikelola pelangganuntuk mengenkripsi data di toko artefak pipa (S3 ember), pilihKunci yang dikelola. CID kunci, ARN kunci, atau ARN alias.

  8. Pilih Selanjutnya.

Langkah 2: Membuat tahap

  • Di Langkah 2: Menambahkan tahaphalaman, diPenyedia sumber, pilih jenis repositori tempat kode sumber Anda disimpan, tentukan opsi yang diperlukan, lalu pilihLangkah selanjutnya.

    • UntukGitHub:

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

      2. Pilih repositori GitHub yang ingin Anda gunakan sebagai lokasi sumber untuk alur Anda. MasukCabang, dari daftar tarik-turun, pilih cabang yang ingin Anda gunakan.

      3. MasukFormat artefak, pilih format artefak Anda.

        • Untuk menyimpan artefak keluaran dari aksi GitHub menggunakan metode default, pilihStandar CodePipeline. Tindakan mengakses file dari repositori GitHub 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, pilihKloning penuh. Opsi ini hanya dapat digunakan oleh tindakan hilir CodeBuild.

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

    • UntukAmazon S3:

      1. MasukLokasi Amazon S3, memberikan 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

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

      2. Setelah Anda memilih bucket sumber S3, CodePipeline membuat aturan Amazon CloudWatch Events danAWS CloudTrailjejak yang akan dibuat untuk pipa ini. Menerima default di bawahUbah opsi deteksi. Hal ini memungkinkan CodePipeline untuk menggunakan Amazon CloudWatch Events danAWS CloudTrailuntuk mendeteksi perubahan untuk pipa baru Anda. Pilih Selanjutnya.

    • Untuk AWS CodeCommit:

      • MasukNama repositori, pilih nama repositori CodeCommit yang ingin Anda gunakan sebagai lokasi sumber untuk alur Anda. MasukNama cabang, dari daftar tarik-turun, pilih cabang yang ingin Anda gunakan.

      • MasukFormat artefak, pilih format artefak Anda.

        • Untuk menyimpan artefak keluaran dari tindakan CodeCommit menggunakan metode default, pilihStandar CodePipeline. Tindakan mengakses file dari repositori CodeCommit 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, pilihKloning penuh. Opsi ini hanya dapat digunakan oleh tindakan hilir CodeBuild.

          Jika Anda memilih opsi ini, Anda perlu menambahkancodecommit:GitPullizin untuk peran layanan CodeBuild Anda seperti yang ditunjukkan diTambahkan CodeBuild Izin GitClone untuk tindakan sumber CodeCommit. Anda juga perlu menambahkancodecommit:GetRepositoryizin untuk peran layanan CodePipeline Anda seperti yang ditunjukkan dalamMenambahkan izin ke peran layanan CodePipeline. Untuk tutorial yang menunjukkan cara menggunakanKloning penuhpilihan, lihatTutorial: Gunakan klon penuh dengan sumber pipa GitHub.

      • Setelah Anda memilih nama repositori CodeCommit dan cabang, pesan akan ditampilkan diUbah opsi deteksimenampilkan aturan Amazon CloudWatch Events yang akan dibuat untuk pipeline ini. Menerima default di bawahUbah opsi deteksi. Hal ini memungkinkan CodePipeline untuk menggunakan Amazon CloudWatch Events untuk mendeteksi perubahan alur baru Anda.

    • UntukAmazon ECR:

      • MasukNama repositori, pilih nama repositori Amazon ECR Anda.

      • MasukTanda citra, tentukan nama gambar dan versi, jika berbeda dari TERBARU.

      • Masukartefak, pilih output artefak default, seperti MyApp, yang berisi nama gambar dan repositori informasi URI Anda ingin tahap berikutnya untuk menggunakan.

        Untuk tutorial tentang membuat pipeline untuk Amazon ECS dengan penerapan biru-hijau CodeDeploy yang mencakup tahap sumber Amazon ECR, lihatTutorial: Buat pipeline dengan sumber Amazon ECR dan penyebaran ECS-to-Codedeploy.

      Bila Anda menyertakan tahap sumber Amazon ECR di pipeline Anda, tindakan sumber akan menghasilkanimageDetail.jsonfile sebagai artefak keluaran ketika Anda melakukan perubahan. Untuk informasi tentangimageDetail.jsonfile, lihatFile ImageDetail.json untuk tindakan penyebaran biru/hijau Amazon ECS.

    catatan

    Objek dan jenis file harus kompatibel dengan sistem penyebaran yang akan Anda gunakan (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, lihatMenyesuaikan dan Mengonfigurasi Lingkungan Elastic BeanstalkdanPlatform yang Didukung. Untuk informasi selengkapnya tentang menyebarkan revisi dengan CodeDeploy, lihatMengunggah Revisi Aplikasi AndadanSiapkan Revisi.

Langkah 3: Membuat tahap

Langkah ini opsional jika Anda berencana untuk membuat tahap penyebaran.

  • PadaLangkah 3: Menambahkan tahaphalaman, lakukan salah satu hal berikut, lalu pilihSelanjutnya:

    • PilihLewati tahapjika Anda berencana untuk membuat tahap penyebaran.

    • FromPenyedia, pilih penyedia tindakan kustom layanan build, dan berikan detail konfigurasi untuk penyedia tersebut. Untuk contoh cara menambahkan Jenkins sebagai penyedia build, lihatTutorial: Buat pipa empat tahap.

    • FromPenyedia, pilihAWS CodeBuild.

      MasukWilayah, pilihAWSWilayah di mana sumber daya ada. ParameterWilayahbidang menunjuk di manaAWSsumber daya dibuat untuk jenis tindakan dan jenis penyedia ini. Bidang ini ditampilkan hanya untuk tindakan di mana penyedia tindakan adalahAWSlayanan. ParameterWilayahdefault bidang yang samaAWSWilayah sebagai pipa Anda.

      MasukNama Proyek, pilih proyek build Anda. Jika Anda telah membuat proyek build di CodeBuild, pilihlah. Atau Anda dapat membuat proyek membangun di CodeBuild dan kemudian kembali ke tugas ini. Ikuti petunjuknyaBuat Pipeline yang Menggunakan CodeBuilddiPanduan CodeBuild.

      MasukVariabel lingkungan, untuk menambahkan variabel lingkungan CodeBuild ke aksi build Anda, pilihMenambahkan variabel lingkungan. Setiap variabel terdiri dari tiga entri:

      • MasukNama, masukkan nama atau kunci dari variabel lingkungan.

      • MasukNilai, masukkan nilai variabel lingkungan. Jika Anda memilihParameteruntuk tipe variabel, pastikan nilai ini adalah nama parameter yang telah Anda simpanAWSSystems Manager Parameter Store.

        catatan

        Kami sangat mencegah penggunaan variabel lingkungan untuk menyimpan nilai-nilai sensitif, terutamaAWSID kunci rahasia dan kunci akses rahasia. Saat Anda menggunakan konsol CodeBuild atauAWSCLI, variabel lingkungan ditampilkan dalam teks biasa. Untuk nilai sensitif, kami menyarankan Anda menggunakanParameterketik sebagai gantinya.

      • (Opsional) DalamJenis, masukkan jenis variabel lingkungan. Nilai yang valid adalahTeks biasaatauParameter. Default-nyaTeks biasa.

      (Opsional) DalamTipe build, pilih salah satu hal berikut:

      • Untuk menjalankan setiap build dalam eksekusi aksi build tunggal, pilihPembangunan tunggal.

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

      (Opsional) Jika Anda memilih untuk menjalankan batch build, Anda dapat memilihGabungkan semua artefak dari batch ke satu lokasiuntuk menempatkan semua membangun artefak menjadi artefak keluaran tunggal.

Langkah 4: Membuat tahap deployment

Langkah ini opsional jika Anda telah membuat tahap membangun.

  • PadaLangkah 4: Menambahkan deployhalaman, lakukan salah satu hal berikut, lalu pilihSelanjutnya:

    • PilihLewati deployjika Anda membuat tahap membangun pada langkah sebelumnya.

      catatan

      Opsi ini tidak muncul jika Anda telah melewatkan tahap build.

    • MasukPenyedia, pilih tindakan khusus yang telah Anda buat untuk penyedia penyebaran.

      MasukWilayah, hanya untuk tindakan lintas wilayah, pilihAWSWilayah di mana sumber daya dibuat. ParameterWilayahbidang menunjuk di manaAWSsumber daya dibuat untuk jenis tindakan dan jenis penyedia ini. Bidang ini hanya menampilkan untuk tindakan di mana penyedia tindakan adalahAWSlayanan. ParameterWilayahdefault bidang yang samaAWSWilayah sebagai pipa Anda.

    • MasukPenyedia, bidang yang tersedia untuk penyedia default sebagai berikut:

      • CodeDeploy

        MasukNama aplikasi, masukkan atau pilih nama aplikasi CodeDeploy yang ada. MasukGrup deployment, masukkan nama grup deployment untuk aplikasi. Pilih Selanjutnya. Anda juga dapat membuat aplikasi, grup penyebaran, atau keduanya di konsol CodeDeploy.

      • AWS Elastic Beanstalk

        MasukNama aplikasi, masukkan atau pilih nama aplikasi Elastic Beanstalk yang ada. MasukNama lingkungan, masukkan lingkungan untuk aplikasi. Pilih Selanjutnya. Anda juga dapat membuat aplikasi, lingkungan, atau keduanya di konsol Elastic Beanstalk.

      • AWS OpsWorks Stacks

        MasukTumpukan, masukkan atau pilih nama tumpukan yang ingin Anda gunakan. MasukLapisan, pilih layer yang dimiliki instance target Anda. MasukAplikasi, pilih aplikasi yang ingin Anda perbarui dan deploy. Jika Anda perlu membuat aplikasi, pilihBuat yang baru diAWS OpsWorks.

        Untuk informasi tentang menambahkan aplikasi ke stack dan layer diAWS OpsWorks, lihatMenambahkan Aplikasidi dalamAWS OpsWorksPanduan Pengguna.

        Untuk contoh menyeluruh tentang cara menggunakan alur sederhana di CodePipeline sebagai sumber kode yang Anda jalankanAWS OpsWorkslapisan, lihatMenggunakan CodePipelineAWS OpsWorks Stacks.

      • AWS CloudFormation

        Lakukan salah satu dari berikut:

        • MasukMode tindakan, pilihMembuat atau memperbarui tumpukan, masukkan nama stack dan nama file template, dan kemudian pilih nama peran untukAWS CloudFormationuntuk berasumsi. Opsional, masukkan nama file konfigurasi dan pilih opsi kemampuan IAM.

        • MasukMode tindakan, pilihMembuat atau mengganti set perubahan, masukkan nama stack dan mengubah nama set, dan kemudian pilih nama peran untukAWS CloudFormationuntuk berasumsi. Opsional, masukkan nama file konfigurasi dan pilih opsi kemampuan IAM.

        Untuk informasi tentang integrasiAWS CloudFormationkemampuan ke dalam pipa di CodePipeline, lihatPengiriman Berkelanjutan dengan CodePipelinedi dalamAWS CloudFormationPanduan Pengguna.

      • Amazon ECS

        MasukNama klaster, masukkan atau pilih nama klaster Amazon ECS yang sudah ada. MasukNama layanan, masukkan atau pilih nama layanan yang berjalan di klaster. Anda juga dapat membuat klaster dan layanan. MasukNama file gambar, masukkan nama file definisi gambar yang menggambarkan wadah dan gambar layanan Anda.

        catatan

        Tindakan penyebaran Amazon ECS memerlukanimagedefinitions.jsonfile sebagai masukan untuk tindakan penyebaran. Nama file default untuk file adalah imagedefinitions.json. Jika Anda memilih untuk menggunakan nama file, Anda harus memberikannya ketika Anda membuat tahap penyebaran pipa. Untuk informasi selengkapnya, lihat file imagedefinitions.json untuk tindakan penerapan standar Amazon ECS.

        Pilih Next (Berikutnya).

        catatan

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

        Untuk tutorial tentang menerapkan aplikasi berbasis kontainer dengan pipeline Anda, lihatTutorial: Penyebaran Berkelanjutan dengan CodePipeline.

      • Amazon ECS (Biru/Hijau)

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

        catatan

        ParameterAmazon ECS (Biru/Hijau)tindakan membutuhkan file ImageDetail.json sebagai artefak masukan untuk aksi penyebaran. Karena tindakan sumber Amazon ECR membuat file ini, jaringan pipa dengan tindakan sumber Amazon ECR tidak perlu menyediakanimageDetail.jsonberkas. Untuk informasi selengkapnya, lihat File ImageDetail.json untuk tindakan penyebaran biru/hijau Amazon ECS.

        Untuk tutorial tentang membuat pipeline untuk penyebaran biru-hijau ke klaster Amazon ECS dengan CodeDeploy, lihatTutorial: Buat pipeline dengan sumber Amazon ECR dan penyebaran ECS-to-Codedeploy.

      • AWSService Catalog

        PilihMemasukkan konfigurasi deploymentjika Anda ingin menggunakan bidang di konsol untuk menentukan konfigurasi Anda, atau memilihFile konfigurasijika Anda memiliki file konfigurasi terpisah. Memasukkan informasi produk dan konfigurasi, lalu memilihSelanjutnya.

        Untuk tutorial tentang menyebarkan perubahan produkAWS Service Catalogdengan pipa Anda, lihatTutorial: Buat pipa yang menyebarkan keAWS Service Catalog.

      • Alexa Keterampilan

        MasukID Keterampilan Alexa, masukkan ID keterampilan untuk keterampilan Alexa Anda. MasukID kliendanRahasia klien, masukkan kredenal yang dihasilkan menggunakan profil keamanan Login with Amazon (LWA). MasukToken refresh, masukkan token refresh yang Anda buat menggunakan perintah ASK CLI untuk mengambil token penyegaran. Pilih Selanjutnya.

        Untuk tutorial tentang menerapkan keterampilan Alexa dengan pipa Anda dan menghasilkan kredensi LWA, lihatTutorial: Buat pipeline yang menyebarkan keterampilan Amazon Alexa.

      • Amazon S3

        MasukBucket, masukkan nama bucket S3 yang ingin Anda gunakan. PilihEkstrak file sebelum menyebarkanjika artefak masukan ke tahap deploy Anda adalah file ZIP. JikaEkstrak file sebelum menyebarkandipilih, Anda dapat secara opsional memasukkan nilai untukJalur deploymentyang file ZIP Anda akan membuka ritsleting. Jika tidak dipilih, Anda diminta untuk memasukkan nilai dalamKunci objek S3.

        catatan

        Sebagian besar sumber dan membangun artefak keluaran panggung zip. Semua penyedia sumber pipa kecuali Amazon S3 zip file sumber Anda sebelum menyediakannya sebagai artefak masukan ke tindakan berikutnya.

        (Opsional) DalamACL Terekam, masukkanACL kalenganuntuk menerapkan ke objek yang dikerahkan ke Amazon S3.

        catatan

        Menerapkan ACL kalengan menimpa setiap ACL yang ada diterapkan pada objek.

        (Opsional) DalamKontrol cache, tentukan parameter kontrol cache untuk permintaan untuk mendownload objek dari bucket. Untuk daftar nilai yang valid, lihatCache-Controlbidang header untuk operasi HTTP. Untuk memasukkan beberapa nilai dalamKontrol 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 Selanjutnya.

        Untuk tutorial tentang membuat pipeline dengan penyedia aksi penyebaran Amazon S3, lihatTutorial: Buat pipeline yang menggunakan Amazon S3 sebagai penyedia penyebaran.

Langkah 5: Tinjau alur

  • PadaLangkah 5: Tinjauhalaman, tinjau konfigurasi alur Anda, lalu pilihMembuat Aluruntuk membuat alur atauSebelumnyauntuk kembali dan mengedit pilihan Anda. Untuk keluar dari wizard tanpa membuat pipa, pilihBatalkan.

Sekarang Anda telah membuat alur Anda, Anda dapat melihatnya di konsol. Pipa mulai berjalan setelah Anda membuatnya. Untuk informasi selengkapnya, lihat Lihat detail dan riwayat pipa di CodePipeline. Untuk informasi selengkapnya tentang membuat perubahan pada alur Anda, lihatMengedit pipa di CodePipeline.

Buat pipa (CLI)

Untuk menggunakanAWS CLIuntuk membuat pipa, Anda membuat file JSON untuk menentukan struktur pipa, dan kemudian jalankancreate-pipelineperintah dengan--cli-input-jsonparameter.

penting

Anda tidak dapat menggunakanAWS CLIuntuk membuat pipa yang mencakup tindakan mitra. Anda harus menggunakan konsol CodePipeline sebagai gantinya.

Untuk informasi selengkapnya tentang struktur alur, lihatReferensi struktur pipa CodePipelinedanmembuat-pipadi CodePipelineReferensi API.

Untuk membuat file JSON, gunakan file JSON pipa sampel, edit, dan kemudian panggil file itu saat Anda menjalankancreate-pipelineperintah.

Prasyarat:

Anda memerlukan peran layanan yang Anda buat untuk CodePipeline diMemulai dengan CodePipeline. Anda menggunakan peran layanan CodePipeline ARN dalam file JSON pipa saat Anda menjalankancreate-pipelineperintah. Untuk informasi selengkapnya tentang pembuatan peran layanan, lihat Membuat peran layanan CodePipeline. Berbeda dengan konsol, menjalankancreate-pipelineperintah diAWS CLItidak memiliki opsi untuk membuat peran layanan CodePipeline untuk Anda. Peran layanan harus sudah ada.

Anda memerlukan nama bucket S3 tempat artefak untuk alur disimpan. Bucket ini harus berada di Wilayah yang sama dengan alur. Anda menggunakan nama bucket dalam pipa JSON file ketika Anda menjalankancreate-pipelineperintah. Berbeda dengan konsol, menjalankancreate-pipelineperintah diAWS CLItidak membuat ember S3 untuk menyimpan artefak. Bucket harus sudah ada.

catatan

Anda juga dapat menggunakanget-pipelineperintah untuk mendapatkan salinan struktur JSON dari pipa itu, dan kemudian memodifikasi struktur itu dalam editor teks biasa.

Topik

    Cara membuat file JSON

    1. Di terminal (Linux, macOS, atau Unix) atau command prompt (Windows), buat file teks baru dalam direktori lokal.

    2. Buka file dalam editor teks biasa dan edit nilai untuk mencerminkan struktur yang ingin Anda buat. Untuk minimum, Anda harus mengubah nama alur. Anda juga harus mempertimbangkan apakah Anda ingin mengubah:

      • Bucket S3 tempat artefak untuk alur ini disimpan.

      • Lokasi sumber untuk kode Anda.

      • Penyedia deployment.

      • Bagaimana Anda ingin kode Anda dikerahkan.

      • Tag untuk alur Anda.

      Struktur pipa sampel dua tahap berikut menyoroti nilai-nilai yang harus Anda pertimbangkan untuk mengubah pipa Anda. Pipa Anda mungkin 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 }, "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 pipa dengan memasukkanProjectkunci tag danProjectAnilai pada alur. Untuk informasi selengkapnya tentang penandaan sumber daya di CodePipeline, lihatPenandaan pada sumber daya .

      PastikanPollForSourceChangesparameter dalam file JSON Anda diatur sebagai berikut:

      "PollForSourceChanges": "false",

      CodePipeline menggunakan Amazon CloudWatch Events untuk mendeteksi perubahan dalam repositori dan cabang sumber CodeCommit Anda atau bucket sumber S3 Anda. Langkah selanjutnya mencakup petunjuk untuk membuat sumber daya ini secara manual untuk pipa Anda. Mengatur bendera kefalsemenonaktifkan pemeriksaan berkala, yang tidak diperlukan ketika Anda menggunakan metode deteksi perubahan yang direkomendasikan.

    3. Untuk membuat tindakan build, test, atau deploy di Wilayah yang berbeda dari pipeline Anda, Anda harus menambahkan yang berikut ke struktur pipa Anda. Untuk petunjuk, lihat Tambahkan aksi lintas Wilayah di CodePipeline.

      • TambahkanRegionparameter untuk struktur pipa tindakan Anda.

      • GunakanartifactStoresparameter untuk menentukan ember artefak untuk masing-masingAWSWilayah di mana Anda memiliki tindakan.

    4. Bila Anda puas dengan strukturnya, simpan file Anda dengan nama sepertipipeline.json.

    Untuk membuat alur

    1. Jalankancreate-pipelineperintah dan menggunakan--cli-input-jsonparameter untuk menentukan file JSON yang Anda buat sebelumnya.

      Untuk membuat alur bernamaMySecondPipelinedengan file JSON bernama pipeline.json yang menyertakan nama”MySecondPipeline“sebagai nilai untuknamedi JSON, perintah Anda akan terlihat seperti berikut ini:

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

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

      Perintah ini mengembalikan struktur seluruh pipa yang Anda buat.

    2. Untuk melihat pipa, buka konsol CodePipeline dan pilih dari daftar pipa, atau gunakanget-pipeline-stateperintah. Untuk informasi selengkapnya, lihat Lihat detail dan riwayat pipa di CodePipeline.

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