Simpan kode situs Anda di GitHub
Sinkronisasi GitHub menyimpan kode milik situs Anda di repositori GitHub, tersinkron dua arah. Setiap versi yang tayang menjadi commit di sana, dan push ke branch yang terhubung akan diperiksa, di-build, dan dipublikasikan di situs Anda.
Apa yang dikirim ke GitHub
Hanya file milik situs Anda sendiri: file yang ditampilkan File Explorer dan yang ada di dalam unduhannya. Bagian bersama yang menjadi dasar setiap situs Briks, pengaturan situs, kunci Anda, dan data di database Anda tidak pernah masuk ke sana. Jadi repositori ini tidak dapat dibangun atau dijalankan sendiri: Briks yang membangun dan memublikasikan apa yang Anda push.
| Folder | Isinya |
|---|---|
app/ | Halaman-halaman situs. |
components/custom/ | Bagian-bagian yang ditulis untuk situs Anda. |
content/ | Kata-kata dan fakta situs. |
api/ | Kode server milik situs itu sendiri, jika ada. |
db/schema.ts dan db/data/ | Bentuk data situs dan data yang menjadi isi awalnya. |
public/ | Gambar dan file milik situs itu sendiri. |
Jika repositori tidak memiliki README, Briks menambahkannya dengan penjelasan tentang folder-folder ini dan cara kerja sinkronisasi.
Hubungkan repositori
Tekan Connect GitHub
Di mana: Settings, GitHub
GitHub terbuka. Jika aplikasi Briks belum ada di akun atau organisasi GitHub Anda, GitHub menanyakan di mana akan dipasang dan repositori mana yang boleh dipakai, lalu mengembalikan Anda ke sini.
Pilih repositori dan branch
Di mana: Settings, GitHub
Pilih akunnya, lalu repositorinya. Branch dimulai dari branch bawaan repositori; sebutkan branch lain jika mau, dan branch yang belum ada akan dibuat dari branch bawaan. Create a repository on GitHub membuka GitHub untuk membuat repositori privat dengan nama situs Anda. Repository not listed? Give Briks access to it membuka pengaturan aplikasi di GitHub.
Tekan Connect
Di mana: Settings, GitHub
Branch kosong langsung terhubung. Jika branch sudah berisi file, Briks lebih dulu menampilkan jumlahnya, mana saja yang berada di folder situs Anda, dan apa yang dilakukan commit pertamanya terhadap file tersebut. Tekan Connect and commit this site untuk melanjutkan, atau Choose another.
Dalam beberapa menit, commit pertama membawa versi live Anda. Commit itu mengganti file di folder situs Anda dengan file milik situs dan menghapus file yang tidak dimiliki situs. Selebihnya di repositori tetap seperti semula. Tidak ada riwayat yang hilang, karena Briks tidak pernah melakukan force-push.
Dari Briks ke GitHub
- Setiap versi yang tayang dan mengubah file situs Anda menjadi satu commit di branch, apa pun cara pembuatannya: build, perubahan, penyimpanan di File Explorer atau Visual Editor, atau pemulihan. Selama uji A/B berjalan, versi-versinya menunggu hingga uji selesai.
- Pesan commit adalah ringkasan yang Anda baca di studio, lengkap dengan nomor versi dan nama orang yang memintanya.
- GitHub menampilkan status setiap commit, seperti Live as version 15.
- Jika sebuah file berisi sesuatu yang berbentuk seperti kunci atau menyebut salah satu layanan milik Briks, tidak ada yang dikirim, dan Anda diberi tahu file mana yang bermasalah. Kunci sebaiknya disimpan di Secrets.
Dari GitHub ke Briks
Push ke branch yang terhubung dipublikasikan di situs Anda, tanpa AI dan tanpa kredit. Pertama, push itu melewati pemeriksaan keamanan yang sama seperti penyimpanan di File Explorer: skrip, frame, atau formulir yang menjangkau website lain ditolak kecuali Anda sudah menambahkan website itu di Settings, Preferences, Allowed websites. Lalu Briks membangunnya, dan dalam satu atau dua menit status commit menampilkan Live as version 16, atau alasan mengapa tidak dipublikasikan.
| Apa yang diubah oleh sebuah push | Apa yang terjadi |
|---|---|
File di app/, components/custom/, content/, api/, db/schema.ts, db/data/ atau public/ | Dipublikasikan di situs. |
README, lisensi, dan berkas lain di root repositori, serta .github/ | Disimpan di GitHub. Tidak pernah menjadi bagian dari situs. |
db/migrations/ | Ditolak. Briks menulis perubahan data dari db/schema.ts, jadi ubahlah skemanya. |
| Gambar dan berkas lain yang bukan teks | Ditolak. Tambahkan melalui Pustaka media. Menghapus salah satunya tidak masalah. |
Hal lain apa pun, seperti file konfigurasi, file .env, atau file yang berbentuk seperti kunci | Ditolak, dengan alasan tertera pada commit. Tidak ada bagian push yang dipublikasikan. |
- Satu push dapat mengubah hingga 300 file, masing-masing hingga 256 KB dan total 8 MB.
- Hingga 20 push per jam dan 100 per hari dipublikasikan untuk setiap situs. Push yang melewati batas akan menunggu, dan statusnya di GitHub menyebutkan kapan akan dipublikasikan. Push yang masuk selama ada yang menunggu dipublikasikan bersama-sama.
- Selama uji A/B berjalan, push menunggu hingga uji selesai.
Saat kedua sisi mengubah file yang sama
Push yang masuk saat Briks sedang memublikasikan akan menunggu gilirannya. Jika push dan Briks mengubah file yang berbeda, keduanya dipertahankan. Jika keduanya mengubah file yang sama dengan cara berbeda, tidak ada bagian push yang dipublikasikan: Briks menaruh versinya sendiri di branch bernama briks-sync, dan status push menyebutkan file tersebut. Gabungkan briks-sync di GitHub lalu push lagi, atau selesaikan di Settings, GitHub:
- Use GitHub's version memublikasikan seluruh push, termasuk berkas yang diubah di kedua sisi.
- Keep Briks's version memublikasikan push tanpa file yang diubah oleh kedua pihak.
Jika riwayat branch ditulis ulang, misalnya lewat force-push, sinkronisasi berhenti sampai Anda memilih salah satu dari dua tombol yang sama.
Yang diberitahukan kepada Anda
Sinkronisasi yang berhasil berjalan tenang, selain pesan bahwa sebuah push sudah tayang. Push yang tidak dipublikasikan, push yang menunggu merge, dan koneksi yang terhenti muncul di lonceng, serta di chat Telegram dan Discord yang mengaktifkan peringatan Builds finished or failed. Settings, GitHub menampilkan 20 sinkronisasi terakhir ke kedua arah, masing-masing dengan commit, file, dan hasilnya.
Putuskan
- Disconnect di Settings, GitHub menghentikan kedua arah. Repositori dan riwayatnya tetap persis seperti semula.
- Memindahkan proyek ke ruang kerja lain akan memutuskan koneksinya.
- Jika aplikasi dicopot di GitHub, atau repositori dikeluarkan dari aksesnya, sinkronisasi berhenti dan Anda diberi tahu.
- Menghapus proyek tidak pernah menyentuh repositori.
Bisakah saya memulai proyek dari repositori yang sudah saya miliki?
Belum. Mengimpor repositori yang sudah ada belum tersedia. Bangun situs di Briks, lalu hubungkan sebuah repositori ke situs tersebut.
Bisakah saya menjalankan repositori di komputer sendiri?
Tidak. Repositori ini berisi file milik situs Anda, bukan bagian bersama yang dijalankan setiap situs Briks, jadi tidak bisa dibangun sendiri. Push perubahan Anda, lalu Briks membangun dan memublikasikannya.
Apa yang bisa dilakukan Briks di akun GitHub saya?
Hanya yang diminta aplikasi saat Anda memasangnya: membaca dan menulis file repositori yang Anda berikan, serta menetapkan status commit. Aplikasi hanya menulis ke branch yang Anda hubungkan dan, jika kedua sisi mengubah sebuah file, ke branch briks-sync.
Apakah Briks membaca pesan commit saya?
Tidak. Log sinkronisasi menampilkan commit setiap push, file-filenya, dan siapa yang melakukan push, tetapi tidak pernah pesannya.