Koneksi GitHub - AWS CodePipeline

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

Koneksi GitHub

Anda menggunakan koneksi untuk mengotorisasi dan menetapkan konfigurasi yang mengaitkan penyedia pihak ketiga Anda dengan AndaAWSsumber daya.

catatan

Fitur ini tidak tersedia di Wilayah Asia Pacific (Hong Kong) dan Europe (Milan). Untuk referensi tindakan lain yang tersedia, lihatIntegrasi produk dan layanan dengan CodePipeline.

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

  • Menggunakan konsol CodePipelineMembuat pipapenyihir atauEdit tindakanhalaman untuk memilihGitHub (Versi 2)pilihan penyedia. LihatMembuat 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 koneksi GitHub dan menggunakanKloning penuhpilihan dalam pipa Anda, lihatTutorial: Gunakan klon penuh dengan sumber pipa GitHub.

  • Gunakan CLI untuk menambahkan konfigurasi tindakan untukCodeStarSourceConnectiontindakan denganGitHubpenyedia dengan langkah-langkah CLI yang ditampilkan diBuat pipa (CLI).

catatan

Anda juga dapat membuat koneksi menggunakan konsol Developer Tools di bawahPengaturan. LihatBuat Koneksi.

Sebelum Anda memulai:

  • Anda harus membuat akun dengan GitHub.

  • Anda harus sudah membuat repositori kode GitHub.

  • Jika peran layanan CodePipeline Anda dibuat sebelum 18 Desember 2019, Anda mungkin perlu memperbarui izinnya untuk digunakancodestar-connections:UseConnectionuntuk koneksi AWS CodeStar. Untuk petunjuk, lihat Tambahkan izin keCodePipelineperan layanan.

Membuat koneksi ke GitHub (konsol)

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

catatan

Koneksi untuk GitHub hanya menyediakan akses ke repositori yang dimiliki oleh akun GitHub yang digunakan untuk membuat koneksi.

Langkah 1: Membuat atau mengedit pipa

  1. Masuklah ke konsol CodePipeline.

  2. Pilih salah satu dari berikut.

    • Pilih untuk membuat pipa. Ikuti langkah-langkah diMembuat Pipelineuntuk menyelesaikan layar pertama dan memilihSelanjutnya. PadaSumberhalaman, di bawahPenyedia Sumber, pilihGitHub (Versi 2).

    • Pilih untuk mengedit pipa yang ada. PilihMengedit, dan kemudian pilihTahap edit. Pilih untuk menambahkan atau mengedit tindakan sumber Anda. PadaEdit tindakanhalaman, di bawahNama tindakan, masukkan nama untuk tindakan Anda. MasukPenyedia tindakan, pilihGitHub (Versi 2).

  3. Lakukan salah satu dari berikut:

    • Di bawahKoneksi, jika Anda belum membuat koneksi ke penyedia Anda, pilihConnect ke GitHub. Lanjutkan ke Langkah 2: Buat 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 akan muncul.


                    Tangkapan layar konsol menampilkan halaman koneksi GitHub awal.

Untuk membuat koneksi ke GitHub

  1. Di bawahPengaturan koneksi GitHub, nama koneksi Anda muncul diNama koneksi. Pilih Hubungkan ke GitHub. Halaman permintaan akses muncul.

  2. PilihOtorisasiAWSKonektor untuk GitHub. Halaman koneksi menampilkan dan menunjukkan bidang Aplikasi GitHub.

    
                            Tangkapan layar konsol yang menampilkan halaman koneksi GitHub awal dengan bidang Aplikasi GitHub.
  3. 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 menginstalAWSKonektor untuk aplikasi GitHub, pilih dan lewati langkah ini.

  4. PadaPasangAWSKonektor untuk GitHubhalaman, pilih akun tempat Anda ingin menginstal aplikasi.

    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.

  5. PadaPasangAWSKonektor untuk GitHubhalaman, meninggalkan default, dan memilihPasang.

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

Langkah 3: Simpan aksi sumber GitHub

Gunakan langkah-langkah ini padaEdit tindakanhalaman untuk menyimpan tindakan sumber Anda dengan informasi koneksi Anda.

Untuk menyimpan tindakan sumber GitHub Anda

  1. MasukRepositori, masukkan nama repositori Anda. MasukNama cabang, pilih cabang tempat Anda ingin saluran Anda mendeteksi perubahan sumber.

    catatan

    MasukRepositorijenisowner-name/repository-nameseperti yang ditunjukkan dalam contoh ini:

    my-account/my-repository
  2. MasukFormat artefak keluaran, Anda harus memilih format untuk 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 izin CodeBuild GitClone untuk koneksi ke Bitbucket, GitHub, atau GitHub Enterprise Server. Untuk tutorial yang menunjukkan cara menggunakanKloning penuhpilihan, lihatTutorial: Gunakan klon penuh dengan sumber pipa GitHub.

  3. PilihSelanjutnyapada wizard atauSimpanpadaEdit tindakanhalaman.

Membuat 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, lihatMemperbarui koneksi yang tertunda.