GitHub hubungan - AWS CodePipeline

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

GitHub hubungan

Anda menggunakan koneksi untuk mengotorisasi dan membuat konfigurasi yang mengaitkan penyedia pihak ketiga Anda denganAWSsumber daya.

catatan

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

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

  • Gunakan CodePipeline konsolBuat Alurwizard atauEdit tindakanhalaman untuk memilihGitHub (Versi 2)opsi 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 GitHub koneksi dan menggunakanKlon 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 ditunjukkan diBuat pipa (CLI).

catatan

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

Sebelum Anda memulai:

  • Anda harus membuat akun GitHub.

  • Anda harus sudah membuat GitHub kode repositori.

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

catatan

Untuk membuat koneksi, Anda harus menjadi GitHub pemilik 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 untuk menambahkan aksi koneksi GitHubatau GitHub Repositori Enterprise Cloud.

catatan

Dalam langkah-langkah ini, Anda dapat memilih repositori tertentu di bawahAkses Repositori. Setiap repositori yang tidak dipilih tidak akan dapat diakses atau terlihat oleh CodePipeline.

Langkah 1: Membuat atau mengedit pipeline

  1. Masuk ke CodePipeline konsol.

  2. Pilih salah satu dari berikut.

    • Pilih untuk membuat pipa. Ikuti langkah-langkah diBuat Aluruntuk menyelesaikan layar pertama dan memilihSelanjutnya. PadaSumberhalaman, di bawahPenyedia SumberPilih, pilihGitHub (Versi 2).

    • Pilih untuk mengedit pipeline yang ada. Pilih Pilih Pilih PilihMengedit, dan kemudian pilihEdit tahap. Pilih untuk menambah atau mengedit tindakan sumber Anda. PadaEdit tindakanhalaman, di bawahNama tindakan, Masukkan nama untuk tindakan Anda. MasukPenyedia tindakanPilih, pilihGitHub (Versi 2).

  3. Lakukan salah satu dari berikut:

    • Di bawahKoneksi, jika Anda belum membuat koneksi ke penyedia Anda, pilihSambungkan 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: Buat koneksi ke GitHub

Setelah Anda memilih untuk membuat koneksi,Sambungkan ke GitHubHalaman muncul.


                    Tangkapan layar konsol menampilkan awal GitHub halaman koneksi.

Untuk membuat koneksi ke GitHub

  1. Di bawahGitHub pengaturan koneksi, nama koneksi Anda muncul diNama koneksi. Pilih Pilih Pilih PilihSambungkan ke GitHub. Halaman permintaan akses muncul.

  2. Pilih Pilih Pilih PilihMengotorisasiAWSKonektor untuk GitHub. Halaman koneksi menampilkan dan menampilkanGitHub AplikasiBidang.

    
                            Tangkapan layar konsol menampilkan awal GitHub halaman koneksi dengan GitHub Bidang aplikasi
  3. Di bawahGitHub Aplikasi, pilih instalasi aplikasi atau pilihMenginstal aplikasi baruuntuk membuat satu.

    catatan

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

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

    catatan

    Anda hanya menginstal aplikasi sekali untuk masing-masing 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. PadaPasangAWSKonektor untuk GitHubhalaman, meninggalkan default, dan memilihPasang.

  6. PadaSambungkan ke GitHubhalaman, ID koneksi untuk instalasi baru Anda muncul diGitHub Aplikasi. Pilih Connect.

Langkah 3: Simpan GitHub tindakan sumber

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

Untuk menyimpan GitHub tindakan sumber

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

    catatan

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

    my-account/my-repository
  2. MasukFormat artefak, Anda harus memilih format untuk artefak Anda.

    • Untuk menyimpan artefak keluaran dari GitHub tindakan menggunakan metode default, pilihCodePipeline default. Tindakan mengakses file dari GitHub repositori dan menyimpan artefak dalam file ZIP di toko pipa artefak.

    • Untuk menyimpan file JSON yang berisi referensi URL ke repositori sehingga tindakan hilir dapat melakukan perintah Git secara langsung, pilihKlon penuh. Opsi ini hanya dapat digunakan oleh CodeBuild tindakan hilir.

      Jika Anda memilih opsi ini, Anda harus memperbarui izin untuk Anda CodeBuild peran layanan proyek seperti yang ditunjukkan padaTambahkan CodeBuild GitClone izin untuk koneksi ke Bitbucket, GitHub, atau GitHub Server Enterprise. Untuk tutorial yang menunjukkan cara menggunakanKlon penuhpilihan, lihatTutorial: Gunakan klon penuh dengan sumber pipa GitHub.

  3. Pilih Pilih Pilih PilihSelanjutnyapada wizard atauSimpanpadaEdit tindakanhalaman.

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