เก็บโค้ดเว็บไซต์ของคุณไว้ใน GitHub
GitHub sync เก็บโค้ดของเว็บไซต์คุณไว้ในที่เก็บ GitHub และซิงก์ตรงกันทั้งสองทาง ทุกเวอร์ชันที่เผยแพร่จะกลายเป็นคอมมิตในที่เก็บนั้น และเมื่อพุชไปยังบรานช์ที่เชื่อมต่อไว้ ระบบจะตรวจสอบ สร้าง และเผยแพร่บนเว็บไซต์ของคุณ
สิ่งที่ส่งไปที่ GitHub
เฉพาะไฟล์ของเว็บไซต์คุณเอง คือไฟล์ที่ ตัวสำรวจไฟล์ แสดงและที่ไฟล์ดาวน์โหลดมี ส่วนที่ใช้ร่วมกันซึ่งเว็บไซต์ Briks ทุกแห่งทำงานอยู่บน การตั้งค่าของเว็บไซต์ คีย์ของคุณ และข้อมูลในฐานข้อมูลของคุณจะไม่ถูกส่งไปที่นั่น ดังนั้นที่เก็บโค้ดจึงสร้างหรือรันเองไม่ได้ Briks เป็นผู้สร้างและเผยแพร่สิ่งที่คุณพุช
| โฟลเดอร์ | มีอะไรอยู่ข้างใน |
|---|---|
app/ | หน้าต่างๆ ของเว็บไซต์ |
components/custom/ | ส่วนต่างๆ ที่เขียนให้เว็บไซต์ของคุณ |
content/ | ข้อความและข้อเท็จจริงของเว็บไซต์ |
api/ | โค้ดเซิร์ฟเวอร์ของเว็บไซต์เอง หากมี |
db/schema.ts และ db/data/ | โครงสร้างข้อมูลของเว็บไซต์และข้อมูลที่ใส่ไว้ตั้งแต่เริ่มต้น |
public/ | รูปภาพและไฟล์ของเว็บไซต์ |
หากรีโพสิทอรีไม่มี README Briks จะเพิ่มให้ โดยอธิบายโฟลเดอร์เหล่านี้และวิธีการซิงก์
เชื่อมต่อรีโพซิทอรี
กด Connect GitHub
ที่ไหน: Settings, GitHub
GitHub จะเปิดขึ้น หากแอป Briks ยังไม่ได้ติดตั้งในบัญชีหรือองค์กร GitHub ของคุณ GitHub จะถามว่าจะติดตั้งที่ไหนและให้ใช้รีโพซิทอรีใดได้บ้าง แล้วพาคุณกลับมา
เลือกรีโพซิทอรีและบรานช์
ที่ไหน: Settings, GitHub
เลือกบัญชี แล้วเลือกรีโพซิทอรี บรานช์จะเริ่มต้นเป็นบรานช์เริ่มต้นของรีโพซิทอรี คุณระบุชื่ออื่นได้ และบรานช์ที่ยังไม่มีจะถูกสร้างจากบรานช์เริ่มต้น Create a repository on GitHub จะเปิด GitHub เพื่อสร้างรีโพซิทอรีส่วนตัวที่ตั้งชื่อตามเว็บไซต์ของคุณ Repository not listed? Give Briks access to it จะเปิดหน้าตั้งค่าของแอปบน GitHub
กด Connect
ที่ไหน: Settings, GitHub
บรานช์ที่ว่างเปล่าจะเชื่อมต่อทันที หากบรานช์มีไฟล์อยู่แล้ว Briks จะแสดงก่อนว่ามีกี่ไฟล์ ไฟล์ใดอยู่ในโฟลเดอร์ของเว็บไซต์คุณ และคอมมิตแรกจะทำอะไรกับไฟล์เหล่านั้น กด Connect and commit this site เพื่อดำเนินการต่อ หรือ Choose another
ภายในไม่กี่นาที คอมมิตแรกจะนำเวอร์ชันที่ใช้งานอยู่ของคุณเข้ามา โดยจะแทนที่ไฟล์ในโฟลเดอร์ของเว็บไซต์ด้วยไฟล์ของเว็บไซต์ และลบไฟล์ที่เว็บไซต์ไม่มี ส่วนอื่นทั้งหมดในรีโพซิทอรีจะคงไว้ตามเดิม ประวัติจะไม่สูญหาย เพราะ Briks ไม่เคย force-push
จาก Briks ไป GitHub
- ทุกเวอร์ชันที่เผยแพร่และเปลี่ยนไฟล์ของเว็บไซต์คุณจะกลายเป็นหนึ่งคอมมิตบนบรานช์ ไม่ว่าจะเกิดจากอะไร ทั้งการบิลด์ การเปลี่ยนแปลง การบันทึกใน File Explorer หรือ Visual Editor หรือการกู้คืน ระหว่างที่การทดสอบ A/B กำลังทำงาน เวอร์ชันของการทดสอบจะรอจนกว่าการทดสอบจะสิ้นสุด
- ข้อความของคอมมิตคือสรุปที่คุณอ่านในสตูดิโอ พร้อมหมายเลขเวอร์ชันและชื่อของผู้ที่ขอการเปลี่ยนแปลงนั้น
- GitHub แสดงสถานะของแต่ละคอมมิต เช่น Live as version 15
- หากไฟล์มีสิ่งที่มีรูปแบบเหมือนคีย์ หรือระบุชื่อบริการของ Briks เอง จะไม่มีการส่งอะไรออกไป และคุณจะได้รับแจ้งว่าเป็นไฟล์ใด คีย์ควรเก็บไว้ใน Secrets
จาก GitHub ไปยัง Briks
การพุชไปยังสาขาที่เชื่อมไว้จะถูกเผยแพร่บนเว็บไซต์ของคุณ โดยไม่ใช้ AI และไม่เสียเครดิต ก่อนอื่นต้องผ่านการตรวจความปลอดภัยเดียวกับการบันทึกใน File Explorer: สคริปต์ เฟรม หรือฟอร์มที่จะไปถึงเว็บไซต์อื่นจะถูกปฏิเสธ เว้นแต่คุณเพิ่มเว็บไซต์นั้นไว้ที่ Settings, Preferences, Allowed websites จากนั้น Briks จะสร้างเว็บไซต์ และภายในหนึ่งถึงสองนาที สถานะของคอมมิตจะขึ้นว่า Live as version 16 หรือบอกเหตุผลที่ไม่ได้เผยแพร่
| สิ่งที่การพุชเปลี่ยนแปลง | สิ่งที่จะเกิดขึ้น |
|---|---|
ไฟล์ใน app/, components/custom/, content/, api/, db/schema.ts, db/data/ หรือ public/ | เผยแพร่บนเว็บไซต์แล้ว |
ไฟล์ README, ไลเซนส์ และไฟล์อื่นที่รากของรีโพซิทอรี รวมถึง .github/ | เก็บไว้บน GitHub และไม่เป็นส่วนหนึ่งของเว็บไซต์ |
db/migrations/ | ถูกปฏิเสธ Briks เขียนการเปลี่ยนแปลงของข้อมูลจาก db/schema.ts ดังนั้นให้เปลี่ยนสคีมาแทน |
| รูปภาพและไฟล์อื่นที่ไม่ใช่ข้อความ | ไม่อนุญาต ให้เพิ่มผ่านคลังสื่อ ส่วนการลบทำได้ |
อย่างอื่นทั้งหมด เช่น ไฟล์การตั้งค่า ไฟล์ .env หรือไฟล์ที่มีรูปแบบเหมือนคีย์ | ถูกปฏิเสธ พร้อมเหตุผลที่คอมมิต และจะไม่มีส่วนใดของการพุชถูกเผยแพร่ |
- การพุชหนึ่งครั้งเปลี่ยนได้สูงสุด 300 ไฟล์ ไฟล์ละไม่เกิน 256 KB และรวมกันไม่เกิน 8 MB
- เผยแพร่การพุชได้สูงสุด 20 ครั้งต่อชั่วโมงและ 100 ครั้งต่อวันสำหรับแต่ละเว็บไซต์ การพุชที่เกินขีดจำกัดจะรอ และสถานะบน GitHub จะบอกว่าจะเผยแพร่เมื่อใด การพุชที่เข้ามาระหว่างที่มีรายการรออยู่จะถูกเผยแพร่พร้อมกัน
- ขณะที่การทดสอบ A/B กำลังทำงาน การ push จะรอจนกว่าการทดสอบจะสิ้นสุด
เมื่อทั้งสองฝั่งแก้ไขไฟล์เดียวกัน
การพุชที่เข้ามาขณะที่ Briks กำลังเผยแพร่จะรอตามลำดับ หากการพุชและ Briks แก้ไขคนละไฟล์ ระบบจะเก็บไว้ทั้งสองส่วน หากแก้ไขไฟล์เดียวกันต่างกัน จะไม่มีส่วนใดของการพุชถูกเผยแพร่ แต่ Briks จะนำเวอร์ชันของตัวเองไปไว้ที่บรานช์ชื่อ briks-sync และสถานะของการพุชจะระบุชื่อไฟล์นั้น ให้เมิร์จ briks-sync บน GitHub แล้วพุชอีกครั้ง หรือจัดการใน Settings, GitHub:
- Use GitHub's version เผยแพร่การพุชทั้งหมด รวมถึงไฟล์ที่ถูกแก้ไขทั้งสองฝั่งด้วย
- Keep Briks's version เผยแพร่การ push โดยไม่รวมไฟล์ที่ทั้งสองฝั่งเปลี่ยน
หากประวัติของบรานช์ถูกเขียนทับ เช่นจากการ force-push การซิงก์จะหยุดชั่วคราวจนกว่าคุณจะเลือกหนึ่งในสองปุ่มเดิม
สิ่งที่คุณจะได้รับแจ้ง
การซิงก์ที่สำเร็จจะเงียบ ยกเว้นข้อความว่าการพุชขึ้นใช้งานแล้ว การพุชที่ไม่ได้เผยแพร่ การพุชที่รอการเมิร์จ และการเชื่อมต่อที่หยุดลง จะแสดงในกระดิ่งแจ้งเตือน และในแชต Telegram และ Discord ที่เปิดการแจ้งเตือน Builds finished or failed ไว้ Settings, GitHub แสดงการซิงก์ 20 ครั้งล่าสุดทั้งสองทิศทาง พร้อมคอมมิต ไฟล์ และผลลัพธ์ของแต่ละครั้ง
ยกเลิกการเชื่อมต่อ
- Disconnect ใน Settings, GitHub จะหยุดการซิงก์ทั้งสองทิศทาง รีโพซิทอรีและประวัติของมันจะอยู่ตามเดิมทุกอย่าง
- การย้ายโปรเจกต์ไปยังเวิร์กสเปซอื่นจะตัดการเชื่อมต่อ
- หากถอนการติดตั้งแอปบน GitHub หรือรีโพซิทอรีถูกนำออกจากสิทธิ์ของแอป การซิงก์จะหยุดและคุณจะได้รับแจ้ง
- การลบโปรเจกต์จะไม่แตะต้องรีโพซิทอรีเลย
เริ่มโปรเจกต์จากรีโพซิทอรีที่มีอยู่แล้วได้หรือไม่
ยังไม่ได้ ยังไม่รองรับการนำเข้ารีโพซิทอรีที่มีอยู่ ให้สร้างเว็บไซต์ใน Briks ก่อน แล้วค่อยเชื่อมต่อรีโพซิทอรีเข้ากับเว็บไซต์
ฉันรันรีโพซิทอรีบนคอมพิวเตอร์ของตัวเองได้หรือไม่
ไม่ได้ รีโพซิทอรีเก็บเฉพาะไฟล์ของเว็บไซต์คุณ ไม่รวมส่วนที่ใช้ร่วมกันซึ่งเว็บไซต์ Briks ทุกแห่งใช้รัน จึงบิลด์ด้วยตัวเองไม่ได้ ให้พุชการเปลี่ยนแปลงของคุณ แล้ว Briks จะบิลด์และเผยแพร่ให้
Briks ทำอะไรได้บ้างในบัญชี GitHub ของฉัน
เฉพาะสิ่งที่แอปขอตอนติดตั้งเท่านั้น คือ อ่านและเขียนไฟล์ของรีโพซิทอรีที่คุณให้สิทธิ์ และตั้งสถานะของคอมมิต แอปจะเขียนเฉพาะบรานช์ที่คุณเชื่อมต่อไว้ และเมื่อทั้งสองฝั่งแก้ไขไฟล์เดียวกัน จะเขียนไปที่บรานช์ briks-sync
Briks อ่านข้อความคอมมิตของฉันหรือไม่
ไม่ บันทึกการซิงก์แสดงคอมมิตของแต่ละการพุช ไฟล์ และผู้ที่พุช แต่ไม่แสดงข้อความ