Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Anda dapat menggunakan GitHub Aplikasi untuk terhubung CodeBuild. GitHub Koneksi aplikasi didukung melalui AWS CodeConnections.
Akses penyedia sumber memungkinkan Anda memicu build dengan berlangganan GitHub acara webhook menggunakan CreateWebhook, atau menggunakannyaTutorial: Konfigurasikan CodeBuild pelari GitHub Tindakan yang di-host. CodeBuild
catatan
CodeConnections tersedia di wilayah yang lebih sedikit dari CodeBuild. Anda dapat menggunakan koneksi lintas wilayah di CodeBuild. Koneksi yang dibuat di wilayah keikutsertaan, tidak dapat digunakan di wilayah lain. Untuk informasi lebih lanjut, lihat AWS CodeConnections kuota dan titik akhir.
Topik
Langkah 1: Buat koneksi ke GitHub App (konsol)
Gunakan langkah-langkah ini untuk menggunakan CodeBuild konsol guna menambahkan koneksi untuk proyek Anda GitHub.
Untuk membuat koneksi ke GitHub
-
Ikuti petunjuk di Panduan Pengguna Alat Pengembang untuk Membuat koneksi ke GitHub.
Langkah 2: Berikan akses IAM peran CodeBuild proyek untuk menggunakan koneksi
Anda dapat memberikan akses IAM peran CodeBuild proyek untuk menggunakan GitHub token yang dijual oleh koneksi Anda.
Untuk memberikan akses IAM peran CodeBuild proyek
-
Buat IAM peran untuk CodeBuild proyek Anda dengan mengikuti petunjuk Memungkinkan CodeBuild untuk berinteraksi dengan AWS layanan lain untuk CodeBuild proyek Anda.
-
Saat mengikuti petunjuk, tambahkan IAM kebijakan berikut ke peran CodeBuild proyek Anda untuk memberikan akses ke koneksi.
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "codeconnections:GetConnectionToken", "codeconnections:GetConnection" ], "Resource": [
<connection-arn>
] } ] }
Langkah 3: Konfigurasikan CodeBuild untuk menggunakan koneksi baru
Anda dapat mengonfigurasi koneksi sebagai kredensi tingkat akun dan menggunakannya dalam proyek.
Untuk mengonfigurasi koneksi sebagai kredensi tingkat akun di AWS Management Console
-
Untuk penyedia Sumber, pilih GitHub.
-
Untuk Credential, lakukan salah satu hal berikut:
-
Pilih Kredensi sumber default untuk menggunakan kredensi sumber default akun Anda untuk diterapkan ke semua proyek.
-
Jika Anda tidak tersambung GitHub, pilih Kelola kredensi sumber default.
-
Untuk jenis Kredenal, pilih GitHub Aplikasi.
-
Di Koneksi, pilih untuk menggunakan koneksi yang ada atau buat koneksi baru.
-
-
Pilih Kredensi sumber kustom untuk menggunakan kredensi sumber kustom untuk mengganti setelan default akun Anda.
-
Untuk jenis Kredenal, pilih GitHub Aplikasi.
-
Di Koneksi, pilih untuk menggunakan koneksi yang ada atau buat koneksi baru.
-
-
Anda juga dapat mengatur beberapa token untuk CodeBuild proyek Anda. Untuk informasi selengkapnya, lihat Konfigurasikan beberapa token sebagai kredenal tingkat sumber.
Memecahkan masalah dengan Aplikasi GitHub
Informasi berikut dapat membantu Anda memecahkan masalah umum dengan Aplikasi. GitHub
Topik
Instal AWS Konektor untuk GitHub aplikasi di wilayah yang tidak diinginkan
Masalah: Anda menginstal AWS Konektor untuk GitHub dari GitHub Marketplace, tetapi koneksi dibuat di wilayah yang tidak diinginkan. Jika Anda mencoba mengonfigurasi ulang aplikasi di GitHub situs web, itu tidak akan berfungsi karena aplikasi sudah diinstal di GitHub akun Anda.
Kemungkinan penyebabnya: Aplikasi sudah diinstal di GitHub akun Anda, jadi Anda hanya dapat mengonfigurasi ulang izin aplikasi.
Solusi yang disarankan: Anda dapat membuat koneksi baru dengan ID instalasi di wilayah yang diinginkan.
-
Buka CodeConnections konsol di https://console.aws.amazon.com/codesuite/pengaturan/koneksi
dan arahkan ke wilayah yang diinginkan menggunakan pemilih wilayah di bilah navigasi konsol. AWS -
Ikuti petunjuk di Panduan Pengguna Alat Pengembang untuk Membuat koneksi ke GitHub.
catatan
Karena Anda telah menginstal AWS Connector for GitHub app, Anda dapat memilihnya daripada menginstal aplikasi baru.
Koneksi GitHub Aplikasi tidak memiliki akses ke repositori
Masalah: AWS Layanan yang menggunakan koneksi, seperti CodeBuild atau CodePipeline, melaporkan bahwa layanan tersebut tidak memiliki akses ke repositori atau repositori tidak ada. Beberapa pesan kesalahan yang mungkin termasuk:
-
Authentication required for primary source.
-
Unable to create webhook at this time. Please try again later.
-
Failed to create webhook. GitHub API limit reached. Please try again later.
- Kemungkinan penyebabnya: Anda mungkin telah menggunakan GitHub aplikasi dan belum memberikan cakupan izin webhook.
-
Solusi yang disarankan: Untuk memberikan cakupan izin yang diperlukan, ikuti petunjuk dalam Menavigasi ke GitHub Aplikasi yang ingin Anda tinjau atau ubah untuk
mengonfigurasi aplikasi yang diinstal. Di bawah bagian izin, Anda akan melihat aplikasi tidak memiliki izin webhooks, dan ada opsi bagi Anda untuk meninjau izin yang baru diminta. Tinjau dan terima izin baru. Untuk informasi selengkapnya, lihat Menyetujui izin yang diperbarui untuk Aplikasi. GitHub - Kemungkinan penyebabnya: Koneksi berfungsi seperti yang diharapkan, tetapi tiba-tiba tidak memiliki akses ke repositori.
-
Solusi yang memungkinkan: Mulailah dengan meninjau otorisasi
dan instalasi Anda, lalu verifikasi GitHub Aplikasi diotorisasi dan diinstal. Jika penginstalan GitHub Aplikasi ditangguhkan, maka Anda harus melepaskannya. Jika GitHub Aplikasi tidak diizinkan untuk koneksi UAT(Token Akses Pengguna) , atau tidak diinstal untuk koneksi IAT(Token Akses Instalasi) , koneksi yang ada tidak dapat digunakan lagi, dan Anda perlu membuat koneksi baru. Perhatikan bahwa menginstal ulang GitHub Aplikasi tidak akan menghidupkan kembali koneksi sebelumnya yang terkait dengan instalasi lama. Solusi yang mungkin: Jika koneksi adalah UAT koneksi, pastikan koneksi tidak digunakan secara bersamaan, seperti yang digunakan dalam beberapa proses build CodeBuild secara bersamaan. Ini karena GitHub segera membatalkan validasi yang dikeluarkan sebelumnya UAT jika token yang kedaluwarsa disegarkan oleh koneksi. Jika Anda perlu menggunakan UAT koneksi untuk beberapa CodeBuild build bersamaan, Anda dapat membuat beberapa koneksi dan menggunakan setiap koneksi secara independen.
Solusi yang mungkin: Jika UAT koneksi belum digunakan dalam 6 bulan terakhir, koneksi akan dibatalkan oleh. GitHub Untuk memperbaikinya, buat koneksi baru.
- Kemungkinan penyebabnya: Anda mungkin telah menggunakan UAT koneksi tanpa menginstal aplikasi.
-
Solusi yang disarankan: Meskipun membuat UAT koneksi tidak memerlukan pengaitkan koneksi dengan instalasi GitHub Aplikasi, penginstalan diperlukan agar repositori dapat diakses. Ikuti petunjuk untuk meninjau instalasi
untuk memastikan GitHub Aplikasi diinstal. Jika tidak diinstal, navigasikan ke halaman GitHub Aplikasi untuk menginstal aplikasi. Untuk informasi selengkapnya UAT tentang akses, lihat Tentang token akses pengguna .
IAMPeran AWS layanan tidak memiliki IAM izin yang diperlukan.
Masalah: Anda melihat salah satu pesan galat berikut:
-
Access denied to connection
<connection-arn>
-
Failed to get access token from
<connection-arn>
Solusi yang disarankan: Biasanya Anda menggunakan koneksi dengan AWS layanan, seperti CodePipeline atau CodeBuild. Ketika Anda memberikan AWS layanan IAM peran, AWS layanan dapat menggunakan izin peran untuk bertindak atas nama Anda. Pastikan IAM peran tersebut memiliki izin yang diperlukan. Untuk informasi selengkapnya tentang IAM izin yang diperlukan, lihat Memberikan akses IAM peran CodeBuild proyek untuk menggunakan koneksi dan Identitas dan manajemen akses untuk AWS CodeStar Pemberitahuan dan CodeConnections di Panduan Pengguna konsol Alat Pengembang.