Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Jalan GitHub kan sampel Server Perusahaan untuk CodeBuild
AWS CodeBuild mendukung GitHub Enterprise Server sebagai repositori sumber. Contoh ini menunjukkan cara mengatur CodeBuild proyek Anda ketika repositori Server GitHub Enterprise Anda memiliki sertifikat yang diinstal. Ini juga menunjukkan cara mengaktifkan webhook sehingga CodeBuild membangun kembali kode sumber setiap kali perubahan kode didorong ke repositori Server GitHub Enterprise Anda.
**Topics**
+ [Prasyarat](#sample-github-enterprise-prerequisites)
+ [Langkah 1: Buat proyek build dengan GitHub Enterprise Server dan aktifkan webhook](#sample-github-enterprise-running)
## Prasyarat
1. Hasilkan token akses pribadi untuk CodeBuild proyek Anda. Kami menyarankan Anda membuat pengguna GitHub Enterprise dan membuat token akses pribadi untuk pengguna ini. Salin ke clipboard Anda sehingga dapat digunakan saat Anda membuat CodeBuild proyek Anda. Untuk informasi selengkapnya, lihat [ Membuat token akses pribadi untuk baris perintah ](https://help.github.com/articles/creating-a-personal-access-token-for-the-command-line/) di situs web GitHub Bantuan.
Saat Anda membuat token akses pribadi, sertakan cak ** upan ** repo dalam definisi.
1. Unduh sertifikat Anda dari GitHub Enterprise Server. CodeBuild menggunakan sertifikat untuk membuat koneksi SSL tepercaya ke repositori.
**Linux/macOS klien: **
Dari jendela terminal, jalankan perintah berikut:
```
echo -n | openssl s_client -connect {{HOST}}:{{PORTNUMBER}} \
| sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' > /{{folder}}/{{filename}}.pem
```
Ganti placeholder dalam perintah dengan nilai-nilai berikut:
{{HOST}}. Alamat IP repositori Server GitHub Perusahaan Anda.
{{PORTNUMBER}}. Nomor port yang Anda gunakan untuk menghubungkan (misalnya, 443).
{{folder}}. Folder tempat Anda mengunduh sertifikat Anda.
{{filename}}. Nama file dari file sertifikat Anda.
**penting**
Simpan sertifikat sebagai file.pem.
**Klien Windows: **
Gunakan browser Anda untuk mengunduh sertifikat Anda dari GitHub Enterprise Server. Untuk melihat detail sertifikat situs, pilih ikon gembok. Untuk informasi tentang cara mengekspor sertifikat, lihat dokumentasi browser Anda.
**penting**
Simpan sertifikat sebagai file.pem.
1. Unggah file sertifikat Anda ke bucket S3. Untuk informasi tentang cara membuat bucket S3, lihat [ Bagaimana cara membuat Bucket S3? ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket.html) Untuk informasi tentang cara mengunggah objek ke bucket S3, lihat [ Bagaimana cara mengunggah file dan folder ke bucket? ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/upload-objects.html)
**catatan**
Bucket ini harus berada di AWS wilayah yang sama dengan bangunan Anda. Misalnya, jika Anda menginstruksikan CodeBuild untuk menjalankan build di Wilayah AS Timur (Ohio), bucket harus berada di Wilayah AS Timur (Ohio).
## Langkah 1: Buat proyek build dengan GitHub Enterprise Server dan aktifkan webhook
1. Buka AWS CodeBuild konsol di [ https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home).
1. Jika halaman CodeBuild informasi ditampilkan, pilih ** Buat proyek build**. Jika tidak, pada panel navigasi, per ** luas Bang ** un, pilih ** Bang ** un proyek, lalu pilih ** Buat proyek build**.
1. Di **Nama proyek**, masukkan nama untuk proyek pembangunan ini. Nama proyek build harus unik di setiap AWS akun. Anda juga dapat menyertakan deskripsi opsional proyek build untuk membantu pengguna lain memahami untuk apa proyek ini digunakan.
1. Di ** Sumber**, di ** Penyedia Sumber**, pilih Server ** GitHub Perusahaan**.
+ Pilih ** Kelola kreden ** tif akun, lalu pilih Token akses ** pribadi**. Untuk ** Layanan**, pilih Manajer ** Rahasia (disarankan)**, dan konfigurasikan rahasia Anda. Kemudian di token akses pribadi ** GitHub perusahaan**, masukkan token akses pribadi Anda dan pilih S ** impan**.
+ Di URL ** Repositori**, masukkan jalur ke repositori Anda, termasuk nama repositori.
+ Perluas **Additional configuration** (Konfigurasi tambahan).
+ Pilih ** Bangun kembali setiap kali perubahan kode didorong ke repositori ini ** untuk membangun kembali setiap kali perubahan kode didorong ke repositori ini.
+ Pilih ** Aktifkan SSL tidak aman ** untuk mengabaikan peringatan SSL saat Anda terhubung ke repositori proyek Server GitHub Perusahaan Anda.
**catatan**
Kami menyarankan Anda menggunakan ** Aktifkan SSL tidak aman hanya ** untuk pengujian. Ini tidak boleh digunakan di lingkungan produksi.
1. Di ** Lingkungan**:
Untuk gambar ** Lingkungan**, lakukan salah satu hal berikut:
+ Untuk menggunakan image Docker yang dikelola oleh AWS CodeBuild, pilih Gambar terkel ** ola**, lalu buat pilihan dari Sistem ** operasi**, ** Runtime (s)**, ** Gambar**, dan versi ** ** Gambar. Buat pilihan dari jenis ** Lingkungan ** jika tersedia.
+ Untuk menggunakan gambar Docker lain, pilih ** Custom image**. Untuk tipe ** Lingkungan**, pilih ** ARM**, ** Linux**, ** Linux GPU**, atau ** Windows**. Jika Anda memilih Registry ** lain**, untuk URL registri ** eksternal**, masukkan nama dan tag gambar Docker di Docker Hub, menggunakan format. `{{docker repository}}/{{docker image name}}` Jika Anda memilih ** Amazon ECR**, gunakan repositori ** Amazon ECR ** dan gambar ** Amazon ECR ** untuk memilih gambar Docker di AWS akun Anda.
+ Untuk menggunakan image Docker pribadi, pilih Gambar ** ** kustom. Untuk tipe ** Lingkungan**, pilih ** ARM**, ** Linux**, ** Linux GPU**, atau ** Windows**. Untuk ** Registri gambar**, pilih Registry ** lain**, lalu masukkan ARN kredensional untuk image Docker pribadi Anda. KredenSIAL harus dibuat oleh Manajer Rahasia. Untuk informasi lebih lanjut, lihat [Apa itu AWS Secrets Manager?](https://docs.aws.amazon.com/secretsmanager/latest/userguide/) di *Panduan Pengguna AWS Secrets Manager *.
1. Di ** Peran Layanan**, lakukan salah satu hal berikut:
+ Jika Anda tidak memiliki peran CodeBuild layanan, pilih Per ** an layanan baru**. Di Nama ** peran**, masukkan nama untuk peran baru.
+ Jika Anda memiliki peran CodeBuild layanan, pilih Peran layanan ** yang ada**. Di ** Role ARN**, pilih peran layanan.
**catatan**
Saat Anda menggunakan konsol untuk membuat atau memperbarui proyek build, Anda dapat membuat peran CodeBuild layanan secara bersamaan. Secara default, peran hanya berfungsi dengan proyek build itu. Jika Anda menggunakan konsol untuk mengaitkan peran layanan ini dengan proyek build lain, peran tersebut diperbarui untuk bekerja dengan proyek build lainnya. Peran layanan dapat bekerja dengan hingga 10 proyek pembangunan.
1. Perluas **Additional configuration** (Konfigurasi tambahan).
Jika Anda CodeBuild ingin bekerja dengan VPC Anda:
+ Untuk ** VPC**, pilih ID VPC yang CodeBuild digunakan.
+ Untuk Subnets ** VPC**, pilih subnet yang menyertakan sumber daya yang menggunakan. CodeBuild
+ Untuk ** grup Keamanan VPC**, pilih grup keamanan yang digunakan untuk mengi CodeBuild zinkan akses ke sumber daya di VPC.
Untuk informasi selengkapnya, lihat [Gunakan AWS CodeBuild dengan Amazon Virtual Private Cloud](vpc-support.md).
1. Di ** Buildspec**, lakukan salah satu hal berikut:
+ Pilih ** Gunakan file buildspec ** untuk menggunakan file buildspec.yml di direktori root kode sumber.
+ Pilih S ** isipkan perintah build ** untuk menggunakan konsol untuk menyisipkan perintah build.
Untuk informasi selengkapnya, lihat [Referensi Buildspec](build-spec-ref.md).
1. Di ** Artifacts**, untuk ** Type**, lakukan salah satu hal berikut:
+ Jika Anda tidak ingin membuat artefak keluaran build, pilih ** Tidak ada artefak**.
+ Untuk menyimpan output build dalam bucket S3, pilih ** Amazon S3**, lalu lakukan hal berikut:
+ Jika Anda ingin menggunakan nama proyek Anda untuk file atau folder ZIP keluaran build, biarkan ** Nama ** kosong. Jika tidak, masukkan nama. Secara default, nama artefak adalah nama proyek. Jika Anda ingin menggunakan nama yang berbeda, masukkan di kotak nama artefak. Jika Anda ingin menampilkan file ZIP, sertakan ekstensi zip.
+ Untuk nama ** Bucket**, pilih nama bucket keluaran.
+ Jika Anda memilih ** Sisip ** kan perintah build sebelumnya dalam prosedur ini**, untuk file ** Output, masukkan lokasi file dari build yang ingin Anda masukkan ke dalam file atau folder ZIP keluaran build. Untuk beberapa lokasi, pisahkan setiap lokasi dengan koma (misalnya,`appspec.yml, target/my-app.jar`). Untuk informasi lebih lanjut, lihat deskripsi `files` di[Sintaks Buildspec](build-spec-ref.md#build-spec-ref-syntax).
1. Untuk jenis ** Cache**, pilih salah satu dari berikut ini:
+ Jika Anda tidak ingin menggunakan cache, pilih ** Tidak ada cache**.
+ Jika Anda ingin menggunakan cache Amazon S3, pilih ** Amazon S3**, lalu lakukan hal berikut:
+ Untuk ** Bucket**, pilih nama bucket S3 tempat cache disimpan.
+ (Opsional) Untuk awalan jalur ** Cache**, masukkan awalan jalur Amazon S3. Nilai aw ** alan ** Cache path mirip dengan nama direktori. Ini memungkinkan Anda untuk menyimpan cache di bawah direktori yang sama dalam ember.
**penting**
Jangan menambahkan garis miring (/) pada akhir awalan jalur.
+ Jika Anda ingin menggunakan cache lokal, pilih ** Lokal**, lalu pilih satu atau lebih mode cache lokal.
**catatan**
Mode cache lapisan Docker hanya tersedia untuk Linux. Jika Anda memilihnya, proyek Anda harus berjalan dalam mode istimewa.
Menggunakan cache menghemat waktu pembuatan yang cukup besar karena bagian lingkungan build yang dapat digunakan kembali disimpan dalam cache dan digunakan di seluruh build. Untuk informasi tentang menentukan cache dalam file buildspec, lihat. [Sintaks Buildspec](build-spec-ref.md#build-spec-ref-syntax) Untuk informasi selengkapnya tentang caching, lihat[Cache dibangun untuk meningkatkan kinerja](build-caching.md).
1. Pilih ** Buat proyek pembangunan**. Pada halaman proyek build, pilih ** Mulai membangun**.