11. Deploy dari Public Repository
Untuk repositori publik di GitHub, Anda cukup memasukkan URL repositori HTTPS dan menentukan branch target:
1Buka form "Buat Project" dan pilih tab "GitHub (ADVANCED)".
2Masukkan URL repository GitHub (contoh: https://github.com/username/my-project).
3Pilih Branch target (default: main atau master).
4Tentukan Subfolder Root jika source code web berada di dalam subdirektori tertentu (misal: backend atau src).
22. Deploy dari Private Repository (Personal Access Token)
Jika repositori Anda berstatus Private, Anda dapat mengautentikasi clone menggunakan GitHub Personal Access Token (PAT) atau Fine-Grained Token yang aman:
1Buka GitHub.com -> Settings -> Developer Settings -> Personal access tokens -> Tokens (classic) atau Fine-grained tokens.
2Beri nama token (misal: 4Qonex Deploy Key) dan centang izin repo (khusus Fine-grained: pilih Repository Permissions -> Contents: Read-only).
3Salin token (diawali ghp_ atau github_pat_).
4Di form 4Qonex, centang "Repository ini bersifat Private" dan tempelkan token Anda.
Keamanan Token Terenkripsi
Token akses GitHub Anda disimpan secara aman dan terenkripsi di database 4Qonex dan hanya digunakan untuk proses git clone / git pull read-only.
33. Konfigurasi Webhook Auto-Deploy di GitHub
Agar project di 4Qonex otomatis di-redeploy setiap kali Anda melakukan `git push`, pasang Webhook URL di GitHub:
1Buka menu "Pengaturan Project" -> tab "GitHub & Auto-Deploy".
2Salin URL Webhook resmi project Anda (format: https://api.4qonex.com/api/webhooks/github/[project-id]).
3Buka halaman repositori Anda di GitHub -> klik tab "Settings" -> menu "Webhooks" -> klik "Add webhook".
4Tempelkan URL ke kolom "Payload URL".
5Ubah "Content type" menjadi "application/json".
6Pilih event "Just the push event", centang "Active", lalu klik "Add webhook".
Alur Kerja Otomatis (CI/CD)
Setiap kali Anda menjalankan `git push origin main`, GitHub akan mengirim sinyal webhook ke 4Qonex untuk menarik commit terbaru dan membangun container baru tanpa downtime!
