Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
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
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
Masuk ke Konsol AWS Manajemen
Arahkan ke konsol AWS DevOps Agen
Buka tab Kemampuan
Di bagian Pipeline, klik Tambah
Pilih GitHubdari 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 sambungan pribadi secara opsional agar AWS DevOps Agen dapat menjangkau instans Anda dengan aman. Untuk informasi selengkapnya, lihat Menghubungkan ke alat yang dihosting secara pribadi.
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
Anda akan diarahkan GitHub untuk menginstal GitHub aplikasi AWS DevOps Agen.
Pilih akun atau organisasi mana yang akan menginstal aplikasi.
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 Enterprise Anda.
Browser Anda akan diarahkan ke halaman “Buat GitHub Aplikasi” instance GitHub Enterprise Server Anda.
Anda akan melihat nama aplikasi yang sudah diisi sebelumnya. Jangan ragu untuk mengubah nama sesuai kebutuhan. Klik Buat GitHub Aplikasi.
Anda akan diarahkan kembali ke AWS DevOps Agen, yang menukar kode manifes dengan kredensi aplikasi.
Langkah 4: Pilih repositori dan selesaikan instalasi
Anda akan melihat halaman Instal & Otorisasi untuk GitHub Aplikasi.
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
Klik Instal & Otorisasi.
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:
Di konsol AWS DevOps Agen, pilih Ruang Agen
Buka tab Kemampuan
Di bagian Pipeline, klik Tambah
Pilih GitHubdari daftar penyedia yang tersedia
Pilih subset repositori yang relevan dengan Ruang Agen ini
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 ke repositori Anda — Anda dapat meninjau izin tertentu selama instalasi Aplikasi GitHub
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.
GitHub Pembaruan izin aplikasi
AWS DevOps Agen dapat meminta pembaruan izin setelah Anda menginstal GitHub Aplikasi untuk mendukung fitur baru. Ketika ini terjadi:
Anda akan menerima pemberitahuan dari GitHub mengenai permintaan pembaruan izin.
Tinjau detail pembaruan untuk memahami izin baru apa yang diminta.
Terima permintaan untuk memberikan izin yang diperbarui.
Tidak ada perubahan yang diperlukan dalam layanan atau aplikasi Anda. Setelah Anda menerima izin yang diperbarui, token akses instalasi berikutnya yang diminta AWS DevOps Agen GitHub akan secara otomatis menyertakan izin baru.
catatan
Sampai Anda menerima pembaruan izin, AWS DevOps Agen terus beroperasi dengan izin yang diberikan sebelumnya. Kemampuan baru yang bergantung pada izin yang diperbarui tidak akan tersedia sampai Anda menyetujui permintaan tersebut.
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.
