Buat koneksi ke GitHub Enterprise Server (konsol)Buat host dan koneksi ke GitHub Enterprise Server (CLI)

GitHub Koneksi Enterprise Server

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

catatan

Fitur ini tidak tersedia di Asia Pasifik (Hong Kong), Afrika (Cape Town), Timur Tengah (Bahrain), Eropa (Zurich), atau AWS GovCloud (AS-Barat). 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, dan GitLab tindakan.com.

Untuk menambahkan tindakan sumber Server GitHub Perusahaan CodePipeline, Anda dapat memilih salah satu untuk:

Gunakan wizard Buat pipeline CodePipeline konsol atau halaman tindakan Edit untuk memilih opsi penyedia Server GitHub Perusahaan. Lihat Buat 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 untuk CreateSourceConnection tindakan dengan GitHubEnterpriseServer penyedia dan membuat sumber daya Anda:
- Untuk membuat sumber daya koneksi Anda, lihat Buat host dan koneksi ke GitHub Enterprise Server (CLI) untuk membuat sumber daya host dan sumber daya koneksi dengan CLI.
- Gunakan CreateSourceConnection contoh konfigurasi tindakan CodeStarSourceConnection untuk Bitbucket Cloud, GitHub Enterprise Server GitHub, dan GitLab tindakan.com untuk menambahkan tindakan Anda seperti yang ditunjukkan padaBuat 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 Enterprise Server dan menginstal instance GitHub Enterprise Server pada infrastruktur Anda.

catatan
Setiap VPC hanya dapat dikaitkan dengan satu host (contoh Server GitHub Perusahaan) pada satu waktu.
Anda harus sudah membuat repositori kode dengan GitHub Enterprise Server.

catatan

Pipeline tipe V2, bersama dengan pemicu pada tag Git dan variabel tingkat pipeline, saat ini tidak didukung untuk AWS CloudFormation dan sumber daya CDK di. CodePipeline Untuk informasi selengkapnya tentang jaringan pipa tipe V2, lihatJenis pipa.

Topik

Buat koneksi ke GitHub Enterprise Server (konsol)
Buat host dan koneksi ke GitHub Enterprise Server (CLI)

Buat koneksi ke GitHub Enterprise Server (konsol)

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

catatan

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

Sebelum Anda mulai:

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

Langkah 1: Buat atau edit pipeline Anda

Untuk membuat atau mengedit pipeline

Masuk ke CodePipeline konsol.
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 Server GitHub Perusahaan.
- 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 Server GitHub Perusahaan.
Lakukan salah satu dari berikut:
- Di bawah Koneksi, jika Anda belum membuat sambungan ke penyedia Anda, pilih Connect to GitHub Enterprise Server. Lanjutkan ke Langkah 2: Buat Koneksi ke Server GitHub Perusahaan.
- Di bawah Koneksi, 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, halaman Connect to GitHub Enterprise Server ditampilkan.

penting

AWS CodeStar Koneksi 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 Server GitHub Perusahaan

Di Nama koneksi, masukkan nama untuk koneksi Anda.
Di URL, masukkan titik akhir untuk server Anda.

catatan
Jika URL yang disediakan telah digunakan untuk menyiapkan Server GitHub Perusahaan untuk koneksi, Anda akan diminta untuk memilih ARN sumber daya host yang dibuat sebelumnya untuk titik akhir tersebut.
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 Server GitHub Perusahaan Anda diinstal atau VPC dengan akses ke instance Server GitHub Perusahaan 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 instance GitHub Enterprise Server yang diinstal 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 Server GitHub Perusahaan Anda diinstal atau grup keamanan dengan akses ke instans Server GitHub Perusahaan yang diinstal melalui VPN atau Direct Connect.
4. Jika Anda memiliki VPC pribadi yang dikonfigurasi, dan Anda telah mengonfigurasi instance Server GitHub Perusahaan 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.
Pilih Connect to 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.
Pilih Perbarui koneksi tertunda.
Jika diminta, pada halaman login GitHub Enterprise, masuk dengan kredensi GitHub Enterprise Anda.
Pada halaman Buat GitHub Aplikasi, pilih nama untuk aplikasi Anda.
<app-name>Pada halaman GitHub otorisasi, pilih Otorisasi.
Pada halaman instalasi aplikasi, sebuah pesan menunjukkan bahwa aplikasi AWS 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.
Halaman koneksi yang menampilkan koneksi yang dibuat dalam status Tersedia.

Langkah 3: Simpan tindakan sumber Server GitHub Perusahaan Anda

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

Untuk menyelesaikan dan menyimpan tindakan sumber Anda dengan koneksi Anda

Dalam nama Repositori, pilih nama repositori pihak ketiga Anda.
Pemicu Under Pipeline lakukan salah satu hal berikut:
- Untuk mengonfigurasi konfigurasi pemicu pipeline untuk memulai pada push kode, pilih Branch. Di Nama cabang, pilih cabang tempat pipeline Anda ingin mendeteksi perubahan sumber.
- Untuk mengonfigurasi konfigurasi pemicu pipeline untuk memulai dengan tag Git, pilih tag Git. Di bawah Tag, di Sertakan, masukkan pola untuk nama tag dalam format glob yang ingin Anda tentukan untuk konfigurasi pemicu untuk memulai pipeline Anda saat rilis tag atau tag yang ditentukan. Di Kecualikan, masukkan pola untuk nama tag dalam format glob yang ingin Anda tentukan agar konfigurasi pemicu diabaikan dan untuk tidak memulai pipeline Anda saat rilis tag atau tag yang ditentukan. Jika include dan exclude keduanya memiliki pola tag yang sama, maka defaultnya adalah mengecualikan pola tag.
  
  (Opsional) Di cabang Default, pilih cabang yang ingin Anda tentukan sebagai cabang default untuk pemicu pipeline manual atau terjadwal.
- Untuk mengonfigurasi konfigurasi pemicu pipeline untuk memulai dengan rilis manual atau hanya pada jadwal, pilih Tidak Ada. Di cabang Default, pilih cabang yang ingin Anda tentukan sebagai cabang default untuk pemicu pipeline manual atau terjadwal.
  
  penting
  Memilih Tidak Ada berarti bahwa konfigurasi pemicu sumber pipa tidak akan default ke deteksi perubahan otomatis untuk perubahan kode sumber (komit) yang dibuat ke repositori sumber.
Dalam format artefak Output, Anda harus memilih format untuk artefak Anda.
- Untuk menyimpan artefak keluaran dari tindakan GitHub Enterprise Server menggunakan metode default, pilih CodePipelinedefault. Tindakan mengakses file dari repositori GitHub Enterprise Server dan menyimpan artefak dalam file ZIP di toko artefak pipeline.
- 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.
Pilih Berikutnya di wizard atau Simpan di halaman Edit tindakan.

Buat 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 satu kali 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, host dalam status Tertunda. Anda kemudian mengatur, atau mendaftarkan, host untuk memindahkannya ke status Tersedia. 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 statusnya. Available

Untuk membuat host

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.
Gunakan konsol untuk menyelesaikan penyiapan host dan memindahkan host ke status Available.

Untuk membuat koneksi ke GitHub Enterprise Server

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"
}
```
Gunakan konsol untuk mengatur koneksi yang tertunda.

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 memulai dengan tag Git, tambahkan yang berikut ini ke level pipeline definisi JSON pipeline. 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"
                                ]
                            }
                        }
                    ]
                }
            }
        ]

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

GitHub koneksi

GitLabkoneksi .com