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

Mengedit pipa di CodePipeline

Sebuah pipa menjelaskan proses rilis yang Anda inginkanAWS CodePipelineuntuk mengikuti, termasuk tahapan dan tindakan yang harus diselesaikan. Anda dapat mengedit alur untuk menambahkan atau menghapus elemen-elemen ini. Namun, ketika Anda mengedit pipa, nilai-nilai seperti nama pipa atau metadata pipa tidak dapat diubah.

Tidak seperti membuat pipa, mengedit pipa tidak menjalankan kembali revisi terbaru melalui pipa. Jika Anda ingin menjalankan revisi terbaru melalui pipa yang baru saja Anda edit, Anda harus secara manual menjalankan ulang itu. Jika tidak, pipa yang diedit berjalan pada saat berikutnya Anda membuat perubahan ke lokasi sumber yang dikonfigurasi dalam tahap sumber. Untuk informasi, lihat Memulai pipa secara manual.

Anda dapat menambahkan tindakan ke saluran pipa yang ada diAWSWilayah berbeda dari pipa Anda. SaatAWSlayanan adalah penyedia untuk tindakan, dan jenis tindakan/jenis penyedia ini berbedaAWSWilayah dari alur Anda, ini tindakan lintas-wilayah. Untuk informasi selengkapnya tentang tindakan lintas-wilayah, lihatTambahkan aksi lintas Wilayah di CodePipeline.

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 sumber CodeCommit Anda atau bucket sumber Amazon S3 Anda.

catatan

Sumber daya deteksi perubahan dibuat secara otomatis saat Anda menggunakan konsol. Bila Anda menggunakan konsol untuk membuat atau mengedit pipeline, sumber daya tambahan akan dibuat untuk Anda. Jika Anda menggunakanAWS CLIuntuk membuat pipa, Anda harus membuat sumber daya tambahan sendiri. Untuk informasi selengkapnya tentang membuat atau memperbarui alur CodeCommit, lihatMembuat aturan CloudWatch Events untuk sumber CodeCommit (CLI). Untuk informasi selengkapnya tentang menggunakan CLI untuk membuat atau memperbarui alur Amazon S3, lihatMembuat aturan CloudWatch Events untuk sumber Amazon S3 (CLI).

Mengedit alur

Anda dapat menggunakan konsol CodePipeline untuk menambahkan, mengedit, atau menghapus tahapan dalam pipeline dan menambahkan, mengedit, atau menghapus tindakan dalam tahap.

Ketika Anda memperbarui pipa, CodePipeline anggun menyelesaikan semua tindakan berjalan dan kemudian gagal tahapan dan eksekusi pipa di mana tindakan berjalan selesai. Ketika pipa diperbarui, Anda akan perlu untuk kembali menjalankan pipa Anda. Untuk informasi lebih lanjut tentang menjalankan alur, lihatMemulai pipa secara manual.

Untuk mengedit alur

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

    Nama-nama semua jaringan pipa yang terkait dengan AndaAWSakun ditampilkan.

  2. MasukNama, pilih nama alur yang ingin Anda edit. Ini membuka pandangan rinci tentang pipa, termasuk keadaan masing-masing tindakan di setiap tahap pipa.

  3. Pada halaman rincian pipa, pilihMengedit.

  4. PadaMengedithalaman, lakukan salah satu hal berikut:

    • Untuk mengedit panggung, pilihMengedit tahap. Anda dapat menambahkan tindakan secara serial dan paralel dengan tindakan yang ada:

      Anda juga dapat mengedit tindakan dalam tampilan ini dengan memilih ikon edit untuk tindakan tersebut. Untuk menghapus tindakan, pilih ikon hapus pada tindakan tersebut.

    • Untuk mengedit tindakan, pilih ikon edit untuk tindakan itu, lalu aktifEdit tindakan, ubah nilainya. Item yang ditandai dengan tanda bintang (*) diperlukan.

      • Untuk nama dan cabang repositori CodeCommit, pesan muncul yang menampilkan aturan Amazon CloudWatch Events yang akan dibuat untuk pipeline ini. Jika Anda menghapus sumber CodeCommit, muncul pesan yang menampilkan aturan Amazon CloudWatch Events yang akan dihapus.

      • Untuk bucket sumber Amazon S3, pesan muncul yang menampilkan aturan Amazon CloudWatch Events danAWS CloudTrailjejak yang akan dibuat untuk pipa ini. Jika Anda menghapus sumber Amazon S3, pesan akan muncul yang menampilkan aturan Amazon CloudWatch Events danAWS CloudTrailjejak untuk dihapus. JikaAWS CloudTrailtrail digunakan oleh jaringan pipa lain, jejak tidak dihapus dan acara data dihapus.

    • Untuk menambahkan panggung, pilih+ Tambahkan tahappada titik di alur tempat Anda ingin menambahkan panggung. Berikan nama untuk panggung, lalu tambahkan setidaknya satu tindakan ke sana. Item yang ditandai dengan tanda bintang (*) diperlukan.

    • Untuk menghapus panggung, pilih ikon hapus pada tahap tersebut. Panggung dan semua tindakannya akan dihapus.

    Misalnya, jika Anda ingin menambahkan aksi serial ke panggung dalam pipa:

    1. Di tahap tempat Anda ingin menambahkan tindakan Anda, pilihMengedit tahap, dan kemudian pilih+ Tambahkan grup aksi.

    2. MasukEdit tindakan, diNama tindakan, masukkan nama tindakan Anda. ParameterPenyedia tindakandaftar menampilkan pilihan penyedia berdasarkan kategori. Carilah kategori (misalnya,Deploy). Di bawah kategori, pilih penyedia (misalnya,AWS CodeDeploy). MasukWilayah, pilihAWSWilayah di mana sumber daya dibuat atau di mana Anda berencana untuk membuatnya. 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.

      Untuk informasi lebih lanjut tentang persyaratan untuk tindakan di CodePipeline, termasuk nama untuk artefak input dan output dan bagaimana mereka digunakan, lihatPersyaratan struktur tindakan di CodePipeline. Untuk contoh menambahkan penyedia tindakan dan menggunakan bidang default untuk setiap penyedia, lihatBuat pipeline (konsol).

      Untuk menambahkan CodeBuild sebagai aksi pembangunan atau aksi uji ke panggung, lihatGunakan CodePipeline dengan CodeBuild untuk Test Code dan Run Buildsdi dalamPanduan Pengguna CodeBuild.

      catatan

      Beberapa penyedia tindakan, seperti GitHub, mengharuskan Anda untuk terhubung ke situs web penyedia sebelum Anda dapat menyelesaikan konfigurasi tindakan. Saat Anda terhubung ke situs web penyedia, pastikan Anda menggunakan kredensialnya untuk situs web tersebut. Jangan gunakanAWSkredenensi.

    3. Setelah Anda selesai mengonfigurasi tindakan Anda, pilihSimpan.

    catatan

    Anda tidak dapat mengubah nama panggung dalam tampilan konsol. Anda dapat menambahkan tahap dengan nama yang ingin Anda ubah, lalu menghapus yang lama. Pastikan Anda telah menambahkan semua tindakan yang Anda inginkan di tahap itu sebelum Anda menghapus yang lama.

  5. Setelah Anda selesai mengedit alur Anda, pilihSimpanuntuk kembali ke halaman ringkasan.

    penting

    Setelah menyimpan perubahan, Anda tidak dapat membatalkan perubahan tersebut. Anda harus mengedit pipa lagi. Jika revisi berjalan melalui saluran pipa saat Anda menyimpan perubahan, jalankan tidak selesai. Jika Anda ingin melakukan atau perubahan tertentu untuk dijalankan melalui pipa yang diedit, Anda harus menjalankannya secara manual melalui pipa. Jika tidak, komit atau perubahan berikutnya berjalan secara otomatis melalui pipa.

  6. Untuk menguji tindakan Anda, pilihRilis perubahanuntuk memproses yang melakukan melalui pipa dan melakukan perubahan ke sumber yang ditentukan dalam tahap sumber pipa. Atau ikuti langkah-langkah diMemulai pipa secara manualuntuk menggunakanAWS CLIuntuk merilis perubahan secara manual.

Mengedit alur (AWS CLI)

Anda dapat menggunakanupdate-pipelineperintah untuk mengedit pipa.

Ketika Anda memperbarui pipa, CodePipeline anggun menyelesaikan semua tindakan berjalan dan kemudian gagal tahapan dan eksekusi pipa di mana tindakan berjalan selesai. Ketika pipa diperbarui, Anda akan perlu untuk kembali menjalankan pipa Anda. Untuk informasi lebih lanjut tentang menjalankan alur, lihatMemulai pipa secara manual.

penting

Meskipun Anda dapat menggunakanAWS CLIuntuk mengedit jaringan pipa yang mencakup tindakan mitra, Anda tidak harus secara manual mengedit JSON dari tindakan mitra. Jika Anda melakukannya, tindakan mitra gagal setelah memperbarui alur.

Untuk mengedit alur

  1. Buka sesi terminal (Linux, macOS, atau Unix) atau command prompt (Windows) dan jalankanget-pipelineperintah untuk menyalin struktur pipa ke dalam file JSON. Misalnya, untuk pipa bernamaMyFirstPipeline, masukkan perintah berikut:

    aws codepipeline get-pipeline --name MyFirstPipeline >pipeline.json

    Perintah ini tidak mengembalikan apa pun, tapi file yang Anda buat akan muncul di direktori tempat Anda menjalankan perintah tersebut.

  2. Buka file JSON di editor teks biasa dan modifikasi struktur file untuk mencerminkan perubahan yang ingin Anda buat ke pipa. Misalnya, Anda dapat menambahkan atau menghapus tahapan, atau menambahkan tindakan lain ke tahap yang ada.

    Contoh berikut menunjukkan bagaimana Anda akan menambahkan tahap penyebaran lain dalam file pipeline.json. Tahap ini berjalan setelah tahap penyebaran pertama bernamaPementasan.

    catatan

    Ini hanya sebagian dari file, bukan seluruh struktur. Untuk informasi selengkapnya, lihat Referensi struktur pipa CodePipeline.

    , { "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 } ] }, { "name": "Production", "actions": [ { "inputArtifacts": [ { "name": "MyApp" } ], "name": "Deploy-Second-Deployment", "actionTypeId": { "category": "Deploy", "owner": "AWS", "version": "1", "provider": "CodeDeploy" }, "outputArtifacts": [], "configuration": { "ApplicationName": "CodePipelineDemoApplication", "DeploymentGroupName": "CodePipelineProductionFleet" }, "runOrder": 1 } ] } ] }

    Untuk informasi tentang menggunakan CLI untuk menambahkan tindakan persetujuan ke pipeline, lihatTambahkan tindakan persetujuan manual ke pipeline di CodePipeline .

    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 Amazon S3 Anda. Langkah selanjutnya mencakup petunjuk untuk membuat sumber daya ini secara manual. Mengatur bendera kefalsemenonaktifkan pemeriksaan berkala, yang tidak diperlukan saat Anda menggunakan metode deteksi perubahan yang disarankan.

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

    • TambahkanRegionparameter untuk struktur pipa tindakan Anda.

    • GunakanartifactStoresparameter untuk menentukan bucket artefak untuk setiap Wilayah tempat Anda memiliki tindakan.

  4. Jika Anda bekerja dengan struktur pipa diambil menggunakanget-pipelineperintah, Anda harus memodifikasi struktur dalam file JSON. Anda harus menghapusmetadatabaris dari file sehinggaupdate-pipelineperintah dapat menggunakannya. Lepaskan bagian dari struktur pipa di file JSON (yang"metadata": { }garis dan"created","pipelineARN", dan"updated"kolom).

    Misalnya, hapus baris berikut dari struktur:

    "metadata": { "pipelineArn": "arn:aws:codepipeline:region:account-ID:pipeline-name", "created": "date", "updated": "date" }

    Simpan file.

  5. Jika Anda menggunakan CLI untuk mengedit pipa, Anda harus mengelola sumber daya deteksi perubahan yang disarankan secara manual untuk pipa Anda:

  6. Untuk menerapkan perubahan Anda, jalankanupdate-pipelineperintah, menentukan pipa JSON file:

    penting

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

    aws codepipeline update-pipeline --cli-input-json file://pipeline.json

    Perintah ini mengembalikan seluruh struktur pipa diedit.

    catatan

    Parameterupdate-pipelineperintah berhenti pipa. Jika revisi sedang dijalankan melalui pipa ketika Anda menjalankanupdate-pipelineperintah, yang menjalankan dihentikan. Anda harus memulai pipa secara manual untuk menjalankan revisi tersebut melalui pipa yang diperbarui.

  7. Buka konsol CodePipeline dan pilih pipeline yang baru saja Anda edit.

    Pipa menunjukkan perubahan Anda. Lain kali Anda membuat perubahan ke lokasi sumber, pipa berjalan revisi melalui struktur revisi pipa.

  8. Untuk menjalankan revisi terakhir secara manual melalui struktur pipa yang direvisi, jalankanstart-pipeline-executionperintah. Untuk informasi selengkapnya, lihat Memulai pipa secara manual.

Untuk informasi lebih lanjut tentang struktur alur dan nilai yang diharapkan, lihatReferensi struktur pipa CodePipelinedanAWS CodePipelineReferensi API.