サイトのコードをGitHubで管理

#GitHubに送られるもの

サイト自身のファイルだけです。ファイルエクスプローラーに表示され、ダウンロードに含まれるものです。すべてのBriksサイトが動く共通部分、サイトの設定、キー、データベースのレコードは、そこには送られません。そのため、リポジトリ単体ではビルドも実行もできません。プッシュした内容をビルドして公開するのはBriksです。

リポジトリにREADMEがない場合、Briksはこれらのフォルダと同期の仕組みを説明するREADMEを追加します。

#リポジトリを接続する

数分以内に、最初のコミットで本番環境の最新版が反映されます。サイトのフォルダー内のファイルはサイト自体のファイルに置き換えられ、サイトにないファイルは削除されます。リポジトリ内のそれ以外はそのままです。Briksは強制プッシュをしないので、履歴から失われるものはありません。

#BriksからGitHubへ

• 公開されてサイトのファイルを変更したバージョンは、作成方法にかかわらず、ブランチ上の1つのコミットになります。ビルド、変更、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 と表示されます。公開されなかった場合は、その理由が表示されます。

• 1回のプッシュで変更できるのは、最大300ファイル、1ファイルあたり256 KBまで、合計8 MBまでです。
• 公開されるプッシュは、サイトごとに1時間あたり最大20回、1日あたり最大100回です。上限を超えたプッシュは待機し、GitHub上のステータスに公開される時刻が表示されます。待機中に届いたプッシュは、まとめて公開されます。
• A/Bテストの実行中は、プッシュはテストが終わるまで待機します。

#双方が同じファイルを変更した場合

Briksの公開中に届いたプッシュは、順番を待ちます。プッシュとBriksが別々のファイルを変更した場合は、どちらも残ります。同じファイルを異なる形で変更した場合は、そのプッシュは何も公開されません。Briksは自分の版を briks-sync というブランチに置き、プッシュのステータスにそのファイル名が示されます。GitHubで briks-sync をマージして再度プッシュするか、SettingsのGitHubで解決してください。

• Use GitHub's version は、プッシュ全体を公開します。双方で変更されたファイルも含まれます。
• Keep Briks's version は、双方が変更したファイルを除いてプッシュを公開します。

force-pushなどでブランチの履歴が書き換えられた場合、同じ2つのボタンのどちらかを選ぶまで、同期は一時停止します。

#通知される内容

正常に動いた同期は静かに終わり、プッシュが公開されたというメッセージだけが届きます。公開されなかったプッシュ、マージ待ちのプッシュ、止まってしまった接続は、ベルのアイコンと、Builds finished or failed アラートをオンにしているTelegramとDiscordのチャットに表示されます。SettingsのGitHubには、双方向の直近20件の同期が、コミット、ファイル、結果とともに表示されます。

#接続を解除する

• Settings、GitHub の Disconnect で、両方向の同期が止まります。リポジトリとその履歴は、そのまま残ります。
• プロジェクトを別のワークスペースに移動すると、接続は解除されます。
• GitHubでアプリがアンインストールされたり、リポジトリがアクセス対象から外されたりすると、同期は止まり、その旨が通知されます。
• プロジェクトを削除しても、リポジトリには一切影響しません。