Memperbarui tindakan sumber GitHub versi 1 ke aksi sumber GitHub versi 2

MasukAWS CodePipeline, ada dua versi yang didukung dari aksi sumber GitHub:

• Direkomendasikan: Tindakan GitHub versi 2 menggunakan auth berbasis aplikasi Github yang didukung olehCodeStarSourceConnectionuntuk tindakan Bitbucket,GitHub, dan GitHub Enterprise Serversumber daya. Ini menginstal aplikasi AWS CodeStar Connections ke organisasi GitHub Anda sehingga Anda dapat mengelola akses di GitHub.

• Tidak direkomendasikan: Tindakan GitHub versi 1 menggunakan token OAuth untuk mengotentikasi dengan GitHub dan menggunakan webhook terpisah untuk mendeteksi perubahan. Ini bukan lagi metode yang direkomendasikan.

catatan

Fitur ini tidak tersedia di Wilayah Asia Pasifik (Hong Kong) atau Eropa (Milan). Untuk menggunakan tindakan sumber lain yang tersedia di Wilayah tersebut, lihatIntegrasi aksi sumber.

Ada beberapa keuntungan penting untuk menggunakan tindakan GitHub versi 2 bukan tindakan GitHub versi 1:

• Dengan koneksi, CodePipeline tidak lagi memerlukan aplikasi OAuth atau token akses pribadi untuk mengakses repositori Anda. Saat membuat sambungan, Anda menginstal Aplikasi GitHub yang mengelola autentikasi ke repositori GitHub Anda dan memungkinkan izin di tingkat organisasi. Anda harus mengotorisasi token OAuth sebagai pengguna untuk mengakses repositori. Untuk informasi selengkapnya tentang akses GitHub berbasis OAuth berbeda dengan akses GitHub berbasis aplikasi, lihathttps://docs.github.com/en/developers/apps/differences-between-github-apps-and-oauth-apps.

• Ketika Anda mengelola tindakan GitHub versi 2 di CLI atau CloudFormation, Anda tidak lagi harus menyimpan token akses pribadi Anda sebagai rahasia di Secrets Manager. Anda tidak lagi harus secara dinamis mereferensikan rahasia yang tersimpan dalam konfigurasi tindakan CodePipeline Anda. Anda menambahkan ARN koneksi ke konfigurasi tindakan Anda. Contoh konfigurasi tindakan, lihatCodeStarSourceConnectionuntuk tindakan Bitbucket,GitHub, dan GitHub Enterprise Server.

• Ketika Anda membuat sumber daya koneksi untuk digunakan dengan tindakan GitHub versi 2 di CodePipeline, Anda dapat menggunakan sumber daya koneksi yang sama untuk mengaitkan layanan lain yang didukung, seperti CodeGuru Reviewer, dengan repositori Anda.

• Di Github versi 2, Anda dapat mengkloning repositori untuk mengakses git metadata dalam tindakan CodeBuild berikutnya, sementara di Github versi 1 Anda hanya dapat mengunduh sumbernya.

• Administrator menginstal aplikasi untuk repositori organisasi Anda. Anda tidak lagi harus melacak token OAuth yang bergantung pada individu yang membuat token.

Semua aplikasi yang diinstal ke organisasi memiliki akses ke kumpulan repositori yang sama. Untuk mengubah siapa yang dapat mengakses setiap repositori, ubah kebijakan IAM untuk setiap koneksi. Sebagai contoh, lihatContoh: Sebuah kebijakan scoped-down untuk menggunakan koneksi dengan repositori tertentu.

Anda dapat menggunakan langkah-langkah dalam topik ini untuk menghapus tindakan sumber GitHub versi 1 Anda dan menambahkan tindakan sumber GitHub versi 2 dari konsol CodePipeline.

Langkah 1: Ganti aksi GitHub versi 1 Anda

Gunakan halaman edit pipeline untuk mengganti tindakan GitHub versi 1 Anda dengan tindakan GitHub versi 2.

Untuk mengganti tindakan GitHub versi 1 Anda

1. Masuk ke konsol CodePipeline.

2. Pilih pipa Anda, dan pilihMengedit. PilihTahap editdi panggung sumber Anda. Sebuah pesan menampilkan yang menyarankan Anda memperbarui tindakan Anda.

3. MasukPenyedia tindakan, pilihGitHub (Versi 2).

4. Lakukan salah satu dari berikut:

   • Di bawahKoneksi, jika Anda belum membuat koneksi ke penyedia Anda, pilihConnect ke GitHub. Lanjutkan ke Langkah 2: Membuat koneksi ke GitHub.

   • Di bawahKoneksi, jika Anda telah membuat koneksi ke penyedia Anda, pilih koneksi. Lanjutkan ke Langkah 3: Simpan Tindakan Sumber untuk Koneksi Anda.

Langkah 2: Membuat koneksi ke GitHub

Setelah Anda memilih untuk membuat koneksi,Connect ke GitHubhalaman ditampilkan.

Untuk membuat koneksi ke GitHub

1. Di bawahPengaturan koneksi GitHub, nama koneksi Anda ditampilkan diNama koneksi.

   Pada Aplikasi GitHub, pilih penginstalan aplikasi atau pilih Instal aplikasi baru untuk membuatnya.

   catatan

   Anda menginstal satu aplikasi untuk semua koneksi Anda ke penyedia tertentu. Jika Anda telah menginstal aplikasi GitHub, pilih dan lewati langkah ini.

2. Jika halaman otorisasi untuk GitHub ditampilkan, masuk dengan kredensi Anda lalu pilih untuk melanjutkan.

3. Pada halaman instalasi aplikasi, sebuah pesan menunjukkan bahwa aplikasi AWS CodeStar mencoba terhubung ke akun GitHub Anda.

   catatan

   Anda hanya menginstal aplikasi sekali untuk setiap akun GitHub. Jika sebelumnya Anda menginstal aplikasi, Anda dapat memilih Konfigurasi untuk melanjutkan ke halaman modifikasi untuk instalasi aplikasi Anda, atau Anda dapat menggunakan tombol kembali untuk kembali ke konsol.

4. PadaInstal AWS CodeStarhalaman, pilihPasang.

5. PadaConnect ke GitHubHalaman, ID koneksi untuk instalasi baru Anda ditampilkan. Pilih Connect.

Langkah 3: Simpan aksi sumber GitHub Anda

Selesaikan pembaruan Anda diEdit tindakanhalaman untuk menyimpan tindakan sumber baru Anda.

Untuk menyimpan tindakan sumber GitHub Anda

1. MasukRepositori, masukkan nama repositori pihak ketiga Anda. MasukCabang, masukkan cabang di mana Anda ingin pipa Anda mendeteksi perubahan sumber.

   catatan

   MasukRepositori, jenisowner-name/repository-nameseperti yang ditunjukkan dalam contoh ini:

   my-account/my-repository

2. MasukFormat artefak, pilih format artefak Anda.

   • Untuk menyimpan artefak keluaran dari aksi GitHub menggunakan metode default, pilihDefault 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 diTambahkan CodeBuild GitClone izin untuk koneksi ke Bitbucket, GitHub, atau GitHub Enterprise Server. Untuk tutorial yang menunjukkan cara menggunakanKloning penuhpilihan, lihatTutorial: Gunakan klon penuh dengan sumber GitHub pipeline.

3. Masukartefak, Anda dapat mempertahankan nama artefak output untuk tindakan ini, sepertiSourceArtifact. PilihSelesaimenutupEdit tindakanhalaman.

4. PilihSelesaiuntuk menutup halaman pengeditan panggung. PilihSimpanuntuk menutup halaman pengeditan pipa.