Artifacts の仕組み

Artifacts は、必要に応じて Git リポジトリを作成します。各リポジトリは、独自の remote URL、トークン、永続状態を持つ独立した Git サービスです。

基本モデル

namespace は、リポジトリの最上位の入れ物です。リポジトリは 1 つの namespace に属し、名前はその namespace 内で一意です。

Artifacts は namespace を個別にプロビジョニングしません。新しい namespace 名で最初のリポジトリを作成すると、その namespace も同時に作成されます。

namespace は、リポジトリの命名とルーティングの境界です。namespace とリポジトリ名を合わせると、リポジトリの安定したアドレスになります。API レスポンスでは repo ID も返ります。

Durable Objects と同様に、リポジトリは論理的に 1 つのインスタンスであり、Cloudflare はどのリージョンからでもルーティングできます。

各リポジトリは独立しているため、次のものを個別に持ちます。

リポジトリは必要なときに作成できます。これにより、Artifacts は小さな作業単位を別々のリポジトリに分けてモデル化できます。

フォークも同じモデルです。フォークは既存リポジトリの履歴から始まる新しいリポジトリを作り、その後は独自のトークン、ルーティング、ライフサイクルで独立して分岐します。

アクセスもリポジトリ単位です。各リポジトリには独自のトークンがあり、トークンごとにアクセスレベルを制限できます。

トークンを発行するタイミングは、Worker または API 層が決めます。認証と認可はリポジトリの外に置きつつ、Workers、REST API、標準の Git クライアントからリポジトリを使えます。

Artifacts は、デフォルトで永続です。リポジトリは、1 つのプロセスが動き続けることや、1 つのデータセンターが使えることに依存しません。

裏側では、Cloudflare が複数のデータセンターへリポジトリデータを同期複製し、オブジェクトストレージとスナップショットへ非同期コピーします。リポジトリの状態を保つために、独自のレプリケーション、フェイルオーバー、スナップショットの仕組みを作る必要はありません。

Artifacts は、これらの Git ワークフローの下で Git サーバーのライフサイクルとストレージ基盤を扱います。