View a markdown version of this page

Menghubungkan GitLab - AWS DevOps Agen
Mendaftar GitLab (tingkat akun)Menghubungkan proyek ke Ruang AgenMengkonfigurasi Tinjauan Kode dan Pengujian OtomatisMengelola GitLab koneksi

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

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. Setiap tautan pendaftaran ke satu GitLab pengguna atau satu GitLab grup.

Langkah 1: Arahkan ke penyedia pipa

  1. Masuk ke Konsol AWS Manajemen

  2. Arahkan ke konsol AWS DevOps Agen

  3. Buka halaman Penyedia Kemampuan (dapat diakses dari navigasi samping)

  4. Temukan GitLabdi bagian Penyedia yang tersedia di bawah Pipeline dan pilih 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 - Menyediakan token akses GitLab pribadi:

  1. Di tab browser terpisah, masuk ke GitLab akun Anda

  2. Arahkan ke pengaturan pengguna Anda dan pilih Access Tokens

  3. 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.

  4. Setel kedaluwarsa token ke maksimum 365 hari dari tanggal saat ini

  5. Salin token yang dihasilkan

  6. Kembali ke konsol AWS DevOps Agen

  7. Tempelkan token ke bidang “Token Akses”

Langkah 3: Selesaikan pendaftaran

(Opsional) Tag - Tambahkan AWS tag ke GitLab pendaftaran untuk tujuan organisasi.

Pilih Berikutnya untuk meninjau konfigurasi Anda, lalu pilih 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

  2. Buka tab Kemampuan

  3. Di bagian Pipeline, pilih Tambah

  4. Pilih GitLabdari daftar penyedia yang tersedia

  5. Pilih GitLab registrasi yang berisi proyek yang ingin Anda gunakan

  6. Pilih GitLab proyek yang relevan dengan Ruang Agen Anda

  7. Pilih Simpan.

AWS DevOps Agen memantau proyek-proyek ini untuk penyebaran dari GitLab Pipelines untuk menginformasikan penyelidikan kausal. Satu Ruang Agen dapat menggunakan proyek dari beberapa pendaftaran. Untuk menambahkan proyek dari pendaftaran lain, ulangi langkah-langkah ini.

Mengkonfigurasi Tinjauan Kode dan Pengujian Otomatis

Ketika Anda memilih proyek dalam langkah GitLab koneksi, mereka secara otomatis ditambahkan ke bagian Tinjauan Kode dan Pengujian Otomatis. Bagian ini mengonfigurasi proyek mana yang secara otomatis memicu kemampuan pengujian Rilis ulasan kode kesiapan dan otomatis.

Konfigurasi Tinjauan Kode dan Pengujian Otomatis meliputi:

  • Kemampuan — Pilih tinjauan kode dan kemampuan pengujian otomatis untuk setiap proyek. Bagian ini menyediakan dua pengaturan per proyek:

    • Tinjauan perubahan pemicu otomatis - Saat diaktifkan untuk proyek, DevOps Agen secara otomatis menjalankan Rilis ulasan kode kesiapan setiap kali permintaan gabungan dibuka atau diperbarui. Temuan tinjauan muncul sebagai komentar sebaris pada permintaan penggabungan. Ini diaktifkan secara default untuk semua proyek yang terhubung.

    • Pengujian verifikasi otomatis — Saat diaktifkan untuk proyek, DevOps Agen membangun, menjalankan, dan menguji perubahan kode Anda di lingkungan verifikasi terkelola selama peninjauan kode. Ini memberikan validasi fungsional di luar analisis statis. Untuk informasi selengkapnya, lihat Pengujian verifikasi otomatis. Ini diaktifkan secara default untuk semua proyek yang terhubung.

  • Daftar proyek - Menampilkan semua proyek yang Anda pilih selama langkah koneksi. Gunakan kolom pencarian untuk memfilter proyek berdasarkan nama. Setiap proyek memiliki kotak centang independen untuk kedua kemampuan.

  • Peran runtime (opsional) - Pilih peran IAM yang diasumsikan DevOps Agen untuk menjalankan kemampuan otomatis pada proyek yang Anda pilih. Peran ini digunakan saat mengakses layanan internal yang diperlukan selama pembuatan, seperti registrasi paket pribadi dan sistem penyimpanan artefak. Sebaiknya gunakan peran yang berbeda dari peran agen utama Anda.

Untuk mengonfigurasi ulasan otomatis:

  1. Setelah menghubungkan proyek Anda, navigasikan ke bagian Tinjauan Kode dan Pengujian Otomatis di pengaturan GitLab integrasi Anda.

  2. Untuk setiap proyek, aktifkan atau nonaktifkan kemampuan peninjauan perubahan pemicu otomatis tergantung pada apakah Anda ingin tinjauan permintaan gabungan otomatis.

  3. Untuk setiap proyek, aktifkan atau nonaktifkan kemampuan pengujian verifikasi otomatis tergantung pada apakah Anda ingin pengujian verifikasi otomatis di lingkungan verifikasi terkelola.

  4. Secara opsional, pilih peran IAM dari dropdown peran Runtime yang akan diambil DevOps Agen saat menjalankan kemampuan otomatis pada proyek yang Anda pilih.

  5. Pilih Simpan untuk menerapkan konfigurasi Anda.

Setelah dikonfigurasi, setiap permintaan penggabungan baru dalam proyek dengan Tinjauan perubahan pemicu otomatis diaktifkan akan secara otomatis memicu tinjauan kode kesiapan rilis. Jika pengujian verifikasi otomatis juga diaktifkan, peninjauan mencakup validasi fungsional dalam lingkungan verifikasi. Untuk informasi selengkapnya tentang ulasan kode, lihatRilis ulasan kode kesiapan.

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 pilih Hapus. Untuk menghapus GitLab pendaftaran sepenuhnya, hapus dari semua Ruang Agen terlebih dahulu, lalu hapus pendaftaran di tingkat akun.