GitHub에 사이트 코드 보관하기

#GitHub로 가는 내용

사이트 자체 파일만 올라가요. 파일 탐색기에 보이고 다운로드에 담기는 파일이에요. 모든 Briks 사이트가 실행되는 데 쓰는 공유 부분, 사이트 설정, 키, 데이터베이스 레코드는 절대 올라가지 않아요. 그래서 저장소는 단독으로 빌드되거나 실행되지 않고, 푸시한 내용을 Briks가 빌드하고 게시해요.

저장소에 README가 없으면 Briks가 이 폴더들과 동기화 방식을 설명하는 README를 추가해요.

#저장소 연결하기

몇 분 안에 첫 커밋이 라이브 버전을 가져와요. 사이트 폴더의 파일은 사이트 자체의 파일로 바뀌고, 사이트에 없는 파일은 삭제돼요. 저장소의 나머지는 그대로예요. Briks는 강제 푸시를 하지 않으므로 기록에서 사라지는 것은 없어요.

#Briks에서 GitHub로

• 게시되면서 사이트의 파일을 바꾸는 각 버전은 만든 방법과 상관없이 브랜치에 커밋 하나가 돼요. 빌드, 변경, File Explorer나 Visual Editor에서의 저장, 복원 모두 해당돼요. A/B 테스트가 진행되는 동안에는 그 버전들이 테스트가 끝날 때까지 기다려요.
• 커밋 메시지는 스튜디오에서 보는 요약이고, 버전 번호와 요청한 사람의 이름이 함께 들어가요.
• GitHub에는 Live as version 15처럼 각 커밋의 상태가 표시돼요.
• 파일에 키처럼 생긴 것이 있거나 Briks 자체 서비스의 이름이 들어 있으면 아무것도 전송되지 않고, 어떤 파일인지 알려 드려요. 키는 시크릿에 두세요.

#GitHub에서 Briks로

연결된 브랜치에 푸시하면 AI나 크레딧 없이 사이트에 게시돼요. 먼저 File Explorer에서 저장할 때와 같은 안전 점검을 거쳐요. 다른 웹사이트에 접근하는 스크립트, 프레임, 폼은 Settings, Preferences, Allowed websites에 그 웹사이트를 추가하지 않았다면 거부돼요. 그다음 Briks가 빌드하고, 1~2분 안에 커밋 상태에 Live as version 16이 표시돼요. 게시되지 않았다면 그 이유가 표시돼요.

• 푸시 한 번으로 최대 300개 파일을 바꿀 수 있고, 파일당 256 KB, 전체 8 MB까지예요.
• 사이트마다 한 시간에 최대 20번, 하루에 최대 100번의 푸시가 게시돼요. 한도를 넘은 푸시는 기다리고, GitHub의 상태에 게시될 시각이 표시돼요. 기다리는 동안 들어온 푸시는 함께 게시돼요.
• A/B 테스트가 진행되는 동안에는 푸시가 테스트가 끝날 때까지 기다려요.

#양쪽에서 같은 파일을 바꿨을 때

Briks가 게시하는 중에 들어온 푸시는 차례를 기다려요. 푸시와 Briks가 서로 다른 파일을 바꿨다면 둘 다 유지돼요. 같은 파일을 서로 다르게 바꿨다면 푸시의 내용은 하나도 게시되지 않아요. Briks는 자기 버전을 briks-sync라는 브랜치에 두고, 푸시의 상태에 해당 파일을 알려 줘요. GitHub에서 briks-sync를 병합한 뒤 다시 푸시하거나, Settings의 GitHub에서 해결하세요:

• Use GitHub's version은 양쪽에서 모두 바뀐 파일을 포함해 푸시 전체를 게시해요.
• Keep Briks's version은 양쪽이 모두 바꾼 파일을 빼고 푸시를 게시해요.

강제 푸시 등으로 브랜치의 기록이 다시 쓰이면, 같은 두 버튼 중 하나를 고를 때까지 동기화가 멈춰요.

#알려 주는 내용

잘 되는 동기화는 조용해요. 푸시가 게시되었다는 메시지만 나와요. 게시되지 않은 푸시, 병합을 기다리는 푸시, 멈춘 연결은 알림 벨에 표시되고, Builds finished or failed 알림이 켜진 Telegram과 Discord 채팅에도 표시돼요. Settings, GitHub에서는 양방향으로 최근 20번의 동기화를 볼 수 있고, 각각 커밋, 파일, 결과가 함께 나와요.

#연결 해제

• Settings, GitHub에서 Disconnect를 누르면 양방향 동기화가 모두 멈춰요. 저장소와 그 기록은 그대로 남아요.
• 프로젝트를 다른 워크스페이스로 옮기면 연결이 해제돼요.
• GitHub에서 앱을 삭제하거나 저장소가 앱의 접근 범위에서 빠지면 동기화가 멈추고 알림이 와요.
• 프로젝트를 삭제해도 저장소는 전혀 건드리지 않아요.