Membuat dan menambahkan tindakan kustom di CodePipeline

Untuk membuat tindakan kustom dengan AWS CLI

1. Buka editor teks dan buat file JSON untuk tindakan kustom Anda yang mencakup kategori tindakan, penyedia tindakan, dan pengaturan apa pun yang diperlukan oleh tindakan kustom Anda. Misalnya, untuk membuat tindakan pembuatan kustom yang hanya membutuhkan satu properti, file JSON Anda mungkin terlihat seperti ini:

   {
       "category": "Build",
       "provider": "My-Build-Provider-Name",
       "version": "1",
       "settings": {
           "entityUrlTemplate": "https://my-build-instance/job/{Config:ProjectName}/",
           "executionUrlTemplate": "https://my-build-instance/job/{Config:ProjectName}/lastSuccessfulBuild/{ExternalExecutionId}/"
       },
       "configurationProperties": [{
           "name": "ProjectName",
           "required": true,
           "key": true,
           "secret": false,
           "queryable": false,
           "description": "The name of the build project must be provided when this action is added to the pipeline.",
           "type": "String"
       }],
       "inputArtifactDetails": {
           "maximumCount": integer,
           "minimumCount": integer
       },
       "outputArtifactDetails": {
           "maximumCount": integer,
           "minimumCount": integer
       },
       "tags": [{
         "key": "Project",
         "value": "ProjectA"
       }]
   }

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

   Ada dua properti yang disertakan dalam file JSON, entityUrlTemplate danexecutionUrlTemplate. Anda dapat merujuk ke nama di properti konfigurasi tindakan kustom dalam templat URL dengan mengikuti format{Config:name}, selama properti konfigurasi diperlukan dan bukan rahasia. Misalnya, dalam sampel di atas, entityUrlTemplate nilai mengacu pada properti konfigurasiProjectName.

   • entityUrlTemplate: tautan statis yang memberikan informasi tentang penyedia layanan untuk tindakan tersebut. Dalam contoh, sistem build menyertakan tautan statis ke setiap proyek build. Format tautan akan bervariasi, tergantung pada penyedia build Anda (atau, jika Anda membuat jenis tindakan yang berbeda, seperti pengujian, penyedia layanan lain). Anda harus memberikan format tautan ini sehingga ketika tindakan kustom ditambahkan, pengguna dapat memilih tautan ini untuk membuka browser ke halaman di situs web Anda yang menyediakan spesifikasi untuk proyek build (atau lingkungan pengujian).

   • executionUrlTemplate: tautan dinamis yang akan diperbarui dengan informasi tentang tindakan saat ini atau terbaru. Ketika pekerja pekerjaan kustom Anda memperbarui status pekerjaan (misalnya, sukses, gagal, atau sedang berlangsung), itu juga akan memberikan externalExecutionId yang akan digunakan untuk menyelesaikan tautan. Tautan ini dapat digunakan untuk memberikan rincian tentang menjalankan suatu tindakan.

   Misalnya, saat Anda melihat tindakan dalam pipeline, Anda melihat dua tautan berikut:

   

   Tautan statis ini muncul setelah Anda menambahkan tindakan kustom dan menunjuk ke alamat dientityUrlTemplate, yang Anda tentukan saat membuat tindakan kustom.

   Tautan dinamis ini diperbarui setelah setiap tindakan dijalankan dan menunjuk ke alamat diexecutionUrlTemplate, yang Anda tentukan saat membuat tindakan kustom.

   Untuk informasi selengkapnya tentang jenis tautan ini, serta RevisionURLTemplate danThirdPartyURL, lihat ActionTypeSettings dan CreateCustomActionType di Refer CodePipeline ensi API. Untuk informasi selengkapnya tentang persyaratan struktur tindakan dan cara membuat tindakan, lihatCodePipeline referensi struktur pipa.

2. Simpan file JSON dan beri nama yang dapat Anda ingat dengan mudah (misalnya, MyCustomAction .json).

3. Buka sesi terminal (Linux, OS X, Unix) atau command prompt (Windows) pada komputer tempat Anda telah menginstal. AWS CLI

4. Gunakan AWS CLI untuk menjalankan aws codepipeline create-custom-action-type perintah, menentukan nama file JSON yang baru saja Anda buat.

   Misalnya, untuk membuat tindakan kustom build:

   penting

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

   aws codepipeline create-custom-action-type --cli-input-json file://MyCustomAction.json

5. Perintah ini mengembalikan seluruh struktur tindakan kustom yang Anda buat, serta properti konfigurasi JobList tindakan, yang ditambahkan untuk Anda. Saat menambahkan tindakan kustom ke pipeline, Anda dapat menggunakan JobList untuk menentukan proyek mana dari penyedia yang dapat Anda jajak pendapat untuk pekerjaan. Jika Anda tidak mengonfigurasi ini, semua pekerjaan yang tersedia akan dikembalikan saat pekerja pekerjaan kustom Anda melakukan polling untuk pekerjaan.

   Misalnya, perintah sebelumnya mungkin mengembalikan struktur yang mirip dengan berikut ini:

   {
       "actionType": {
           "inputArtifactDetails": {               
               "maximumCount": 1,                
               "minimumCount": 1
          },
          "actionConfigurationProperties": [
               {
                   "secret": false,
                   "required": true,
                   "name": "ProjectName",
                   "key": true,
                   "description": "The name of the build project must be provided when this action is added to the pipeline."
               }
           ],
           "outputArtifactDetails": {               
               "maximumCount": 0,                
               "minimumCount": 0
           },
           "id": {
               "category": "Build",
               "owner": "Custom",
               "version": "1",
               "provider": "My-Build-Provider-Name"
           },
           "settings": {
               "entityUrlTemplate": "https://my-build-instance/job/{Config:ProjectName}/",
               "executionUrlTemplate": "https://my-build-instance/job/mybuildjob/lastSuccessfulBuild/{ExternalExecutionId}/"
           }
       }
   }

   catatan

   Sebagai bagian dari output create-custom-action-type perintah, id bagian ini termasuk"owner": "Custom". CodePipeline secara otomatis menetapkan Custom sebagai pemilik jenis tindakan kustom. Nilai ini tidak dapat ditetapkan atau diubah saat Anda menggunakan create-custom-action-type perintah atau update-pipeline perintah.

Cara mengatur instans Amazon EC2

1. Pelajari lebih lanjut tentang Amazon EC2 dan tentukan apakah itu pilihan yang tepat untuk integrasi Anda. Untuk informasi, lihat Amazon EC2 - Hosting Server Virtual.

2. Mulailah membuat instans Amazon EC2 Anda. Untuk selengkapnya, lihat Memulai dengan Inst ans Linux Amazon EC2.

Untuk mengatur federasi identitas

1. Pelajari lebih lanjut tentang federasi identitas IAM. Untuk selengkapnya, lihat M engelola Federasi.

2. Tinjau contoh dalam Sken ario Pemberian Akses Sementara untuk mengidentifikasi skenario akses sementara yang paling sesuai dengan kebutuhan tindakan kustom Anda.

3. Tinjau contoh kode federasi identitas yang relevan dengan infrastruktur Anda, seperti:

   • Contoh Aplikasi Federasi Identitas untuk Kasus Penggunaan Direktori Aktif

4. Mulailah mengonfigurasi federasi identitas. Untuk selengkapnya, lihat Penyedia Identitas dan Federasi di Panduan Pengguna IAM.

1. Buka sesi terminal (Linux, macOS, atau Unix) atau command prompt (Windows) dan jalankan get-pipeline perintah untuk menyalin struktur pipeline yang ingin Anda edit ke file JSON. Misalnya, untuk pipeline bernamaMyFirstPipeline, Anda akan mengetikkan perintah berikut:

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

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

2. Buka file JSON di editor teks apa pun dan ubah struktur file untuk menambahkan tindakan kustom Anda ke tahap yang ada.

   catatan

   Jika Anda ingin tindakan Anda berjalan secara paralel dengan tindakan lain di tahap itu, pastikan Anda menetapkan runOrder nilai yang sama dengan tindakan itu.

   Misalnya, untuk memodifikasi struktur pipeline untuk menambahkan tahap bernama Build dan untuk menambahkan tindakan kustom build ke tahap itu, Anda dapat memodifikasi JSON untuk menambahkan tahap Build sebelum tahap penerapan sebagai berikut:

   ,
       {
         "name": "MyBuildStage",
         "actions":  [
                 {
                   "inputArtifacts": [
                   {
                      "name": "MyApp"
                    }
                      ],
                       "name": "MyBuildCustomAction",
                       "actionTypeId": {
                           "category": "Build",
                           "owner": "Custom",
                           "version": "1",
                           "provider": "My-Build-Provider-Name"
                       },
                       "outputArtifacts": [
                           {
                             "name": "MyBuiltApp"
                           }
                       ],
                       "configuration": {
                           "ProjectName": "MyBuildProject"
                       },
                       "runOrder": 1
                   }
               ]
           },      
           {
               "name": "Staging",
               "actions": [
                       {
                           "inputArtifacts": [
                               {
                                   "name": "MyBuiltApp"
                               }
                           ],
                           "name": "Deploy-CodeDeploy-Application",
                           "actionTypeId": {
                               "category": "Deploy",
                               "owner": "AWS",
                               "version": "1",
                               "provider": "CodeDeploy"
                           },
                           "outputArtifacts": [],
                           "configuration": {
                               "ApplicationName": "CodePipelineDemoApplication",
                               "DeploymentGroupName": "CodePipelineDemoFleet"
                           },
                           "runOrder": 1
                       }
                   ]
                }      
       ]
   }

3. Untuk menerapkan perubahan Anda, jalankan update-pipeline perintah, tentukan file JSON pipeline, mirip dengan yang berikut:

   penting

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

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

   Perintah ini mengembalikan seluruh struktur pipa yang diedit.

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

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