公開バージョンとデプロイフック
サイトを公開するたびに、番号付きのバージョンとして保存され、プロジェクトの Settings にある Versions セクションに一覧表示されます。同じ Settings の Deploy hooks を使うと、ほかのツールからBriksにサイトの再公開を依頼できます。このページでは両方を説明します。
公開バージョンの一覧
このセクションには最新の100バージョンが新しい順に並びます。各行には次が表示されます。
- Version とその番号。訪問者が今見ているバージョンには、緑の Live タグが付きます。
- どのように生まれたか:Built、Changed、Checked and repaired、Published againのいずれかと、依頼した人。
- 公開された日時です。例: 2026年10月8日 14:32。
- 短い要約です。変更の場合は、あなたが頼んだ言葉そのままです。作成や新たな公開の場合は、Briksが行ったことです。
- バージョンが1週間公開されると、役に立ったかどうかを示す1行が付きます(下を参照)。
| ラベル | そのバージョンを作ったもの |
|---|---|
| Built | 最初のビルド、またはテンプレートやほかのプロジェクトからコピーした新しいプロジェクト |
| Changed | 依頼した変更、File Explorerで保存したコード、またはメディアライブラリから差し替えた画像 |
| Checked and repaired | 見つけた問題を修正したサイトチェック |
| Published again | 本番環境への移行またはプレビューへの戻し、Apply to the live site、新しいアドレス、ドメインの公開、デプロイフックが対象です。概要には、どれなのかが「Published again with the site's settings.」のように表示されます。 |
何も公開しなかったものを含め、プロジェクトのすべてのジョブについては、Logsをご覧ください。
変更は役に立ちましたか?
バージョンが7日間公開されると、その行に、変更したページについて、そのバージョンの前後の訪問数を比べる1行が加わります。それぞれ、前後最大14日間の1週間あたりの平均です。たとえば「バージョン12(料金セクションを追加)以降、/prices からのお問い合わせは週3件から5件になりました。訪問数は同程度です。」と表示されます。それらのページの訪問者が週25人未満の場合は、訪問数が少なすぎて判断できないと表示されます。エージェントが行った変更は、そのエージェントのものとして記されます。この1行はあなた自身のアクセス解析から、AIを使わずに算出されるため、費用はかかりません。再公開しただけのバージョンと最初のビルドには、この行は付きません。読み取り対象は最新の12バージョンで、14日が過ぎると結果は確定します。
バージョンを復元する
バージョンを探す
場所: Settings, Versions
プロジェクトを編集できる権限があれば、公開中のもの以外のすべての行に Restore ボタンが表示されます。
復元する
場所: Restore version
Restore を押します。ダイアログには「It goes back on the live site exactly as it was published. The versions after it stay saved, so you can come back.」と表示されます。Restore version と番号を押してください。
公開される様子を見る
場所: Studio
公開している間、Briksはスタジオに移動します。メッセージには、たとえば「Version 12 is live again, exactly as it was published.」と表示されます。Live タグはその行に移ります。
復元では AI は動きません。復元できるのは Owner、Admin、Editor で、Viewer は一覧を見られます。A/B テストの実行中は復元できません。バージョン、取り消し、やり直しでは、スタジオの中から同じ履歴を扱う方法を説明しています。
デプロイフックとは
デプロイフックは、呼び出されるたびにサイトを再公開する非公開のWebアドレスです。(デプロイとは公開することです。)このアドレスをスケジュールサービスなどの別のツールに渡すと、そのツールが新しく公開したいときに呼び出します。
呼び出すと、そのときのプロジェクト設定のまま、公開中のバージョンが自身のファイルからもう一度公開されます。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リクエスト(ページを読むだけでなく、何かを実行するよう求めるタイプのWebリクエスト)を送る必要があります。ほとんどの自動化ツールやスケジュールツールには、この設定があります。ダイアログには、ターミナルから行う呼び出しの形が表示されます:curl -X POST https://app.briks.dev/api/hooks/bdh_…。短縮されたアドレスの代わりに、実際にはあなたの完全なアドレスが入ります。
| 呼び出しが届いたとき | 何が起きるか |
|---|---|
| サイトの準備ができました | 公開は、他の作業と同じようにスタートし、スタジオに表示されます。 |
| 制作または公開がすでに実行中です | 呼び出しは受け付けられて同じ処理にまとめられるため、連続して呼び出しても公開は1回だけです。 |
| フックは過去1時間に6回呼び出されました | 拒否されました:「このフックは直近1時間に6回呼び出されました。後でもう一度お試しください。」 |
| このプロジェクトは一度も公開されていません | 拒否されました:「The project has not been published yet.」 |
| A/Bテストを実施中です | 断られました:「このサイトではA/Bテストが実行中です。先に、どちらか一方のバージョンを残してテストを終了してください。」 |
| フックを作成した方も、プロジェクトを作成した方も、もうBriksのアカウントを持っていません | 拒否されました: 「This hook has no owner left. Make a new one in the project's Deploy hooks.」 |
| フックは削除されました | このアドレスはもう使えません。 |
呼び出しのたびに、そのフックの行の「最終呼び出し」の時刻が更新されるので、ツールが動いていることを確認できます。
具体的な例
Northside Running Clubのサイトは、データベースのレコードから今後のレースを一覧表示しています。主催者はスタジオで、レースのページが公開時に日付から何かを計算しているか尋ねました。答えは「はい」で、その時点でまだ先のレースを選び出しているとのことでした。そこで
Nightly schedulerというフックを作り、クラブのメールにすでに使っているスケジュールサービスから、毎晩03:00にPOSTを送るよう設定しました。
毎朝、レース一覧ページはその日から始まります。フックの行には最後に呼び出された日時が表示され、Versions には毎晩1行ずつ増えます。その概要は「Published again with the site's settings.」です。
公開のたびにバージョンが1つ増えるため、毎晩実行するフックでは Versions に1か月で約30行が追加され、一覧には最新の100件が表示されることにご注意ください。ページが日付に左右されるかわからない場合は、先にスタジオで質問してください(質問するをご覧ください)。質問への回答では、ビルドは行われません。
デプロイフックとWebhook
| Deploy hook | Webhook | |
|---|---|---|
| 方向 | 別のツールがBriksを呼び出す | Briks が別のツールを呼び出す |
| できること | サイトをもう一度公開します | 何かが起きたことをツールに知らせます |
| いつ | 呼び出されるたびに | site.published、form.received、record.changedのとき |
| どこで | Settings、Deploy hooks | Settings、Webhooks |
組み合わせて使うこともできます。site.publishedのwebhookを使うと、公開が終わるたびに別のツールへ知らせることができます。デプロイフックで始まった公開も含まれます(Webhooksを参照)。
フックを削除する
フックの行にある Delete を押します。確認画面に「Its address stops working at once.」と表示されます。もう一度 Delete を押してください。このアドレスを呼び出しているツールでは公開が行われなくなるため、ツール側からもアドレスを削除してください。