Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
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 (Build + setup > Context > 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 pada layanan yang memiliki akses baca ke repositori atau proyek.
Untuk layanan notifikasi, lihat Menghubungkan layanan notifikasi.
Konektor kode sumber
| Connector | Layanan | Authentication | Kegunaan umum |
|---|---|---|---|
| GitHub | GitHub dan GitHub Enterprise Cloud | Gunakan Aplikasi GitHub Anda sendiri (OAuth dan PAT juga didukung untuk github.com) | Membaca repositori, issue, dan permintaan pull di berbagai proyek dan organisasi; buat issue atau pull request dengan persetujuan |
| Azure DevOps | Azure DevOps | Identitas terkelola (OAuth dan PAT juga didukung) | Baca repositori dan permintaan pull di berbagai proyek; buat pull request atau item kerja dengan persetujuan |
| GitLab | GitLab | Token akses pribadi (PAT) | Membaca repositori, issue, dan merge request; buat issue dan komentar dengan izin |
GitHub dan Azure DevOps menyajikan pilihan otentikasi sebagai tombol radio. GitLab menggunakan token akses pribadi.
Langkah 1: Buka Akses Kode
- Buka sre.azure.com dan pilih agen Anda.
- Di sidebar kiri, pilih Build + setup>Context>Code access.
- Pilih tab untuk layanan Anda (GitHub, Azure DevOps, atau GitLab).
- Pilih Tambahkan repositori.
Langkah 2: Autentikasi
Dialog Tambah repositori memiliki dua langkah: Koneksi dan Tambah repositori. Pada Connection, pilih platform dan masukkan URL repositori atau organisasi platform tersebut sebelum mengonfigurasi autentikasi. Pilih Next setelah terhubung, lalu Simpan pada langkah terakhir.
Pilih Gunakan Aplikasi GitHub Anda untuk GitHub Enterprise Cloud atau untuk mengatur akses berdasarkan organisasi atau instalasi.
- Masukkan URL Repositori lengkap, seperti
https://github.com/owner/repo. - Jika ada kredensial yang cocok, pilih Koneksi yang sudah ada untuk digunakan kembali atau Koneksi baru untuk mengonfigurasi yang lain.
- Pada metode koneksi, pilih Gunakan GitHub App Anda.
- Selesaikan kolom pengaturan aplikasi yang ditampilkan oleh wizard.
- Pilih Connect dan konfirmasi koneksi berhasil.
- Pilih Selanjutnya.
GitHub Enterprise Cloud (.ghe.com) memerlukan koneksi aplikasi GitHub. Untuk github.com, OAuth dan Personal access token (PAT) juga didukung. Autentikasi aplikasi GitHub memerlukan URI key RSA Key Vault (/keys/), bukan URI rahasia. Lihat Siapkan Aplikasi BYO GitHub.
Setelah terhubung, agen dapat mencari repositori, isu, dan permintaan tarik di berbagai proyek dan organisasi yang dapat diakses oleh aplikasi atau akun Anda.
Layanan mengenali identitas yang mengautorisasi koneksi. Isu, komentar, dan aktivitas pull request yang dibuat agen akan muncul di bawah akun tersebut.
Langkah 3: Tambahkan repositori
Tinjau repositori yang akan ditambahkan. Untuk GitHub, perluas setiap repositori untuk mengedit nama tampilan dan deskripsinya. Untuk Azure DevOps dan GitLab, edit kolom-kolom ini langsung di tabel.
Jika layanan Anda adalah Azure DevOps, pilih project dari dropdown Azure DevOps Project. Kolom URL Repositori terisi dengan repositori dalam proyek tersebut.
Tinjau URL Repository awal. Untuk entri lainnya, pilih repositori dari dropdown atau ketik URL secara langsung. Untuk Azure DevOps, pilih proyek terlebih dahulu.
Masukkan nama Display singkat yang digunakan agen untuk merujuk ke repositori. Untuk GitHub, perluas entri untuk menemukan kolom ini.
Secara opsional, masukkan Deskripsi untuk memberikan agen konteks lebih lanjut tentang repositori. Untuk GitHub, pilih terlebih dahulu Tambah deskripsi.
Jika lingkungan Azure DevOps Anda menawarkan opsi Remote, Anda dapat menggunakannya untuk pencarian berbasis AI tanpa mengkloning seluruh repositori. Opsi ini tidak tersedia di semua lingkungan.
Untuk menambahkan repositori lain, pilih Tambah repositori untuk GitHub atau Tambah pada grid Azure DevOps atau GitLab. Repositori GitHub tambahan dalam koneksi ini menggunakan host dan kredensial yang sama.
Setelah tabel selesai, pilih Save.
Langkah 4: Validasi dengan sebuah skenario
Buka obrolan dengan agen Anda.
Ajukan pertanyaan untuk dibacakan, seperti:
List the open issues in the payments repository from the last week.Periksa kartu alat untuk melihat agen menelusuri 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. |
| Pembuatan gagal karena kesalahan izin | Token atau akun tidak memiliki izin 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 .ghe.com host Anda, dan pilih Bring your own GitHub App sebagai metode autentikasi. |