Koneksi GitHub Enterprise Server

Koneksi memungkinkan Anda untuk mengotorisasi dan menetapkan konfigurasi yang mengaitkan penyedia pihak ketiga Anda dengan AndaAWSsumber daya. Untuk mengaitkan repositori pihak ketiga Anda sebagai sumber untuk pipeline, Anda menggunakan koneksi.

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 aksi sumber GitHub Enterprise Server di CodePipeline, Anda dapat memilih untuk:

• Menggunakan konsol CodePipelineMembuat pipapenyihir atauEdit tindakanhalaman untuk memilihGitHub Enterprise Serverpilihan penyedia. LihatMembuat koneksi ke GitHub Enterprise Server (konsol)untuk menambahkan tindakan. Konsol membantu Anda membuat sumber daya host dan sumber daya koneksi.

• Gunakan CLI untuk menambahkan konfigurasi tindakan untukCreateSourceConnectiontindakan denganGitHubEnterpriseServerpenyedia dan membuat sumber daya Anda:

  • Untuk membuat sumber daya koneksi Anda, lihatMembuat host dan koneksi ke GitHub Enterprise Server (CLI)untuk membuat sumber daya host dan sumber daya koneksi dengan CLI.

  • MenggunakanCreateSourceConnectionkonfigurasi contoh tindakan diCodeStarSourceConnection untuk Bitbucket, GitHub, dan GitHub Tindakan Server Enterpriseuntuk menambahkan tindakan Anda seperti yang ditunjukkan dalamBuat 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 Enterprise Server dan menginstal instans GitHub Enterprise Server di infrastruktur Anda.

• Anda harus sudah membuat repositori kode dengan GitHub Enterprise Server.

Membuat koneksi ke GitHub Enterprise Server (konsol)

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

catatan

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

Sebelum Anda memulai:

Untuk koneksi host ke GitHub Enterprise Server, Anda harus menyelesaikan langkah-langkah untuk membuat sumber daya host untuk koneksi Anda. LihatMengelola host untuk koneksi.

Langkah 1: Membuat atau mengedit pipa Anda

Untuk membuat atau mengedit pipa Anda

1. Masuk 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 Enterprise Server.

   • Pilih untuk mengedit pipa yang ada. MemiilihMengedit, dan kemudian pilihMengedit tahap. Pilih untuk menambahkan atau mengedit tindakan sumber Anda. PadaEdit tindakanhalaman, di bawahNama tindakan, masukkan nama untuk tindakan Anda. MasukPenyedia tindakan, pilihGitHub Enterprise Server.

3. Lakukan salah satu dari berikut:

   • Di bawahKoneksi, jika Anda belum membuat koneksi ke penyedia Anda, pilihHubungkan ke GitHub Enterprise Server. Lanjutkan ke Langkah 2: Membuat Koneksi ke GitHub Enterprise Server.

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

Membuat koneksi ke GitHub Enterprise Server

Setelah Anda memilih untuk membuat koneksi,Hubungkan ke GitHub Enterprise ServerHalaman ditampilkan.

penting

AWSKoneksi CodeStar tidak mendukung GitHub Enterprise Server versi 2.22.0 karena masalah yang diketahui dalam rilis. Untuk menghubungkan, tingkatkan ke versi 2.22.1 atau versi terbaru yang tersedia.

Untuk terhubung ke GitHub Enterprise Server

1. Di Nama koneksi, masukkan nama untuk koneksi Anda.

2. Di URL, masukkan titik akhir untuk server Anda.

   catatan

   Jika URL yang disediakan telah digunakan untuk mengatur GitHub Enterprise Server untuk koneksi, Anda akan diminta untuk memilih ARN sumber daya host yang telah dibuat sebelumnya untuk titik akhir tersebut.

3. Jika Anda telah meluncurkan server Anda ke Amazon VPC dan Anda ingin terhubung dengan VPC Anda, pilih Gunakan VPC dan selesaikan yang berikut ini.

   1. Di ID VPC, pilih ID VPC anda. Pastikan untuk memilih VPC untuk infrastruktur tempat instans GitHub Enterprise Server Anda diinstal atau VPC dengan akses ke instans GitHub Enterprise Server Anda melalui VPN atau Direct Connect.

   2. Pada ID subnet, pilih Tambahkan. Di bidang, pilih ID subnet yang ingin Anda gunakan untuk host Anda. Anda dapat memilih hingga 10 subnet.

      Pastikan untuk memilih subnet untuk infrastruktur tempat instans GitHub Enterprise Server Anda diinstal atau subnet dengan akses ke instans GitHub Enterprise Server yang Anda instal melalui VPN atau Direct Connect.

   3. Pada ID grup keamanan, pilih Tambahkan. Di bidang, pilih grup keamanan yang ingin Anda gunakan untuk host Anda. Anda dapat memilih hingga 10 grup keamanan.

      Pastikan untuk memilih grup keamanan untuk infrastruktur tempat instans GitHub Enterprise Server Anda diinstal atau grup keamanan dengan akses ke instans GitHub Enterprise Server yang Anda instal melalui VPN atau Direct Connect.

   4. Jika Anda memiliki VPC privat yang dikonfigurasi, dan Anda telah mengonfigurasi instans GitHub Enterprise Server Anda untuk melakukan validasi TLS menggunakan otoritas sertifikat non-publik, dalam sertifikat TLS, masukkan ID sertifikat Anda. Nilai Sertifikat TLS harus menjadi kunci publik sertifikat.

      

4. Pilih Hubungkan ke GitHub Enterprise Server. Koneksi yang dibuat ditampilkan dengan status Tertunda. Sumber daya host dibuat untuk koneksi dengan informasi server yang Anda berikan. Untuk nama host, URL digunakan.

5. Pilih Perbarui koneksi tertunda.

6. Jika diminta, pada halaman masuk GitHub Enterprise, masuk dengan kredensial GitHub Enterprise Anda.

7. Pada halaman Buat Aplikasi GitHub, pilih nama untuk aplikasi Anda.

8. Pada halaman otorisasi GitHub, pilih Otorisasi <app-name>.

9. Pada halaman instalasi aplikasi, sebuah pesan menunjukkan bahwaAWSAplikasi CodeStar Connector siap untuk diinstal. Jika Anda memiliki beberapa organisasi, Anda mungkin diminta untuk memilih organisasi tempat Anda ingin menginstal aplikasi.

   Pilih pengaturan repositori tempat Anda ingin menginstal aplikasi. Pilih Install.

10. Halaman koneksi yang menampilkan koneksi yang dibuat dalam status Tersedia.

Langkah 3: Menyimpan tindakan sumber GitHub Enterprise Server Anda

Gunakan langkah-langkah ini pada wizard atauEdit tindakanhalaman untuk menyimpan tindakan sumber Anda dengan informasi koneksi Anda.

Untuk menyelesaikan dan menyimpan tindakan sumber Anda dengan koneksi Anda

1. MasukNama repositori, pilih nama repositori pihak ketiga Anda. MasukNama cabang, pilih cabang tempat Anda ingin saluran Anda mendeteksi perubahan sumber.

2. MasukFormat artefak, Anda harus memilih format untuk artefak Anda.

   • Untuk menyimpan artefak keluaran dari tindakan GitHub Enterprise Server menggunakan metode default, pilihDefault CodePipeline. Tindakan mengakses file dari repositori GitHub Enterprise Server 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.

3. MemiilihSelanjutnyapada wisaya atauSimpanpadaEdit tindakanhalaman.

Membuat host dan koneksi ke GitHub Enterprise Server (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.

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

catatan

Anda hanya membuat host sekali per akun GitHub Enterprise Server. Semua koneksi Anda ke akun GitHub Enterprise Server tertentu akan menggunakan host yang sama.

Anda menggunakan host untuk mewakili titik akhir infrastruktur tempat penyedia pihak ketiga Anda diinstal. Setelah Anda menyelesaikan pembuatan host dengan CLI, tuan rumah ada diTertundastatus. Anda kemudian mengatur, atau mendaftar, host untuk memindahkannya keTersediastatus. Setelah host tersedia, Anda menyelesaikan langkah-langkah untuk membuat koneksi.

Untuk melakukannya, gunakan perintah create-host.

penting

Host yang dibuat melalui AWS CLI dalam status Pending secara default. Setelah Anda membuat host dengan CLI, gunakan konsol atau CLI untuk mengatur host untuk membuat statusnyaAvailable.

Untuk membuat host

1. Buka terminal (Linux, macOS, atau Unix) atau command prompt (Windows). Gunakan AWS CLI untuk menjalankan perintah create-host, tentukan --name, --provider-type, dan --provider-endpoint untuk koneksi Anda. Dalam contoh ini, nama penyedia pihak ketiga adalah GitHubEnterpriseServer dan titik akhir adalah my-instance.dev.

   aws codestar-connections create-host --name MyHost --provider-type GitHubEnterpriseServer --provider-endpoint "https://my-instance.dev"

   Jika berhasil, perintah ini mengembalikan informasi Amazon Resource Name (ARN) host seperti berikut ini.

   {
       "HostArn": "arn:aws:codestar-connections:us-west-2:account_id:host/My-Host-28aef605"
   }

   Setelah langkah ini, host dalam status PENDING.

2. Gunakan konsol untuk menyelesaikan penyiapan host dan memindahkan host ke status Available.

Untuk membuat koneksi ke GitHub Enterprise Server

1. Buka terminal (Linux, macOS, atau Unix) atau command prompt (Windows). Gunakan AWS CLI untuk menjalankan perintah create-connection, tentukan --host-arn dan --connection-name untuk koneksi Anda.

   aws codestar-connections create-connection --host-arn arn:aws:codestar-connections:us-west-2:account_id:host/MyHost-234EXAMPLE --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"
   }

2. Gunakan konsol untuk mengatur koneksi yang tertunda.