Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menghubungkan ke CI/CD jaringan pipa
Integrasi pipa CI/CD memungkinkan AWS DevOps Agen untuk memantau penerapan dan mengkorelasikan perubahan kode dengan insiden operasional selama penyelidikan. Dengan menghubungkan CI/CD penyedia Anda, agen dapat melacak peristiwa penyebaran dan mengaitkannya dengan AWS sumber daya untuk membantu mengidentifikasi akar penyebab potensial selama respons insiden.
AWS DevOps Agen mendukung integrasi dengan CI/CD platform populer melalui proses dua langkah:
1. **Registrasi tingkat akun** — Daftarkan CI/CD penyedia Anda sekali di tingkat akun AWS
1. **Koneksi Ruang Agen** - Hubungkan proyek atau repositori tertentu ke Ruang Agen individual berdasarkan kebutuhan organisasi Anda
Pendekatan ini memungkinkan Anda untuk berbagi pendaftaran CI/CD penyedia di beberapa Ruang Agen sambil mempertahankan kontrol terperinci atas proyek mana yang dipantau oleh setiap ruang.
## CI/CD Penyedia yang didukung
AWS DevOps Agen mendukung CI/CD platform berikut:
+ **GitHub**— Connect repositori [GitHubdari.com](http://GitHub.com) menggunakan aplikasi AWS DevOps Agen GitHub .
+ **GitLab**— Connect project [GitLabdari.com,](http://gitlab.com) GitLab instans terkelola, atau penerapan GitLab self-host yang dapat diakses publik.
**Topik**
+ [Menghubungkan GitHub](connecting-to-cicd-pipelines-connecting-github.md)
+ [Menghubungkan GitLab](connecting-to-cicd-pipelines-connecting-gitlab.md)
# Menghubungkan GitHub
GitHub integrasi memungkinkan AWS DevOps Agen untuk mengakses repositori kode dan menerima peristiwa penyebaran selama investigasi insiden. Integrasi ini mengikuti proses dua langkah: pendaftaran tingkat akun GitHub, diikuti dengan menghubungkan repositori tertentu ke Ruang Agen individu.
AWS DevOps Agen mendukung GitHub instans.com (SaaS) dan Server GitHub Perusahaan (yang dihosting sendiri).
## Prasyarat
Sebelum menghubungkan GitHub, pastikan Anda memiliki:
+ Akses ke konsol admin AWS DevOps Agen
+ Akun GitHub pengguna atau organisasi dengan izin admin
+ Otorisasi untuk menginstal GitHub aplikasi di akun atau organisasi Anda
Untuk GitHub Enterprise Server, Anda juga membutuhkan:
+ Instans GitHub Enterprise Server (versi 3.x atau yang lebih baru) dapat diakses melalui HTTPS
+ URL HTTPS dari instance Server GitHub Perusahaan Anda (misalnya,`https://github.example.com`)
+ (Opsional) Koneksi pribadi, jika instans Server GitHub Perusahaan Anda tidak dapat diakses publik
## Mendaftar GitHub (tingkat akun)
GitHub terdaftar di tingkat AWS akun dan dibagikan di antara semua Ruang Agen di akun itu. Anda hanya perlu mendaftar GitHub sekali per AWS akun.
### Langkah 1: Arahkan ke penyedia pipa
1. Masuk ke Konsol AWS Manajemen
1. Arahkan ke konsol AWS DevOps Agen
1. Buka tab **Kemampuan**
1. Di bagian **Pipeline**, klik **Tambah**
1. Pilih **GitHub**dari daftar penyedia yang tersedia
Jika GitHub belum terdaftar, Anda akan diminta untuk mendaftarkannya terlebih dahulu.
### Langkah 2: Pilih jenis koneksi
Pada layar “Daftarkan GitHub Akun/Organisasi”, pilih apakah Anda terhubung sebagai pengguna atau organisasi:
+ **Pengguna** — GitHub Akun pribadi Anda dengan nama pengguna dan profil
+ **Organisasi** — GitHub Akun bersama tempat banyak orang dapat berkolaborasi di banyak proyek sekaligus
Jika Anda terhubung ke instance GitHub Enterprise Server, centang kotak centang **Use GitHub Enterprise Server** dan masukkan URL HTTPS instance Anda (misalnya,`https://github.example.com`).
Jika instans Server GitHub Perusahaan Anda tidak dapat diakses publik, Anda dapat mengonfigurasi koneksi pribadi secara opsional agar AWS DevOps Agen dapat menjangkau instans Anda dengan aman. Untuk informasi selengkapnya, lihat [Menghubungkan ke alat yang dihosting secara pribadi](configuring-capabilities-for-aws-devops-agent-connecting-to-privately-hosted-tools.md).
**catatan**
**Jangan sertakan `/api/v3` atau trailing path apa pun di URL — masukkan hanya URL dasar.
### Langkah 3: Siapkan GitHub Aplikasi
Klik **Kirim** untuk memulai proses penyiapan aplikasi. Langkah selanjutnya berbeda tergantung pada apakah Anda terhubung GitHub ke.com atau GitHub Enterprise Server.
#### Untuk GitHub .com
1. Anda akan diarahkan GitHub untuk menginstal GitHub aplikasi AWS DevOps Agen.
1. Pilih akun atau organisasi mana yang akan menginstal aplikasi.
1. Aplikasi ini memungkinkan AWS DevOps Agen untuk menerima peristiwa dari repositori yang terhubung, termasuk peristiwa penerapan.
#### Untuk Server GitHub Perusahaan
GitHub Enterprise Server menggunakan alur Manifes GitHub Aplikasi, yang secara otomatis menyiapkan GitHub Aplikasi baru di instans Anda. Ini melibatkan dua pengalihan ke instance Server GitHub Perusahaan Anda.
1. Browser Anda akan diarahkan ke halaman “Buat GitHub Aplikasi” instance GitHub Enterprise Server Anda.
1. Anda akan melihat nama aplikasi yang sudah diisi sebelumnya. Jangan ragu untuk mengubah nama sesuai kebutuhan. Klik **Buat GitHub Aplikasi**.
1. Anda akan diarahkan kembali ke AWS DevOps Agen, yang menukar kode manifes dengan kredensi aplikasi.
### Langkah 4: Pilih repositori dan selesaikan instalasi
1. Anda akan melihat halaman **Instal & Otorisasi** untuk GitHub Aplikasi.
1. Pilih repositori mana yang memungkinkan aplikasi mengakses:
+ **Semua repositori** - Berikan akses ke semua repositori saat ini dan masa depan
+ **Hanya pilih repositori - Pilih repositori** tertentu dari akun atau organisasi Anda
1. Klik **Instal & Otorisasi**.
1. Anda akan diarahkan kembali ke konsol AWS DevOps Agen, di mana GitHub akan muncul sebagai terdaftar di tingkat akun.
## Menghubungkan repositori ke Ruang Agen
Setelah mendaftar GitHub di tingkat akun, Anda dapat menghubungkan repositori tertentu ke Ruang Agen individual:
1. Di konsol AWS DevOps Agen, pilih Ruang Agen
1. Buka tab **Kemampuan**
1. Di bagian **Pipeline**, klik **Tambah**
1. Pilih **GitHub**dari daftar penyedia yang tersedia
1. Pilih subset repositori yang relevan dengan Ruang Agen ini
1. Klik **Tambah** untuk menyelesaikan koneksi
Anda dapat menghubungkan kumpulan repositori yang berbeda ke Ruang Agen yang berbeda berdasarkan kebutuhan organisasi Anda.
## Memahami GitHub aplikasi
GitHub Aplikasi AWS DevOps Agen:
+ Meminta akses hanya-baca ke repositori Anda
+ Menerima peristiwa penyebaran dan acara repositori lainnya
+ Memungkinkan AWS DevOps Agen untuk mengkorelasikan perubahan kode dengan insiden operasional
+ Dapat di-uninstall kapan saja melalui pengaturan Anda GitHub
Untuk Server GitHub Perusahaan, GitHub Aplikasi secara otomatis dibuat pada instans Anda saat pendaftaran. Anda dapat mengelola akses repositori aplikasi atau menghapus instalannya melalui **Pengaturan> Aplikasi > Aplikasi** Terinstal. GitHub Untuk menghapus definisi aplikasi sepenuhnya, buka **Pengaturan > Pengaturan pengembang > GitHub Aplikasi**.
## Mengelola GitHub koneksi
+ **Memperbarui akses repositori** — Untuk mengubah repositori mana yang dapat diakses GitHub aplikasi, buka pengaturan GitHub akun atau organisasi Anda (atau pengaturan instans Server GitHub Perusahaan Anda), navigasikan ke aplikasi yang diinstal, dan ubah konfigurasi GitHub aplikasi Agen. AWS DevOps
+ **Melihat repositori yang terhubung** - Di konsol AWS DevOps Agen, pilih Ruang Agen Anda dan buka tab Kemampuan untuk melihat repositori yang terhubung di bagian Pipeline.
+ **Menghapus GitHub koneksi** - Untuk memutuskan sambungan GitHub dari Ruang Agen, pilih koneksi di bagian Pipeline dan klik **Hapus**. Untuk menghapus instalan GitHub aplikasi sepenuhnya, hapus instalannya dari pengaturan GitHub akun atau organisasi Anda. Untuk Server GitHub Perusahaan, karena GitHub Aplikasi dibuat langsung pada instans Anda saat pendaftaran, Anda dapat membersihkan aplikasi secara opsional sepenuhnya dengan melakukan kedua hal berikut:
+ **Copot pemasangan aplikasi** — Buka **Pengaturan> Aplikasi > GitHub Aplikasi Terinstal**, klik **Konfigurasi** pada aplikasi, lalu hapus instalannya.
+ **Hapus aplikasi** — Buka **Pengaturan> Pengaturan pengembang > GitHub Aplikasi**, pilih aplikasi, buka tab **Lanjutan**, dan pilih **Hapus GitHub Aplikasi**. **Peringatan:** Menghapus GitHub Aplikasi bersifat permanen dan tidak dapat dibatalkan. Jika Anda menghapusnya, Anda harus mendaftarkan ulang GitHub Enterprise Server dari awal di konsol AWS DevOps Agen untuk membuat aplikasi baru.
# Menghubungkan GitLab
GitLab integrasi memungkinkan AWS DevOps Agen untuk memantau penyebaran dari GitLab Pipelines untuk menginformasikan penyelidikan kausal selama respons insiden. Integrasi ini mengikuti proses dua langkah: pendaftaran tingkat akun GitLab, diikuti dengan menghubungkan proyek tertentu ke Ruang Agen individu.
## Mendaftar GitLab (tingkat akun)
GitLab terdaftar di tingkat AWS akun dan dibagikan di antara semua Ruang Agen di akun itu. Ruang Agen Individu kemudian dapat memilih proyek spesifik mana yang berlaku untuk Ruang Agen mereka.
### Langkah 1: Arahkan ke penyedia pipa
1. Masuk ke Konsol AWS Manajemen
1. Arahkan ke konsol AWS DevOps Agen
1. Buka halaman **Penyedia Kemampuan** (dapat diakses dari navigasi samping)
1. Temukan **GitLab**di bagian Penyedia **yang tersedia** di bawah **Pipeline** dan klik **Daftar**
### Langkah 2: Konfigurasikan GitLab koneksi
Pada halaman GitLab pendaftaran, konfigurasikan yang berikut:
**Jenis koneksi** - Pilih apakah Anda terhubung sebagai pribadi atau grup:
+ **Pribadi** (default) - Akun GitLab pengguna individual Anda dengan nama pengguna dan profil
+ **Grup** — Di GitLab, Anda menggunakan grup untuk mengelola satu atau lebih proyek terkait secara bersamaan
**GitLab tipe instans** - Pilih jenis GitLab instans yang Anda sambungkan:
+ **GitLab.com** (default) — GitLab Pelayanan publik
+ **Hosting mandiri yang dapat diakses publik GitLab** - Centang kotak **Use GitLab self hosted endpoint** dan berikan URL ke instans Anda GitLab
**catatan**
**Saat ini, hanya GitLab instans yang dapat diakses publik yang didukung.
**Token akses** — Berikan token akses GitLab pribadi:
1. Di tab browser terpisah, masuk ke GitLab akun Anda
1. Arahkan ke pengaturan pengguna Anda dan pilih **Access Tokens**
1. Buat token akses pribadi baru dengan izin berikut:
+ `read_repository`— Diperlukan untuk mengakses konten repositori
+ `read_virtual_registry`— Diperlukan untuk mengakses informasi registri virtual
+ `read_registry`— Diperlukan untuk mengakses informasi registri
+ `api`— Diperlukan untuk akses API baca dan tulis
+ `self_rotate`- Diperlukan untuk memutar token. Fitur ini saat ini tidak didukung oleh AWS DevOps Agen tetapi akan didukung di kemudian hari. Menambahkan sekarang mencegah kebutuhan untuk membuat token baru di masa depan.
1. Setel kedaluwarsa token ke maksimum 365 hari dari tanggal saat ini
1. Salin token yang dihasilkan
1. Kembali ke konsol AWS DevOps Agen
1. Tempelkan token ke bidang “Token Akses”
### Langkah 3: Selesaikan pendaftaran
**(Opsional) Tag** - Tambahkan AWS tag ke GitLab pendaftaran untuk tujuan organisasi.
Klik **Berikutnya** untuk meninjau konfigurasi Anda, lalu klik **Kirim** untuk menyelesaikan proses GitLab pendaftaran. Sistem akan memvalidasi token akses Anda dan membuat koneksi.
## Menghubungkan proyek ke Ruang Agen
Setelah mendaftar GitLab di tingkat akun, Anda dapat menghubungkan proyek tertentu ke Ruang Agen individu:
1. Di konsol AWS DevOps Agen, pilih Ruang Agen Anda
1. Buka tab **Kemampuan**
1. Di bagian **Pipeline**, klik **Tambah**
1. Pilih **GitLab**dari daftar penyedia yang tersedia
1. Pilih GitLab proyek yang relevan dengan Ruang Agen Anda
1. Klik **Simpan**
AWS DevOps Agen akan memantau proyek-proyek ini untuk penyebaran dari GitLab Pipelines untuk menginformasikan penyelidikan kausal.
## Mengelola GitLab koneksi
+ **Memperbarui token akses** — Jika token akses Anda kedaluwarsa atau perlu diperbarui, Anda dapat memperbaruinya di konsol AWS DevOps Agen dengan memodifikasi GitLab pendaftaran di tingkat akun.
+ **Melihat proyek yang terhubung** — Di konsol AWS DevOps Agen, pilih Ruang Agen Anda dan buka tab Kemampuan untuk melihat proyek yang terhubung di bagian Pipeline.
+ **Menghapus GitLab koneksi** - Untuk memutuskan GitLab proyek dari Ruang Agen, pilih koneksi di bagian Pipeline dan klik **Hapus**. Untuk menghapus GitLab pendaftaran sepenuhnya, hapus dari semua Ruang Agen terlebih dahulu, lalu hapus pendaftaran di tingkat akun.