---
title: "배포 훅과 게시된 버전 | Briks"
url: https://briks.dev/ko/docs/publish-history
description: "사이트의 게시 버전을 모두 보고 복원하세요. 다른 도구가 호출하면 사이트를 다시 게시하는 비공개 주소, 배포 훅도 만들 수 있어요."
last_updated: 2026-10-08
---

# 배포 훅과 게시된 버전

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

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

## 게시된 버전 목록

어디에

1. Projects
2. Your project
3. Settings
4. Versions

이 섹션에는 최신 버전 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**, 새 주소, 도메인 연결 완료, 배포 훅이 여기에 해당해요. 요약에 어떤 일인지 나와요. 예: “사이트 설정으로 다시 게시했어요.” |

아무것도 게시하지 않은 작업까지 포함해 프로젝트의 모든 작업은 [로그](https://briks.dev/ko/docs/logs) 에서 볼 수 있어요.

### 변경이 도움이 됐나요?

버전이 7일 동안 게시되면, 그 버전의 행에 한 줄이 추가돼요. 그 버전이 바꾼 페이지의 방문을 이전과 이후로 비교하는 줄이고, 각각 앞뒤로 최대 14일에 걸친 주 평균이에요. 예를 들면 “버전 12(가격 섹션 추가) 이후, /prices의 문의가 비슷한 방문 수에서 주당 3건에서 5건이 됐어요.”처럼 보여요. 해당 페이지의 방문자가 주 25명 미만이면 판단하기에는 방문이 너무 적다고 알려요. 에이전트가 한 변경은 그 에이전트가 한 것으로 표시돼요. 이 줄은 AI 없이 내 [분석](https://briks.dev/ko/docs/analytics) 데이터로 계산하고 비용은 들지 않아요. 다시 게시만 한 버전과 첫 빌드에는 줄이 붙지 않아요. 최신 12개 버전을 읽고, 14일이 지나면 결과가 확정돼요.

### 버전 복원

1. 버전 찾기

   위치: Settings, Versions

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

2. 복원하기

   위치: Restore version

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

3. 게시되는 모습 보기

   위치: Studio

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

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

## 배포 훅이란

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

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

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

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

필요하지 않을 때

스튜디오에서 요청한 변경은 저절로 게시돼요. **Database** 탭에서 한 수정도 마찬가지예요. 수정 직후 사이트가 다시 게시되고, 그 뒤로는 수정을 몇 번 하든 최대 5분에 한 번만 게시돼요. 배포 훅은 스튜디오 밖에서 시작되는 게시를 위한 거예요.

## 디플로이 훅 만들기

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에서 새로 만드세요.” |
| 훅이 삭제되었어요 | 이 주소는 더 이상 작동하지 않아요. |

호출할 때마다 훅 행의 “마지막 호출” 시간이 갱신돼서 도구가 잘 작동하는지 확인할 수 있어요.

Briks 밖의 스케줄러 사용하기

프로젝트의 **Scheduled tasks** 는 briks.dev 주소를 거부하기 때문에 배포 훅을 호출할 수 없어요. 일정에 맞춰 게시하려면 이미 쓰고 있는 스케줄링 서비스를 이용하세요.

## 실제 예시

예시 러닝 클럽을 위한 야간 게시

> Northside Running Club의 사이트는 데이터베이스의 기록에서 앞으로 열릴 경기를 불러와 보여 줘요. 운영 담당자는 스튜디오에서 경기 페이지가 게시되는 날짜를 기준으로 무언가를 계산하는지 물었어요. 답은 그렇다였어요. 그 시점에 아직 열리지 않은 경기를 골라낸다는 거예요. 그래서 그녀는 `Nightly scheduler`라는 훅을 만들고, 동호회 이메일 발송에 이미 쓰던 스케줄링 서비스가 매일 밤 03:00에 그 훅으로 POST를 보내도록 설정했어요.

매일 아침 경주 페이지는 그날부터 시작해요. 훅의 행에는 마지막으로 호출된 시각이 표시되고, **Versions** 에는 밤마다 한 행씩 추가되며 요약은 “Published again with the site's settings.”로 남아요.

게시할 때마다 버전이 하나씩 늘어난다는 점을 기억하세요. 매일 밤 도는 훅이면 한 달에 약 30줄이 **Versions** 에 추가되고, 목록에는 최근 100개가 나와요. 페이지가 날짜에 따라 달라지는지 잘 모르겠다면 먼저 스튜디오에서 물어보세요([질문하기](https://briks.dev/ko/docs/asking-questions) 참고). 질문에는 빌드 없이 답해요.

## 배포 훅과 웹훅

|  | 배포 훅 | 웹훅 |
| --- | --- | --- |
| 방향 | 다른 도구가 Briks를 호출해요 | Briks가 다른 도구를 호출해요 |
| 하는 일 | 사이트를 다시 게시해요 | 어떤 일이 일어났다고 도구에 알려줘요 |
| 시기 | 호출될 때마다 | site.published, form.received 또는 record.changed가 일어날 때 |
| 어디에 | **Settings**, **Deploy hooks** | **Settings**, **Webhooks** |

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

## 훅 삭제하기

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

## 다음 글 읽기

- [프로젝트에서 작업하기 **버전, 실행 취소, 다시 실행** 모든 제작과 변경이 사이트 버전으로 저장돼요. 변경을 취소하거나 다시 적용하고, 이전 버전을 그대로 되살려 게시해요. 크레딧은 묶이지 않아요.](https://briks.dev/ko/docs/versions)
- [데이터와 자동화 **웹훅** 사이트 게시, 양식 전송, 레코드 변경 때 다른 도구로 서명된 메시지를 보내요. 페이로드, 서명, 재시도, 전송 내역을 설명해요.](https://briks.dev/ko/docs/webhooks)
- [데이터와 자동화 **예약 작업** 예약 작업으로 정해진 시간에 사이트 작업을 실행해요. 일정 작성, 실행 결과 확인, 실패 해결, 플랜 한도까지 안내해요.](https://briks.dev/ko/docs/crons)
- [데이터와 자동화 **로그** 빌드 로그와 최근 하루의 사이트 요청을 읽고, 수준이나 상태로 걸러 실패하는 폼과 작업, 느린 페이지를 찾아요.](https://briks.dev/ko/docs/logs)

아직 해결되지 않았나요?

프로젝트 이름과 기대했던 내용을 적어 [hello@briks.dev](mailto:hello@briks.dev) 로 보내 주세요. 스크린샷이 있으면 도움이 돼요.