Mengedit pipeline di CodePipeline - AWS CodePipeline
Mengedit alur (konsol)Mengedit pipeline (AWS CLI)

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

Mengedit pipeline di CodePipeline

Pipeline menjelaskan proses rilis yangAWS CodePipeline ingin Anda ikuti, termasuk tahapan dan tindakan yang harus diselesaikan. Anda dapat mengedit alur untuk menambah atau menghapus elemen ini. Namun, saat Anda mengedit pipeline, nilai seperti nama pipeline atau metadata pipeline tidak dapat diubah.

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

Anda dapat menambahkan tindakan ke pipeline yang berada diAWS Wilayah yang berbeda dari pipeline Anda. Ketika sebuahLayanan AWS penyedia tindakan, dan jenis tindakan/jenis penyedia ini berada diAWS Wilayah yang berbeda dari pipeline Anda, ini adalah tindakan lintas wilayah. Untuk informasi selengkapnya tentang tindakan lintas wilayah lintas wilayah, lihatMenambahkan tindakan Lintas wilayah diCodePipeline.

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

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

catatan

Ubah sumber daya deteksi dibuat secara otomatis saat Anda menggunakan konsol. Saat Anda menggunakan konsol untuk membuat atau mengedit pipeline, sumber daya tambahan dibuat untuk Anda. Jika Anda menggunakanAWS CLI untuk membuat alur, Anda harus membuat sumber daya tambahan sendiri. Untuk informasi selengkapnya tentang membuat atau memperbarui CodeCommit pipeline, lihatMembuat aturanCloudWatch Acara untukCodeCommit sumber (CLI). Untuk informasi lebih lanjut tentang penggunaan CLI untuk membuat atau memperbarui alur Amazon S3, lihatMembuat aturanCloudWatch Acara untuk sumber Amazon S3 (CLI).

Mengedit alur (konsol)

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

Saat Anda memperbarui pipeline, CodePipeline dengan anggun menyelesaikan semua tindakan yang berjalan dan kemudian gagal dalam tahapan dan eksekusi pipeline tempat tindakan yang berjalan selesai. Saat pipeline diperbarui, Anda perlu menjalankan kembali pipeline Anda. Untuk informasi lebih lanjut tentang menjalankan pipeline, lihatMemulai pipeline secara manual.

Untuk mengedit alur menggunakan alur menggunakan alur menggunakan alur menggunakan alur

  1. Masuk keAWS Management Console dan buka CodePipeline konsol di http://console.aws.amazon.com/codesuite/codepipeline/home.

    Nama-nama dari semua alur yang terkait denganAWS akun Anda akan ditampilkan.

  2. Di Nama, 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 detail pipeline, pilih Edit.

  4. Pada halaman Mengedit, lakukan salah satu hal berikut:

    • Untuk mengedit tahapan, pilih Edit stage. Anda dapat menambahkan tindakan secara serial dan parallel 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 itu.

    • Untuk mengedit tindakan, pilih ikon edit untuk tindakan itu, dan kemudian pada tindakan Edit, ubah nilainya. Item yang ditandai dengan tanda bintang (*) diperlukan.

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

      • Untuk bucket sumber Amazon S3, sebuah pesan muncul yang menunjukkan aturan danAWS CloudTrail jejak Amazon CloudWatch Events yang akan dibuat untuk pipeline ini. Jika Anda menghapus sumber Amazon S3, sebuah pesan muncul yang menunjukkan aturan danAWS CloudTrail jejak Amazon CloudWatch Events yang akan dihapus. JikaAWS CloudTrail jejak digunakan oleh jaringan pipa lain, jejak tidak dihapus dan peristiwa data dihapus.

    • Untuk menambahkan tahap, pilih+Tambahkan tahap pada titik di pipeline tempat Anda ingin menambahkan panggung. Berikan nama untuk panggung, dan kemudian tambahkan setidaknya satu tindakan untuk itu. Item yang ditandai dengan tanda bintang (*) diperlukan.

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

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

    1. Pada tahap di mana Anda ingin menambahkan tindakan Anda, pilih Edit stage, dan kemudian pilih+Tambahkan grup tindakan.

    2. Di Edit tindakan, di Nama tindakan, masukkan nama tindakan Anda. Daftar penyedia Action menampilkan opsi penyedia berdasarkan kategori. Cari kategori (misalnya, Deploy). Di bawah kategori, pilih penyedia (misalnya, AWS CodeDeploy). Di Wilayah, pilihAWS Wilayah tempat sumber daya dibuat atau tempat Anda berencana untuk membuatnya. Bidang Region menunjukkan tempatAWS sumber daya dibuat untuk jenis tindakan dan jenis penyedia ini. Bidang ini hanya menampilkan untuk tindakan di mana penyedia tindakan adalahLayanan AWS. Bidang Wilayah default keAWS Wilayah yang sama dengan pipeline Anda.

      Untuk informasi lebih lanjut tentang persyaratan untuk tindakan 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 build atau tindakan pengujian ke tahap, lihat Gunakan CodePipeline dengan CodeBuild untuk Menguji Kode dan Menjalankan Build di PanduanCodeBuild Pengguna.

      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 kredensi untuk situs web tersebut. Jangan gunakanAWS kredensi Anda.

    3. Setelah selesai mengonfigurasi tindakan Anda, pilih Simpan.

    catatan

    Anda tidak dapat mengganti 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 dalam tahap itu sebelum Anda menghapus yang lama.

  5. Setelah selesai mengedit pipeline, pilih Simpan untuk kembali ke halaman ringkasan.

    penting

    Setelah menyimpan perubahan Anda, Anda tidak dapat membatalkan perubahan tersebut. Anda harus mengedit pipeline lagi. Jika revisi berjalan melalui pipeline saat Anda menyimpan perubahan, proses tidak selesai. Jika Anda menginginkan komit atau perubahan tertentu untuk dijalankan melalui pipeline yang diedit, Anda harus menjalankannya secara manual melalui pipeline. Jika tidak, komit atau perubahan berikutnya berjalan secara otomatis melalui pipeline.

  6. Untuk menguji tindakan Anda, pilih Release change untuk memproses commit melalui pipeline dan melakukan perubahan ke sumber yang ditentukan dalam tahap sumber pipeline. Atau ikuti langkah-langkahMemulai pipeline secara manual untuk menggunakan untuk merilis perubahan secara manual.AWS CLI

Mengedit pipeline (AWS CLI)

Anda dapat menggunakanupdate-pipeline perintah untuk mengedit pipeline.

Saat Anda memperbarui pipeline, CodePipeline dengan anggun menyelesaikan semua tindakan yang berjalan dan kemudian gagal dalam tahapan dan eksekusi pipeline tempat tindakan yang berjalan selesai. Saat pipeline diperbarui, Anda perlu menjalankan kembali pipeline Anda. Untuk informasi lebih lanjut tentang menjalankan pipeline, lihatMemulai pipeline secara manual.

penting

Meskipun Anda dapat menggunakanAWS CLI untuk mengedit pipeline yang menyertakan tindakan mitra, Anda tidak boleh mengedit JSON tindakan mitra secara manual. Jika Anda melakukannya, tindakan mitra gagal setelah memperbarui alur akan gagal setelah memperbarui alur tersebut.

Untuk mengedit alur menggunakan alur menggunakan alur menggunakan alur menggunakan alur

  1. Buka sesi terminal (Linux, macOS, atau Unix) atau command prompt (Windows) dan jalankanget-pipeline perintah untuk menyalin alur, ke file JSON. Misalnya, untuk alur 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 ubah struktur file untuk mencerminkan perubahan yang ingin Anda buat pada pipeline. Misalnya, Anda dapat menambah 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 bernama Staging.

    catatan

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

    ,      
        {
            "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, lihatMenambahkan tindakan persetujuan manual ke pipeline diCodePipeline .

    PastikanPollForSourceChanges parameter dalam file JSON Anda diatur sebagai berikut: 

                    "PollForSourceChanges": "false",

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

  3. Untuk menambahkan aksi build, test, atau deploy di Wilayah yang berbeda dari pipeline, Anda harus menambahkan yang berikut ke struktur pipeline. Untuk instruksi detail, lihat Menambahkan tindakan Lintas wilayah diCodePipeline.

    • TambahkanRegion parameter ke struktur pipeline tindakan Anda.

    • GunakanartifactStores parameter untuk menentukan bucket artefak untuk setiap Wilayah tempat Anda memiliki aksi.

  4. Jika Anda bekerja dengan struktur pipeline yang diambil menggunakanget-pipeline perintah, Anda harus memodifikasi struktur dalam file JSON. Anda harus menghapusmetadata baris dari file sehinggaupdate-pipeline perintah dapat menggunakannya. Hapus bagian dari struktur pipa dalam file JSON ("metadata": { }garis dan"created","pipelineARN", dan"updated" bidang).

    Misalnya, hapus baris berikut dari struktur: 

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

    Simpan file tersebut.

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

  6. Untuk menerapkan perubahan Anda, jalankanupdate-pipeline perintah, tentukan file JSON pipeline:

    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

    update-pipelinePerintah menghentikan pipa. Jika revisi sedang dijalankan melalui pipeline ketika Anda menjalankanupdate-pipeline perintah, yang menjalankan dihentikan. Anda harus memulai pipeline secara manual untuk menjalankan revisi tersebut melalui pipeline yang diperbarui.

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

    Pipeline menunjukkan perubahan Anda. Lain kali Anda membuat perubahan ke lokasi sumber, pipa menjalankan revisi itu melalui struktur pipa yang direvisi.

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

Untuk informasi lebih lanjut tentang struktur pipeline dan nilai yang diharapkan, lihatCodePipeline referensi struktur pipa dan ReferensiAWS CodePipeline API.