

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

# GitLab akses masuk CodeBuild
<a name="access-tokens-gitlab-overview"></a>

Untuk GitLab, Anda menggunakan GitLab koneksi untuk mengakses penyedia sumber.

**Topics**
+ [Hubungkan CodeBuild ke GitLab](#connections-gitlab)

## Hubungkan CodeBuild ke GitLab
<a name="connections-gitlab"></a>

Koneksi memungkinkan Anda untuk mengotorisasi dan membuat konfigurasi yang mengaitkan penyedia pihak ketiga Anda dengan AWS sumber daya yang Anda gunakan AWS CodeConnections. Untuk mengaitkan repositori pihak ketiga Anda sebagai sumber untuk proyek build Anda, Anda menggunakan koneksi. 

Untuk menambahkan penyedia sumber GitLab Mandiri GitLab atau Mandiri CodeBuild, Anda dapat memilih salah satu untuk: 
+ Gunakan CodeBuild konsol ** Buat panduan proyek build ** atau ** halaman ** Edit Sumber untuk memilih opsi ** penyedia ** GitLab ** atau Man ** GitLab diri. Lihat [Buat koneksi ke GitLab (konsol)](#connections-gitlab-console) untuk menambahkan penyedia sumber. Konsol membantu Anda membuat sumber daya koneksi.
+ Gunakan CLI untuk membuat sumber daya koneksi Anda, lihat [Buat koneksi ke GitLab (CLI)](#connections-gitlab-cli) untuk membuat sumber daya koneksi dengan CLI.

**catatan**  
Anda juga dapat membuat koneksi menggunakan konsol Alat Pengembang di bawah Peng ** aturan**. Lihat [ Membuat Koneksi](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-create.html).

**catatan**  
Dengan mengotorisasi instalasi koneksi ini GitLab, Anda memberikan izin layanan kami untuk memproses data Anda dengan mengakses akun Anda, dan Anda dapat mencabut izin kapan saja dengan menghapus instalasi aplikasi.

### Buat koneksi ke GitLab
<a name="connections-gitlab-create"></a>

Bagian ini menjelaskan cara terhubung GitLab ke CodeBuild. Untuk informasi selengkapnya tentang koneksi GitLab , lihat [Hubungkan CodeBuild ke GitLab](#connections-gitlab).

Sebelum Anda memulai:
+ Anda harus sudah membuat akun dengan GitLab.
**catatan**  
Koneksi hanya menyediakan akses ke repositori yang dimiliki oleh akun yang digunakan untuk membuat dan mengotorisasi koneksi. 
**catatan**  
Anda dapat membuat koneksi ke repositori tempat Anda memiliki ** peran ** Pemilik GitLab, dan kemudian koneksi dapat digunakan dengan repositori dengan sumber daya seperti CodeBuild. Untuk repositori dalam grup, Anda tidak perlu menjadi pemilik grup.
+ Untuk menentukan sumber untuk proyek build Anda, Anda harus telah membuat repositori pada GitLab.

**Topics**
+ [Buat koneksi ke GitLab (konsol)](#connections-gitlab-console)
+ [Buat koneksi ke GitLab (CLI)](#connections-gitlab-cli)

#### Buat koneksi ke GitLab (konsol)
<a name="connections-gitlab-console"></a>

Gunakan langkah-langkah ini untuk menggunakan CodeBuild konsol untuk menambahkan koneksi untuk proyek Anda (repositori) di GitLab.

**catatan**  
Alih-alih membuat atau menggunakan koneksi yang ada di akun Anda, Anda dapat menggunakan koneksi yang dibagikan dari AWS akun lain. Untuk informasi selengkapnya, lihat [ Berbagi koneksi dengan AWS akun](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-share.html).

**Untuk membuat atau mengedit proyek build**

1. Masuk ke CodeBuild konsol.

1. Pilih salah satu dari berikut ini.
   + Pilih untuk membuat proyek pembangunan. Ikuti langkah-langkah [Membuat proyek build (konsol)](create-project.md#create-project-console) untuk menyelesaikan layar pertama dan di ** bagian ** Sumber, di bawah Penye ** dia Sumber**, pilih ** GitLab**.
   + Pilih untuk mengedit proyek build yang ada. Pilih ** Edit**, lalu pilih ** Sumber**. Di ** halaman ** Edit Sumber, di bawah ** Penyedia Sumber**, pilih ** GitLab**.

1. Pilih salah satu cara berikut:
   + Di bawah ** Koneksi**, pilih ** Koneksi default**. Koneksi default menerapkan GitLab koneksi default di semua proyek.
   + Di bawah ** Koneksi**, pilih ** Koneksi khusus**. Koneksi kustom menerapkan GitLab koneksi kustom yang menggantikan setelan default akun Anda.

1. Lakukan salah satu tindakan berikut:
   + Di bawah Koneksi ** default ** atau Koneksi ** khusus**, jika Anda belum membuat koneksi ke penyedia Anda, pilih ** Buat GitLab koneksi baru**. Lanjutkan ke langkah 5 untuk membuat koneksi.
   + Di bawah ** Kon ** eksi, jika Anda telah membuat koneksi ke penyedia Anda, pilih koneksi. Lanjutkan ke langkah 10.
**catatan**  
Jika Anda menutup jendela pop-up sebelum GitLab koneksi dibuat, Anda perlu menyegarkan halaman.

1. Untuk membuat koneksi ke GitLab repositori, di bawah ** Pilih penyedia**, pilih ** GitLab**. Di **Nama koneksi**, masukkan nama untuk koneksi yang ingin Anda buat. Pilih Hu ** bungkan ke GitLab**.  
![Tangkapan layar konsol menunjukkan opsi koneksi yang dipilih untuk GitLab.](http://docs.aws.amazon.com/id_id/codebuild/latest/userguide/images/connections-create-gitlab.png)

1. Saat halaman masuk ditampilkan, GitLab masuk dengan kredensi Anda, lalu pilih Mas ** uk. **

1. Jika ini adalah pertama kalinya Anda mengotorisasi koneksi, halaman otorisasi ditampilkan dengan pesan yang meminta otorisasi untuk koneksi untuk mengakses GitLab akun Anda.

   Pilih **Izinkan**.  
![Tangkapan layar yang menunjukkan pesan untuk mengotorisasi koneksi untuk GitLab akun Anda.](http://docs.aws.amazon.com/id_id/codebuild/latest/userguide/images/gitlab-authorization.png)

1. Browser kembali ke halaman konsol koneksi. Di bawah pengaturan ** GitLab koneksi**, koneksi baru ditampilkan di Nama ** koneksi**.

1. Pilih **Hubungkan**.

   Setelah GitLab koneksi berhasil dibuat, spanduk sukses akan ditampilkan di bagian atas. 

1. Pada ** halaman ** Buat proyek build, di daftar ** drop-down koneksi ** default ** atau koneksi ** kustom, pastikan ARN koneksi Anda terdaftar. Jika tidak, pilih tombol refresh agar muncul.

1. Di ** Repositori**, pilih nama proyek Anda GitLab dengan menentukan jalur proyek dengan namespace. Misalnya, untuk repositori tingkat grup, masukkan nama repositori dalam format berikut:. `group-name/repository-name` Untuk informasi selengkapnya tentang jalur dan namespace, lihat `path_with_namespace` bidang di [ https://docs.gitlab.com/ee/api/projects.html \#get - ](https://docs.gitlab.com/ee/api/projects.html#get-single-project) single-project. Untuk informasi selengkapnya tentang namespace di GitLab, lihat [ https://docs.gitlab.com/ee/user/namespace/](https://docs.gitlab.com/ee/user/namespace/).
**catatan**  
Untuk grup di GitLab, Anda harus secara manual menentukan jalur proyek dengan namespace. Misalnya, untuk repositori bernama `myrepo` dalam grup`mygroup`, masukkan yang berikut ini:`mygroup/myrepo`. Anda dapat menemukan jalur proyek dengan namespace di URL di GitLab.

   

1. Dalam versi ** Sumber - opsional**, masukkan ID permintaan tarik, cabang, ID komit, tag, atau referensi dan ID komit. Untuk informasi selengkapnya, lihat [Contoh versi sumber dengan AWS CodeBuild](sample-source-version.md).
**catatan**  
Kami menyarankan Anda memilih nama cabang Git yang tidak terlihat seperti ID komit, seperti `811dd1ba1aba14473856cee38308caed7190c0d` atau`5392f7`. Ini membantu Anda menghindari tabrakan checkout Git dengan commit aktual.

   

1. Di kedalaman klon ** Git - opsional**, Anda dapat membuat klon dangkal dengan riwayat terpotong ke jumlah commit yang ditentukan. Jika Anda ingin klon penuh, pilih Pen ** uh**.

1. Di Status ** Build - opsional**, pilih ** Laporkan status build ke penyedia sumber saat build Anda dimulai dan selesai ** jika Anda ingin status mulai dan penyelesaian build dilaporkan ke penyedia sumber Anda.

   Untuk dapat melaporkan status build ke penyedia sumber, pengguna yang terkait dengan penyedia sumber harus memiliki akses tulis ke repo. Jika pengguna tidak memiliki akses tulis, status build tidak dapat diperbarui. Untuk informasi selengkapnya, lihat [Akses penyedia sumber](access-tokens.md).

#### Buat koneksi ke GitLab (CLI)
<a name="connections-gitlab-cli"></a>

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 berada dalam `PENDING` status secara default. Setelah Anda membuat koneksi dengan CLI atau CloudFormation, gunakan konsol untuk mengedit koneksi untuk membuat stat `AVAILABLE` usnya.

**Untuk membuat koneksi**
+ Ikuti petunjuk di Panduan Pengguna konsol Alat * Pengembang * untuk [ Membuat koneksi ke GitLab (CLI)](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-create-gitlab.html#connections-create-gitlab-cli).