Hubungkan layanan kode sumber

Berikan agen Anda akses ke konteks repositori, isu, dan pull request untuk investigasi. Aplikasi ini dapat membaca perubahan terbaru, menemukan masalah terkait, dan membuka masalah atau pull request di repositori atau proyek yang tepat ketika kredensial yang Anda berikan mengizinkannya.

Tutorial ini membahas GitHub, Azure DevOps, dan GitLab. Koneksi kode sumber menggunakan halaman Code Access (Builder > Code Access), bukan wizard konektor terkelola. Artikel ini berfokus pada detail kode sumber: bagaimana setiap layanan mengautentikasi dan cara memvalidasi koneksi.

Prasyarat

• Agen SRE yang berjalan dan akses ke sre.azure.com.
• Izin untuk mengonfigurasi agen.
• Akun di layanan yang memiliki akses ke repositori atau proyek yang harus dibaca oleh agen.

Untuk layanan notifikasi, lihat Hubungkan layanan notifikasi.

Konektor kode sumber

Connector	Layanan	Authentication	Kegunaan umum
GitHub	GitHub dan GitHub Enterprise Cloud	Bawa Aplikasi GitHub Anda sendiri (OAuth dan PAT juga didukung untuk github.com)	Membaca repositori, edisi, dan permintaan pull di berbagai proyek dan organisasi; buat masalah atau pull request dengan persetujuan
Azure DevOps	Azure DevOps	Identitas terkelola (OAuth dan PAT juga didukung)	Repositori baca dan permintaan pull di berbagai proyek; buat pull request atau item kerja dengan persetujuan
GitLab	GitLab	Token akses pribadi (PAT)	Membaca repositori, masalah, dan permintaan penggabungan; buat masalah dan komentar dengan persetujuan

GitHub dan Azure DevOps menyajikan pilihan otentikasi sebagai tombol radio. GitLab menggunakan token akses pribadi.

Langkah 1: Akses Kode Terbuka

1. Buka sre.azure.com dan pilih agen Anda.
2. Di sidebar kiri, perluas Builder, lalu pilih Code Access.
3. Pilih tab untuk layanan Anda (GitHub, Azure DevOps, atau GitLab).
4. Pilih Tambahkan repositori.

Langkah 2: Autentikasi

Dialog Tambah repositori akan dibuka dengan panduan tiga langkah: Pilih platform → Autentikasi → Tambah repositori. Pilih Berikutnya setelah setiap langkah. Langkah terakhir memiliki tombol Simpan .

GitHub

Gunakan Bring your own GitHub App for GitHub Enterprise Cloud atau untuk mengatur akses berdasarkan organisasi atau instalasi.

1. Di bawah Metode Masuk, pilih Bawa Aplikasi GitHub Anda sendiri.
2. Selesaikan kolom pengaturan aplikasi yang ditampilkan oleh wizard.
3. Pilih Selanjutnya.

GitHub Enterprise Cloud (.ghe.com) memerlukan koneksi aplikasi GitHub. Untuk github.com, akun Anda (OAuth, jika dikonfigurasi untuk lingkungan Anda) atau token akses pribadi juga didukung, meskipun opsi GitHub App lebih disukai untuk skenario produksi agar izin dan visibilitas audit lebih rinci.

Setelah terhubung, agen dapat mencari repositori, isu, dan permintaan tarik di berbagai proyek dan organisasi yang dapat diakses aplikasi atau akun Anda.

Azure DevOps

Gunakan Managed Identity untuk penggunaan produksi, yang menghindari kredensial yang bertahan lama.

1. Di bawah Metode Masuk, pilih Managed Identity.
2. Lengkapi kolom yang ditampilkan oleh wizard, dan pastikan identitas yang dikelola agen memiliki akses ke proyek dan repositori Azure DevOps yang dibutuhkan agen.
3. Pilih Selanjutnya.

Autentikasi akun Anda (OAuth) dan Personal access token juga didukung, tetapi paling cocok untuk pengembangan, pengujian, atau skenario di mana identitas terkelola tidak dapat digunakan. Gunakan identitas atau token yang paling sempit yang dapat membaca proyek dan repositori yang dibutuhkan agen.

Setelah terhubung, agen dapat mencari repositori, membaca permintaan tarik, dan memeriksa item kerja di seluruh proyek Anda.

GitLab

1. Masukkan token akses pribadi (PAT) GitLab.
2. Pilih Selanjutnya.

Berikan PAT hanya lingkup yang dibutuhkan agen untuk akses repositori, penerbitan, dan permintaan penggabungan.

Setelah terhubung, agen dapat membaca repositori, masalah, dan permintaan penggabungan dalam proyek yang dapat diakses token.

Layanan melihat identitas yang mengizinkan koneksi. Isu, komentar, dan aktivitas pull request yang dibuat agen akan muncul di bawah akun tersebut.

Langkah 3: Tambahkan repositori

Langkah Tambah repositori menampilkan tabel di mana Anda menentukan repositori mana yang diindeks oleh agen. Setiap baris adalah satu repositori.

1. Jika layanan Anda Azure DevOps, pilih project dari dropdown Azure DevOps Project. Kolom URL Repositori diisi oleh repositori dalam proyek tersebut.

2. Di kolom URL Repositori , pilih repositori dari dropdown atau ketik URL secara langsung. Untuk GitHub dan GitLab, dropdown mencantumkan repositori yang dapat diakses oleh kredensial Anda. Untuk Azure DevOps, aplikasi ini mencantumkan repositori dalam proyek yang dipilih.

3. Di kolom Nama Tampilan , masukkan nama singkat yang digunakan agen untuk merujuk ke repositori.

4. Secara opsional, isi kolom Deskripsi untuk memberikan agen konteks lebih lanjut tentang apa saja yang ada di repositori.

5. Jika layanan Anda adalah Azure DevOps dan repositorinya sangat besar, aktifkan kotak centang Remote. Agen menggunakan pencarian berbasis AI pada salinan jarak jauh, bukan mengkloningnya secara lokal. Repositori dikloning dengan batas disk 100 GB; mengaktifkan Remote menghindari batasan tersebut.

6. Untuk menambahkan repositori lain, pilih Tambah dan isi baris berikutnya.

7. Setelah tabel selesai, pilih Save.

Langkah 4: Validasi dengan sebuah skenario

1. Buka obrolan dengan agen Anda.

2. Ajukan pertanyaan yang dibaca, seperti:

   List the open issues in the payments repository from the last week.
   

3. Periksa kartu alat untuk melihat agen mencari layanan dan mengembalikan hasil yang didasarkan pada data Anda.

Ketika hasil muncul yang merujuk pada repositori Anda, koneksi akan berjalan dari ujung ke ujung.

Troubleshooting

Problem	Cause	Perbaiki
Pencarian tidak mengembalikan hasil	Akun tidak memiliki akses ke proyek atau repositori	Konfirmasi akun koneksi dapat melihat proyek atau repositori, lalu coba ulang.
Create gagal dengan kesalahan izin	Token atau akun tidak memiliki ruang tulis	Berikan cakupan yang diperlukan untuk token atau akun, atau gunakan kredensial yang memiliki akses tulis.
GitHub Enterprise Cloud menolak koneksi	GitHub Enterprise Cloud memerlukan koneksi GitHub App	Di halaman Code Access, putuskan koneksi GitHub, pilih Add repository, pilih GitHub, masukkan host Anda.ghe.com, dan pilih Bring your own GitHub App as the authentication method.

Konten terkait

• Hubungkan layanan notifikasi
• Hubungkan sumber telemetri
• Siapkan konektor terkelola