Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Koneksi untuk dikelola GitLab sendiri
Koneksi memungkinkan Anda untuk mengotorisasi dan membuat konfigurasi yang mengaitkan penyedia pihak ketiga Anda dengan sumber daya Anda AWS . Untuk mengaitkan repositori pihak ketiga Anda sebagai sumber untuk pipeline Anda, Anda menggunakan koneksi.
**catatan**
Alih-alih membuat atau menggunakan koneksi yang ada di akun Anda, Anda dapat menggunakan koneksi bersama antara yang lain Akun AWS. Lihat [Menggunakan koneksi yang dibagikan dengan akun lain](connections-shared.md).
**catatan**
Fitur ini tidak tersedia di Asia Pasifik (Hong Kong), Asia Pasifik (Hyderabad), Asia Pasifik (Jakarta), Asia Pasifik (Melbourne), Asia Pasifik (Osaka), Afrika (Cape Town), Timur Tengah (Bahrain), Timur Tengah (UEA), Eropa (Spanyol), Eropa (Zurich), Israel (Tel Aviv), atau (AS-Barat) Wilayah. AWS GovCloud Untuk mereferensikan tindakan lain yang tersedia, lihat[Integrasi produk dan layanan dengan CodePipeline](integrations.md). Untuk pertimbangan dengan tindakan ini di Wilayah Eropa (Milan), lihat catatan di[CodeStarSourceConnection untuk Bitbucket Cloud, GitHub Enterprise Server GitHub, GitLab .com, dan tindakan yang dikelola GitLab sendiri](action-reference-CodestarConnectionSource.md).
Untuk menambahkan tindakan sumber yang GitLab dikelola sendiri CodePipeline, Anda dapat memilih salah satu untuk:
+ Gunakan wizard **Buat pipeline CodePipeline ** konsol atau halaman **tindakan Edit** untuk memilih opsi penyedia yang **GitLabdikelola sendiri**. Lihat [Buat koneksi ke GitLab kelola sendiri (konsol)](#connections-gitlab-managed-console) untuk menambahkan tindakan. Konsol membantu Anda membuat sumber daya host dan sumber daya koneksi.
+ Gunakan CLI untuk menambahkan konfigurasi tindakan untuk `CreateSourceConnection` tindakan dengan `GitLabSelfManaged` penyedia dan membuat sumber daya Anda:
+ Untuk membuat sumber daya koneksi Anda, lihat [Buat host dan koneksi ke GitLab self-managed (CLI)](#connections-gitlab-managed-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, GitLab .com, dan tindakan yang dikelola GitLab sendiri](action-reference-CodestarConnectionSource.md) untuk menambahkan tindakan Anda seperti yang ditunjukkan pada[Buat pipeline (CLI)](pipelines-create.md#pipelines-create-cli).
**catatan**
Anda juga dapat membuat koneksi menggunakan konsol Alat Pengembang di bawah **Pengaturan**. Lihat [Membuat Koneksi](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-create.html).
Sebelum Anda memulai:
+ Anda harus sudah membuat akun dengan GitLab dan memiliki GitLab Enterprise Edition atau GitLab Community Edition dengan instalasi yang dikelola sendiri. Untuk informasi selengkapnya, lihat [https://docs.gitlab.com/ee/subscriptions/self\$1managed/](https://docs.gitlab.com/ee/subscriptions/self_managed/).
**catatan**
Koneksi hanya menyediakan akses untuk 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 sumber daya seperti. CodePipeline Untuk repositori dalam grup, Anda tidak perlu menjadi pemilik grup.
+ Anda harus sudah membuat token akses GitLab pribadi (PAT) dengan izin cakupan bawah berikut saja: api. Untuk informasi lebih lanjut, lihat [https://docs.gitlab.com/ee/user/profile/personal\$1access\$1tokens.html](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html). Anda harus menjadi administrator untuk membuat dan menggunakan PAT.
**catatan**
PAT Anda digunakan untuk mengotorisasi host dan tidak disimpan atau digunakan oleh koneksi. Untuk mengatur host, Anda dapat membuat PAT sementara dan kemudian setelah Anda mengatur host, Anda dapat menghapus PAT.
+ Anda dapat memilih untuk mengatur host Anda sebelumnya. Anda dapat mengatur host dengan atau tanpa VPC. Untuk detail tentang konfigurasi VPC dan informasi tambahan tentang membuat host, lihat [Membuat](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-host-create.html) host.
**Topics**
+ [Buat koneksi ke GitLab kelola sendiri (konsol)](#connections-gitlab-managed-console)
+ [Buat host dan koneksi ke GitLab self-managed (CLI)](#connections-gitlab-managed-cli)
## Buat koneksi ke GitLab kelola sendiri (konsol)
Gunakan langkah-langkah ini untuk menggunakan CodePipeline konsol guna menambahkan tindakan koneksi untuk repositori GitLab self-managedr Anda.
**catatan**
GitLab koneksi yang dikelola sendiri hanya menyediakan akses ke repositori yang dimiliki oleh akun yang GitLab dikelola sendiri yang digunakan untuk membuat koneksi.
**Sebelum Anda mulai:**
Untuk koneksi host ke GitLab self-managed, Anda harus telah menyelesaikan langkah-langkah untuk membuat sumber daya host untuk koneksi Anda. Lihat [Mengelola host untuk koneksi](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-hosts.html).
### Langkah 1: Buat atau edit pipeline Anda
**Untuk membuat atau mengedit pipeline**
1. Masuk ke CodePipeline konsol.
1. 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 **GitLab dikelola sendiri**.
+ 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 Action**, pilih yang **GitLab dikelola sendiri**.
1. Lakukan salah satu tindakan berikut:
+ Di bawah **Koneksi**, jika Anda belum membuat sambungan ke penyedia Anda, pilih **Connect to GitLab self-managed**. Lanjutkan ke Langkah 2: Buat Koneksi untuk GitLab dikelola sendiri.
+ Di bawah **Koneksi**, jika Anda telah membuat koneksi ke penyedia Anda, pilih koneksi, lalu lanjutkan ke Langkah 3: Simpan tindakan sumber yang GitLab dikelola sendiri.
### Langkah 2: Buat koneksi ke GitLab self-managed
Setelah Anda memilih untuk membuat koneksi, halaman **Connect to GitLab self-managed** akan ditampilkan.
**Untuk terhubung ke yang dikelola GitLab sendiri**
1. Di **Nama koneksi**, masukkan nama untuk koneksi Anda.
1. Di **URL**, masukkan titik akhir untuk server Anda.
**catatan**
Jika URL yang disediakan telah digunakan untuk menyiapkan host untuk koneksi, Anda akan diminta untuk memilih ARN sumber daya host yang dibuat sebelumnya untuk titik akhir tersebut.
1. Jika Anda telah meluncurkan server Anda ke VPC Amazon dan Anda ingin terhubung dengan VPC Anda, pilih Gunakan VPC dan lengkapi informasi untuk **VPC**.
1. Pilih **Connect to GitLab self-managed**. Koneksi yang dibuat ditampilkan dengan status **Tertunda**. Sumber daya host dibuat untuk koneksi dengan informasi server yang Anda berikan. Untuk nama host, URL digunakan.
1. Pilih **Perbarui koneksi tertunda.**
1. Jika halaman terbuka dengan pesan pengalihan yang mengonfirmasi bahwa Anda ingin melanjutkan ke penyedia, pilih **Lanjutkan**. Masukkan otorisasi untuk penyedia.
1. A **Menetapkan** tampilan *host\$1name* halaman. Di **Berikan token akses pribadi**, berikan GitLab PAT Anda hanya izin cakupan bawah berikut:. `api`
**catatan**
Hanya administrator yang dapat membuat dan menggunakan PAT.
Pilih **Lanjutkan**.
![\[Tangkapan layar konsol yang menampilkan entri token akses pribadi yang GitLab dikelola sendiri untuk host baru\]](http://docs.aws.amazon.com/id_id/codepipeline/latest/userguide/images/connections-create-glsm-pat.png)
1. Halaman koneksi yang menampilkan koneksi yang dibuat dalam status **Tersedia**.
### Langkah 3: Simpan tindakan sumber yang GitLab dikelola sendiri
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**
1. Dalam nama **Repositori, pilih nama** repositori pihak ketiga Anda.
1. Di bawah **pemicu Pipeline**, Anda dapat menambahkan pemicu jika tindakan Anda adalah CodeConnections tindakan. Untuk mengonfigurasi konfigurasi pemicu pipeline dan memfilter secara opsional dengan pemicu, lihat detail selengkapnya di. [Tambahkan pemicu dengan tipe acara permintaan push atau pull kode](pipelines-filter.md)
1. Dalam **format artefak Output**, Anda harus memilih format untuk artefak Anda.
+ **Untuk menyimpan artefak keluaran dari tindakan yang GitLab dikelola sendiri menggunakan metode default, pilih CodePipeline default.** Tindakan mengakses file dari repositori 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, pilih klon Penuh.** Opsi ini hanya dapat digunakan oleh tindakan CodeBuild hilir.
1. Pilih **Berikutnya** di wizard atau **Simpan** di halaman **Edit tindakan**.
## Buat host dan koneksi ke GitLab self-managed (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 `PENDING` status secara default. Setelah Anda membuat koneksi dengan CLI atau CloudFormation, gunakan konsol untuk mengedit koneksi untuk membuat statusnya. `AVAILABLE`
Anda dapat menggunakan AWS Command Line Interface (AWS CLI) untuk membuat host untuk koneksi terinstal.
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 status AWS CLI berada dalam `Pending` status secara default. Setelah Anda membuat host dengan CLI, gunakan konsol atau CLI untuk mengatur host untuk membuat statusnya. `Available`
**Untuk membuat host**
1. Buka terminal (Linux, macOS, atau Unix) atau command prompt (Windows). Gunakan AWS CLI untuk menjalankan **create-host** perintah, menentukan, `--name``--provider-type`, dan `--provider-endpoint` untuk koneksi Anda. Dalam contoh ini, nama penyedia pihak ketiga adalah `GitLabSelfManaged` dan titik akhir adalah `my-instance.dev`.
```
aws codestar-connections create-host --name MyHost --provider-type GitLabSelfManaged --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`.
1. Gunakan konsol untuk menyelesaikan penyiapan host dan memindahkan host ke status `Available`.
**Untuk membuat koneksi ke GitLab self-managed**
1. Buka terminal (Linux, macOS, atau Unix) atau command prompt (Windows). Gunakan AWS CLI untuk menjalankan **create-connection** perintah, menentukan `--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"
}
```
1. Gunakan konsol untuk mengatur koneksi yang tertunda.
1. 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 memfilter dengan pemicu, lihat detail selengkapnya di[Tambahkan pemicu dengan tipe acara permintaan push atau pull kode](pipelines-filter.md). Misalnya, berikut ini menambah tingkat pipa definisi JSON pipa. 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"
]
}
}
]
}
}
]
```