Integrasi
GitHub
Kirim kode aplikasimu ke repositori privat di akun GitHub kamu sendiri, push versi baru kapan pun kamu mau, dan berikan kodenya ke developer.
Kode aplikasimu adalah milikmu. Dengan GitHub, kamu bisa menyimpan salinannya di repositori privat pada akun GitHub kamu sendiri, mengirim versi yang lebih baru ke sana kapan pun kamu mau, dan membagikannya ke developer. Ekspor ke GitHub tersedia di semua paket dan tidak memakai kredit.
Cara kerja sinkronisasi GitHub
| Yang kamu lakukan | Yang terjadi |
|---|---|
| Mengirim proyekmu untuk pertama kali | Buildliy membuat repositori privat di akun GitHub kamu, dengan nama sesuai proyekmu (misalnya buildliy-candle-shop, atau buildliy-candle-shop-2 kalau nama itu sudah dipakai), lalu mengirim versi terbarumu beserta README |
| Terus membuat di Buildliy | Tidak ada yang dikirim otomatis. Titik kecil di ikon GitHub memberi tahu kamu bahwa ada versi yang lebih baru yang belum ada di GitHub |
| Pilih Push versi terbaru | Versi terbarumu masuk ke repositori sebagai commit baru |
| Ada orang yang mengedit repositori di GitHub | Buildliy tidak menimpa hasil kerja mereka. Pembaruanmu datang sebagai pull request yang bisa kamu tinjau dan gabungkan (merge) di GitHub |
Perubahan yang dibuat di GitHub tetap ada di GitHub. Perubahan itu tidak mengalir balik ke proyek Buildliy kamu atau pratinjaunya.
Hubungkan GitHub dan buat repositorimu
Klik ikon GitHub
Buka proyekmu lalu klik ikon GitHub di sebelah Terbitkan, di kanan atas. Kalau kamu belum menghubungkan GitHub, kamu akan dibawa ke GitHub.
Setujui di GitHub
Masuk ke GitHub kalau perlu, lalu setujui Buildliy. GitHub akan menampilkan apa yang diminta Buildliy: akses penuh ke repositorimu, baik publik maupun privat, yang dibutuhkan untuk membuat dan memperbarui repositori proyekmu, serta akses hanya-baca ke profilmu. Kamu akan kembali ke proyekmu dan melihat "GitHub terhubung — sekarang kamu bisa kirim proyek ini ke GitHub."
Buat repositorinya
Klik ikon GitHub lagi dan pilih Buat repo privat. Kamu perlu setidaknya satu pembuatan yang sudah selesai. Sebelum itu, tombolnya bertuliskan Buat dulu. Kalau sudah selesai, kamu akan melihat "Terkirim ke GitHub" dengan nama repositori dan tombol Buka.
Kamu juga bisa klik Cadangkan ke GitHub di Kelola → Ringkasan (di bawah Penyiapan sekali klik, setelah backend aplikasimu siap). Fungsinya sama: membuat repositori saat pertama kali, lalu memperbaruinya setelah itu. Hubungkan GitHub dulu lewat ikon GitHub.
Kirim versi yang lebih baru
Klik ikon GitHub untuk membuka menunya:
- Push versi terbaru mengirim versi terbarumu. Menu menampilkan Ada perubahan baru kalau ada yang perlu dikirim, atau Sudah terbaru.
- Buka repo membuka repositori di GitHub.
- Putuskan GitHub menghapus akses Buildliy (lihat di bawah).
Setelah push, kamu akan melihat salah satu dari ini:
- "Versi terbaru kamu sudah dikirim ke…": repositori sekarang sama dengan aplikasimu.
- "…sudah punya versi terbaru kamu.": tidak ada yang baru untuk dikirim.
- "Pull request dibuka di GitHub": repositori punya perubahan yang dibuat di GitHub, jadi pembaruanmu masuk ke pull request. Klik Tinjau, lalu gabungkan di GitHub agar repositori jadi terbaru.
Isi repositori
- Semua file aplikasimu, termasuk gambar-gambarnya, dengan perbaikan keamanan kecil yang sama seperti yang dilakukan Buildliy saat kamu menerbitkan (misalnya, alat bantu pengeditan pratinjau milik builder tidak disertakan).
- README berisi nama dan deskripsi aplikasimu, alamat live-nya kalau sudah diterbitkan, cara menjalankannya di komputer (Node.js 20 atau lebih baru, lalu
npm installdannpm run dev), pengaturan yang dibutuhkan, dan tautan kembali ke proyek Buildliy kamu. - File
.env.example, kalau aplikasimu membaca pengaturan (environment variables), berisi daftar namanya beserta catatan. File ini tidak pernah berisi nilainya.
Beberapa hal tidak pernah masuk ke repositori:
- Rahasia. Buildliy tidak akan mem-push kode yang berisi sesuatu yang tampak seperti kunci rahasia. Kalau menemukannya, Buildliy memberi tahu kamu di file mana dan memintamu memindahkan kunci itu ke Kelola → Rahasia (atau minta AI melakukannya) sebelum mencoba lagi. Kunci yang disimpan sebagai rahasia atau konektor tetap ada di Buildliy. Lihat Rahasia dan kunci API.
- Data aplikasimu. Tabel dan semua isinya tetap ada di database aplikasimu. Kalau diarahkan ke database baru, kodenya mulai dalam keadaan kosong.
- Kunci Buildliy pribadi milik aplikasimu. Fitur bawaan seperti AI di aplikasimu dan pembayaran memakainya. Kunci ini diatur otomatis saat aplikasimu berjalan di Buildliy. Kalau kodenya dijalankan di tempat lain, fitur-fitur itu tidak akan berfungsi tanpanya.
Kalau Buildliy tidak bisa memperbarui repositorimu
Kalau repositori dihapus atau diarsipkan, milik akun GitHub lain dari yang kamu hubungkan, atau akunmu tidak diizinkan untuk push ke sana, Buildliy menampilkan … tidak bisa diperbarui beserta nama repositori dan alasannya. Pilih Buat repo baru untuk mengirim versi terbarumu ke repositori privat yang baru. Repositori lama tidak diubah atau dihapus.
Bekerja bersama developer
Beri mereka akses di GitHub
Undang developer ke repositori lewat pengaturan GitHub sendiri. Repositorimu privat, jadi hanya orang yang kamu undang yang bisa melihatnya.
Minta mereka mengikuti README
README menjelaskan cara menjalankan aplikasi di komputer sendiri dan pengaturan mana yang perlu diisi. Mereka menyalin
.env.exampleke.env.locallalu menambahkan nilai mereka sendiri.Sepakati di mana perubahan dilakukan
Buildliy tidak menarik perubahan dari GitHub kembali ke proyekmu. Kalau kamu terus membuat di Buildliy sementara developer mengedit di GitHub, setiap push darimu akan datang sebagai pull request yang bisa mereka gabungkan bersama pekerjaan mereka.
Tidak mau pakai GitHub? Kamu bisa mengunduh seluruh basis kode sebagai ZIP dari tab Kode. Lihat Lihat dan unduh kode.
Di ruang kerja bersama, hanya pemilik ruang kerja yang bisa mengirim proyek ke GitHub, karena kodenya masuk ke akun GitHub mereka. Anggota tim bisa membuka repositori yang sudah tertaut lewat ikon GitHub, tetapi GitHub hanya menampilkannya kepada orang yang sudah diberi akses oleh pemilik di GitHub.
Putuskan GitHub
Klik ikon GitHub, pilih Putuskan GitHub, lalu konfirmasi. Buildliy tidak lagi punya akses ke akun GitHub kamu untuk semua proyek, dan akses yang tadinya dimiliki dicabut. Repositori dan kodenya tetap ada di GitHub, dan setiap proyek tetap tertaut ke repositorinya. Sampai kamu menghubungkan lagi, menu GitHub pada proyek yang tertaut menampilkan Hubungkan GitHub untuk push. Kamu bisa menghubungkan lagi kapan saja, termasuk dengan akun GitHub yang berbeda.
Terkait
Masih bingung? Baca FAQ atau hubungi kami.