GitHub koneksi

Anda menggunakan koneksi untuk mengotorisasi dan membuat konfigurasi yang mengaitkan penyedia pihak ketiga Anda dengan sumber daya AndaAWS.

catatan

Fitur ini tidak tersedia di Asia Pasifik (Hong Kong), Asia Pasifik (Hyderabad), Asia Pasifik (Jakarta), Asia Pasifik (Melbourne), Asia Pasifik (Osaka), Afrika (Cape Town), Timur Tengah (Bahrain), Timur Tengah (UEA), Eropa (Spanyol), Eropa (Zurich), Israel (Tel Aviv), atau (AS-Barat) Wilayah. AWS GovCloud Untuk mereferensikan tindakan lain yang tersedia, lihatIntegrasi produk dan layanan dengan CodePipeline. Untuk pertimbangan dengan tindakan ini di Wilayah Eropa (Milan), lihat catatan diCodeStarSourceConnection untuk Bitbucket Cloud, GitHub Enterprise Server GitHub, GitLab .com, dan tindakan yang dikelola GitLab sendiri.

Untuk menambahkan tindakan sumber untuk repositori GitHub Enterprise Cloud Anda GitHub atau di CodePipeline, Anda dapat memilih salah satu untuk:

• Gunakan wizard Buat pipeline CodePipeline konsol atau halaman tindakan Edit untuk memilih opsi penyedia GitHub (Versi 2). Lihat Buat koneksi ke GitHub Enterprise Server (konsol) untuk menambahkan tindakan. Konsol membantu Anda membuat sumber daya koneksi.

  catatan

  Untuk tutorial yang memandu Anda melalui cara menambahkan GitHub koneksi dan menggunakan opsi klon Penuh di pipeline Anda, lihatTutorial: Gunakan klon lengkap dengan sumber GitHub pipa.

• Gunakan CLI untuk menambahkan konfigurasi tindakan untuk tindakan dengan GitHub penyedia dengan langkah-langkah CLI yang ditunjukkan di. CodeStarSourceConnection Buat pipeline (CLI)

catatan

Anda juga dapat membuat koneksi menggunakan konsol Alat Pengembang di bawah Pengaturan. Lihat Membuat Koneksi.

Sebelum Anda memulai:

• Anda harus telah membuat akun dengan GitHub.

• Anda harus sudah membuat repositori GitHub kode.

• Jika peran CodePipeline layanan Anda dibuat sebelum 18 Desember 2019, Anda mungkin perlu memperbarui izinnya untuk digunakan codestar-connections:UseConnection untuk AWS CodeStar koneksi. Untuk petunjuk, lihat Menambahkan izin ke peran CodePipeline layanan.

catatan

Untuk membuat koneksi, Anda harus menjadi pemilik GitHub organisasi. Untuk repositori yang tidak berada di bawah organisasi, Anda harus menjadi pemilik repositori.

Buat koneksi ke GitHub (konsol)

Gunakan langkah-langkah ini untuk menggunakan CodePipeline konsol guna menambahkan tindakan koneksi untuk repositori Cloud GitHub atau GitHub Enterprise Cloud Anda.

catatan

Dalam langkah-langkah ini, Anda dapat memilih repositori tertentu di bawah Akses Repositori. Repositori apa pun yang tidak dipilih tidak akan dapat diakses atau dilihat oleh. CodePipeline

Langkah 1: Buat atau edit pipeline Anda

1. Masuk ke CodePipeline konsol.

2. Pilih salah satu dari berikut ini.

   • Pilih untuk membuat pipeline. Ikuti langkah-langkah di Create a Pipeline untuk menyelesaikan layar pertama dan pilih Berikutnya. Pada halaman Sumber, di bawah Penyedia Sumber, pilih GitHub (Versi 2).

   • Pilih untuk mengedit pipeline yang ada. Pilih Edit, lalu pilih Edit tahap. Pilih untuk menambahkan atau mengedit tindakan sumber Anda. Pada halaman Edit tindakan, di bawah Nama tindakan, masukkan nama untuk tindakan Anda. Di penyedia Tindakan, pilih GitHub (Versi 2).

3. Lakukan salah satu dari cara berikut:

   • Di bawah Koneksi, jika Anda belum membuat sambungan ke penyedia Anda, pilih Connect to GitHub. Lanjutkan ke Langkah 2: Buat Koneksi ke GitHub.

   • Di bawah Koneksi, jika Anda telah membuat koneksi ke penyedia Anda, pilih koneksi. Lanjutkan ke Langkah 3: Simpan tindakan sumber untuk koneksi Anda.

Langkah 2: Buat koneksi ke GitHub

Setelah Anda memilih untuk membuat koneksi, GitHub halaman Connect to akan muncul.

Untuk membuat koneksi ke GitHub

1. Di bawah pengaturan GitHub koneksi, nama koneksi Anda muncul di Nama koneksi. Pilih Connect to GitHub. Halaman permintaan akses muncul.

2. Pilih Otorisasi AWS Konektor untuk GitHub. Halaman koneksi menampilkan dan menampilkan bidang GitHub Aplikasi.

   

3. Di bawah GitHub Aplikasi, 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 AWS Connector for GitHub app, pilih dan lewati langkah ini.

4. Pada GitHub halaman Install AWS Connector for, pilih akun tempat Anda ingin menginstal aplikasi.

   catatan

   Anda hanya menginstal aplikasi sekali untuk setiap GitHub akun. 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.

5. Pada GitHub halaman Install AWS Connector for, tinggalkan default, dan pilih Install.

6. Pada GitHub halaman Connect to, ID koneksi untuk instalasi baru Anda muncul di GitHub Aplikasi. Pilih Hubungkan.

Langkah 3: Simpan tindakan GitHub sumber Anda

Gunakan langkah-langkah ini di halaman Edit tindakan untuk menyimpan tindakan sumber Anda dengan informasi koneksi Anda.

Untuk menyimpan tindakan GitHub sumber Anda

1. Dalam nama Repositori, pilih nama repositori pihak ketiga Anda.

2. Di bawah pemicu Pipeline, Anda dapat menambahkan pemicu jika tindakan Anda adalah CodeConnections tindakan. Untuk mengonfigurasi konfigurasi pemicu pipeline dan memfilter secara opsional dengan pemicu, lihat detail selengkapnya di. Filter pemicu pada permintaan push atau pull kode

3. Dalam format artefak Output, Anda harus memilih format untuk artefak Anda.

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

     Jika Anda memilih opsi ini, Anda perlu memperbarui izin untuk peran layanan CodeBuild proyek Anda seperti yang ditunjukkan padaTambahkan CodeBuild GitClone izin untuk koneksi ke Bitbucket,, GitHub Enterprise Server GitHub, atau .com GitLab. Untuk tutorial yang menunjukkan cara menggunakan opsi klon Penuh, lihatTutorial: Gunakan klon lengkap dengan sumber GitHub pipa.

4. Pilih Berikutnya di wizard atau Simpan di halaman Edit tindakan.

Buat koneksi ke GitHub (CLI)

Anda dapat menggunakan AWS Command Line Interface (AWS CLI) untuk membuat koneksi.

Untuk melakukannya, gunakan perintah create-connection.

penting

Koneksi yang dibuat melalui AWS CLI atau AWS CloudFormation dalam status PENDING secara default. Setelah Anda membuat koneksi dengan CLI atau AWS CloudFormation, gunakan konsol untuk mengedit koneksi untuk membuat statusnya AVAILABLE.

Untuk membuat koneksi

1. Buka terminal (Linux, macOS, atau Unix) atau command prompt (Windows). Gunakan AWS CLI untuk menjalankan perintah create-connection, tentukan --provider-type dan --connection-name untuk koneksi Anda. Dalam contoh ini, nama penyedia pihak ketiga adalah GitHub dan nama koneksi yang ditentukan adalah MyConnection.

   aws codestar-connections create-connection --provider-type GitHub --connection-name MyConnection

   Jika berhasil, perintah ini mengembalikan informasi ARN koneksi seperti berikut ini.

   {
       "ConnectionArn": "arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f"
   }

2. Gunakan konsol untuk menyelesaikan koneksi. Untuk informasi selengkapnya, lihat Memperbarui sambungan yang tertunda.

3. Pipeline default untuk mendeteksi perubahan pada push kode ke repositori sumber koneksi. Untuk mengonfigurasi konfigurasi pemicu pipeline untuk rilis manual atau untuk tag Git, lakukan salah satu hal berikut:

   • Untuk mengonfigurasi konfigurasi pemicu pipeline untuk memulai dengan rilis manual saja, tambahkan baris berikut ke konfigurasi:

     "DetectChanges": "false",

   • Untuk mengonfigurasi konfigurasi pemicu pipeline untuk memfilter dengan pemicu, lihat detail selengkapnya diFilter pemicu pada permintaan push atau pull kode. Misalnya, berikut ini menambah tingkat pipa definisi JSON pipa. Dalam contoh ini, release-v0 dan release-v1 merupakan tag Git untuk disertakan, dan release-v2 merupakan tag Git untuk dikecualikan.

     "triggers": [
                 {
                     "providerType": "CodeStarSourceConnection",
                     "gitConfiguration": {
                         "sourceActionName": "Source",
                         "push": [
                             {
                                 "tags": {
                                     "includes": [
                                         "release-v0", "release-v1"
                                     ],
                                     "excludes": [
                                         "release-v2"
                                     ]
                                 }
                             }
                         ]
                     }
                 }
             ]