배포 훅과 게시된 버전
사이트를 게시할 때마다 번호가 매겨진 버전으로 보관되고, 프로젝트 Settings의 Versions 섹션에 목록으로 나와요. 같은 Settings의 Deploy hooks를 쓰면 다른 도구가 Briks에 사이트를 다시 게시해 달라고 요청할 수 있어요. 이 페이지에서는 둘 다 다뤄요.
게시된 버전 목록
이 섹션에는 최신 버전 100개가 최신순으로 나와요. 각 행에는 다음이 표시돼요:
- Version과 그 번호, 그리고 지금 방문자가 보는 버전에는 초록색 Live 태그가 붙어요.
- 만들어진 과정: Built, Changed, Checked and repaired, Published again 중 하나이고, 누가 요청했는지도 보여줘요.
- 게시된 날짜와 시각이에요. 예: 2026년 10월 8일 14:32.
- 짧은 요약이에요. 변경의 경우 요청한 말 그대로이고, 새로 만들거나 처음 게시할 때는 Briks가 한 일이에요.
- 버전이 일주일 동안 게시된 뒤에는, 도움이 됐는지 알려 주는 한 줄이 붙어요(아래 참고).
| 라벨 | 버전을 만든 주체 |
|---|---|
| Built | 첫 빌드, 또는 템플릿이나 다른 프로젝트에서 복사한 새 프로젝트 |
| Changed | 요청한 변경, File Explorer에서 저장한 코드, 또는 미디어 라이브러리에서 바꾼 사진 |
| Checked and repaired | 발견한 문제를 고친 사이트 점검 |
| Published again | 프로덕션으로 옮기거나 미리보기로 되돌리기, Apply to the live site, 새 주소, 도메인 연결 완료, 배포 훅이 여기에 해당해요. 요약에 어떤 일인지 나와요. 예: “사이트 설정으로 다시 게시했어요.” |
아무것도 게시하지 않은 작업까지 포함해 프로젝트의 모든 작업은 로그에서 볼 수 있어요.
변경이 도움이 됐나요?
버전이 7일 동안 게시되면, 그 버전의 행에 한 줄이 추가돼요. 그 버전이 바꾼 페이지의 방문을 이전과 이후로 비교하는 줄이고, 각각 앞뒤로 최대 14일에 걸친 주 평균이에요. 예를 들면 “버전 12(가격 섹션 추가) 이후, /prices의 문의가 비슷한 방문 수에서 주당 3건에서 5건이 됐어요.”처럼 보여요. 해당 페이지의 방문자가 주 25명 미만이면 판단하기에는 방문이 너무 적다고 알려요. 에이전트가 한 변경은 그 에이전트가 한 것으로 표시돼요. 이 줄은 AI 없이 내 분석 데이터로 계산하고 비용은 들지 않아요. 다시 게시만 한 버전과 첫 빌드에는 줄이 붙지 않아요. 최신 12개 버전을 읽고, 14일이 지나면 결과가 확정돼요.
버전 복원
버전 찾기
위치: Settings, Versions
프로젝트를 편집할 수 있는 역할이라면, 현재 라이브인 행을 뺀 모든 행에 Restore 버튼이 있어요.
복원하기
위치: Restore version
Restore를 누르세요. 대화상자에 “게시되었던 모습 그대로 라이브 사이트로 돌아가요. 이후 버전은 그대로 저장되어 있어서 다시 돌아올 수 있어요.”라고 나와요. Restore version과 번호를 누르세요.
게시되는 모습 보기
위치: Studio
게시하는 동안 Briks가 스튜디오로 안내해요. 메시지는 예를 들어 “버전 12가 게시되었던 그대로 다시 라이브가 되었어요.”처럼 나와요. Live 태그가 그 행으로 옮겨 가요.
복원에는 AI가 쓰이지 않아요. Owner, Admin, Editor는 복원할 수 있고, Viewer는 목록을 볼 수 있어요. A/B 테스트가 진행되는 동안에는 복원할 수 없어요. 버전, 실행 취소, 다시 실행에서 스튜디오 안에서 같은 기록을 다루는 방법을 볼 수 있어요.
배포 훅이란
배포 훅은 무언가 호출할 때마다 사이트를 다시 게시하는 비공개 웹 주소예요. (배포는 게시한다는 뜻이에요.) 이 주소를 예약 서비스 같은 다른 도구에 주면, 그 도구가 새로 게시하고 싶을 때 호출해요.
호출하면 라이브 버전이 자체 파일로 다시 게시되고, 프로젝트 설정은 현재 상태 그대로 적용돼요. AI는 실행되지 않고, 요금도 없고, 직접 바꾸지 않은 것은 달라지지 않아요. 사이트 페이지는 방문할 때마다가 아니라 게시할 때 만들어지므로, 새로 게시하면 다음이 반영돼요:
- 사이트 데이터베이스에서 가져온 최신 게시 레코드, 이 레코드로 만든 모든 페이지에 적용돼요.
- 마지막으로 게시한 뒤 바꾼 설정(로고, 파비콘, 검색 설정 등);
- 페이지가 조립되는 순간 스스로 계산하는 모든 것.
설명한 변경을 하거나, 이를 호출하는 도구의 데이터를 읽거나, 출시 점검을 실행하지는 않아요.
디플로이 훅 만들기
Deploy hooks 열기
위치: Settings, Deploy hooks
프로젝트를 열고 Settings 탭을 클릭한 다음, Developer 그룹의 Deploy hooks를 클릭하세요.
하나 추가
위치: Add a deploy hook
Add deploy hook을 누르세요. 호출하는 대상의 이름으로 지어 주세요. 예를 들면
Nightly scheduler예요. 그런 다음 Make hook을 누르세요.주소 복사
위치: Your deploy hook
Briks는 주소를 한 번만 보여드려요. Copy를 눌러 이 주소를 호출할 도구에 바로 붙여넣으세요. Briks는 읽을 수 있는 사본을 보관하지 않아서 나중에 다시 볼 수 없어요.
마치기
위치: Your deploy hook
Done을 누르세요. 훅이 만든 날짜와 "never called"와 함께 목록에 추가돼요.
훅은 프로젝트를 게시한 뒤부터 작동해요. 그 전에는 해당 섹션에 안내가 나와요. Owner, Admin, Editor가 훅을 만들고 삭제할 수 있어요.
훅 호출하기
도구가 이 주소로 POST 요청을 보내야 해요. POST 요청은 페이지를 읽기만 하는 게 아니라 무언가를 실행하라고 요청하는 웹 요청이에요. 대부분의 자동화 도구와 예약 도구에 이 설정이 있어요. 대화상자에는 터미널에서 보내는 호출의 모양이 나와요: curl -X POST https://app.briks.dev/api/hooks/bdh_…, 줄여 쓴 주소 자리에는 전체 주소가 들어가요.
| 전화가 왔을 때 | 어떻게 진행되나요 |
|---|---|
| Briks가 내 비즈니스와 비슷한 곳에서 보통 갖추는 페이지를 제안해요. 홈이 가장 먼저 나와요. 원하는 페이지에 체크하고 직접 추가해도 되고, 모두 합쳐 최대 열 페이지까지 만들 수 있어요. | 게시는 다른 작업과 똑같이 스튜디오에서 시작되고 표시돼요. |
| 빌드나 게시가 이미 진행 중이에요 | 호출은 접수되어 기존 호출과 합쳐지기 때문에, 호출이 몰려도 게시는 한 번만 돼요. |
| 훅이 지난 한 시간 동안 여섯 번 호출됐어요 | 거부됨: “이 훅은 지난 한 시간 동안 여섯 번 호출됐어요. 나중에 다시 시도해 주세요.” |
| 이 프로젝트는 한 번도 게시된 적이 없어요 | 거부됨: “The project has not been published yet.” |
| A/B 테스트가 진행 중이에요 | 거부됨: “이 사이트에서 A/B 테스트가 진행 중이에요. 먼저 한 버전을 유지하는 방식으로 끝내 주세요.” |
| 훅을 만든 사람도, 프로젝트를 만든 사람도 더 이상 Briks 계정이 없어요 | 거부됨: “이 훅에는 소유자가 남아 있지 않아요. 프로젝트의 Deploy hooks에서 새로 만드세요.” |
| 훅이 삭제되었어요 | 이 주소는 더 이상 작동하지 않아요. |
호출할 때마다 훅 행의 “마지막 호출” 시간이 갱신돼서 도구가 잘 작동하는지 확인할 수 있어요.
실제 예시
Northside Running Club의 사이트는 데이터베이스의 기록에서 앞으로 열릴 경기를 불러와 보여 줘요. 운영 담당자는 스튜디오에서 경기 페이지가 게시되는 날짜를 기준으로 무언가를 계산하는지 물었어요. 답은 그렇다였어요. 그 시점에 아직 열리지 않은 경기를 골라낸다는 거예요. 그래서 그녀는
Nightly scheduler라는 훅을 만들고, 동호회 이메일 발송에 이미 쓰던 스케줄링 서비스가 매일 밤 03:00에 그 훅으로 POST를 보내도록 설정했어요.
매일 아침 경주 페이지는 그날부터 시작해요. 훅의 행에는 마지막으로 호출된 시각이 표시되고, Versions에는 밤마다 한 행씩 추가되며 요약은 “Published again with the site's settings.”로 남아요.
게시할 때마다 버전이 하나씩 늘어난다는 점을 기억하세요. 매일 밤 도는 훅이면 한 달에 약 30줄이 Versions에 추가되고, 목록에는 최근 100개가 나와요. 페이지가 날짜에 따라 달라지는지 잘 모르겠다면 먼저 스튜디오에서 물어보세요(질문하기 참고). 질문에는 빌드 없이 답해요.
배포 훅과 웹훅
| 배포 훅 | 웹훅 | |
|---|---|---|
| 방향 | 다른 도구가 Briks를 호출해요 | Briks가 다른 도구를 호출해요 |
| 하는 일 | 사이트를 다시 게시해요 | 어떤 일이 일어났다고 도구에 알려줘요 |
| 시기 | 호출될 때마다 | site.published, form.received 또는 record.changed가 일어날 때 |
| 어디에 | Settings, Deploy hooks | Settings, Webhooks |
함께 쓰면 좋아요. site.published 웹훅은 배포 훅이 시작한 게시를 포함해 게시가 끝날 때마다 다른 도구에 알려 줄 수 있어요 (웹훅 참고).
훅 삭제하기
훅 행에서 Delete를 누르세요. 확인 창에 “주소가 즉시 작동을 멈춰요.”라고 나와요. Delete를 한 번 더 누르세요. 이 주소를 호출하는 도구는 게시를 실행하지 못하니, 그 도구에서도 주소를 지우세요.