배포 훅과 게시된 버전

사이트를 게시할 때마다 번호가 매겨진 버전으로 보관되고, 프로젝트 Settings의 Versions 섹션에 목록으로 나와요. 같은 Settings의 Deploy hooks를 쓰면 다른 도구가 Briks에 사이트를 다시 게시해 달라고 요청할 수 있어요. 이 페이지에서는 둘 다 다뤄요.

읽는 데 7분2026년 10월 8일 스튜디오 기준으로 확인함

게시된 버전 목록

이 섹션에는 최신 버전 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일이 지나면 결과가 확정돼요.

버전 복원

  1. 버전 찾기

    위치: Settings, Versions

    프로젝트를 편집할 수 있는 역할이라면, 현재 라이브인 행을 뺀 모든 행에 Restore 버튼이 있어요.

  2. 복원하기

    위치: Restore version

    Restore를 누르세요. 대화상자에 “게시되었던 모습 그대로 라이브 사이트로 돌아가요. 이후 버전은 그대로 저장되어 있어서 다시 돌아올 수 있어요.”라고 나와요. Restore version과 번호를 누르세요.

  3. 게시되는 모습 보기

    위치: Studio

    게시하는 동안 Briks가 스튜디오로 안내해요. 메시지는 예를 들어 “버전 12가 게시되었던 그대로 다시 라이브가 되었어요.”처럼 나와요. Live 태그가 그 행으로 옮겨 가요.

복원에는 AI가 쓰이지 않아요. Owner, Admin, Editor는 복원할 수 있고, Viewer는 목록을 볼 수 있어요. A/B 테스트가 진행되는 동안에는 복원할 수 없어요. 버전, 실행 취소, 다시 실행에서 스튜디오 안에서 같은 기록을 다루는 방법을 볼 수 있어요.

배포 훅이란

배포 훅은 무언가 호출할 때마다 사이트를 다시 게시하는 비공개 웹 주소예요. (배포는 게시한다는 뜻이에요.) 이 주소를 예약 서비스 같은 다른 도구에 주면, 그 도구가 새로 게시하고 싶을 때 호출해요.

호출하면 라이브 버전이 자체 파일로 다시 게시되고, 프로젝트 설정은 현재 상태 그대로 적용돼요. AI는 실행되지 않고, 요금도 없고, 직접 바꾸지 않은 것은 달라지지 않아요. 사이트 페이지는 방문할 때마다가 아니라 게시할 때 만들어지므로, 새로 게시하면 다음이 반영돼요:

  • 사이트 데이터베이스에서 가져온 최신 게시 레코드, 이 레코드로 만든 모든 페이지에 적용돼요.
  • 마지막으로 게시한 뒤 바꾼 설정(로고, 파비콘, 검색 설정 등);
  • 페이지가 조립되는 순간 스스로 계산하는 모든 것.

설명한 변경을 하거나, 이를 호출하는 도구의 데이터를 읽거나, 출시 점검을 실행하지는 않아요.

디플로이 훅 만들기

  1. Deploy hooks 열기

    위치: Settings, Deploy hooks

    프로젝트를 열고 Settings 탭을 클릭한 다음, Developer 그룹의 Deploy hooks를 클릭하세요.

  2. 하나 추가

    위치: Add a deploy hook

    Add deploy hook을 누르세요. 호출하는 대상의 이름으로 지어 주세요. 예를 들면 Nightly scheduler예요. 그런 다음 Make hook을 누르세요.

  3. 주소 복사

    위치: Your deploy hook

    Briks는 주소를 한 번만 보여드려요. Copy를 눌러 이 주소를 호출할 도구에 바로 붙여넣으세요. Briks는 읽을 수 있는 사본을 보관하지 않아서 나중에 다시 볼 수 없어요.

  4. 마치기

    위치: 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 hooksSettings, Webhooks

함께 쓰면 좋아요. site.published 웹훅은 배포 훅이 시작한 게시를 포함해 게시가 끝날 때마다 다른 도구에 알려 줄 수 있어요 (웹훅 참고).

훅 삭제하기

훅 행에서 Delete를 누르세요. 확인 창에 “주소가 즉시 작동을 멈춰요.”라고 나와요. Delete를 한 번 더 누르세요. 이 주소를 호출하는 도구는 게시를 실행하지 못하니, 그 도구에서도 주소를 지우세요.