Git プロトコル

Artifacts は、すべての Artifacts リポジトリに Git アクセスを公開します。

各リポジトリには、標準の Git smart HTTP リモートがあります。場所は https://<ACCOUNT_ID>.artifacts.cloudflare.net/git/<namespace>/<repo>.git です。

<ACCOUNT_ID> プレースホルダーは、Cloudflare のアカウント ID に置き換えます。ホスト名は、Workers バインディングまたは REST API が返すリポジトリの remote と正確に一致させてください。

返されたリポジトリの remote は、通常の Git クライアントで clone、fetch、pull、push に使えます。

Git ルートは、次の 2 形式でリポジトリアクセストークンを受け付けます。

リポジトリトークンは art_v1_<40 hex>?expires=<unix_seconds> 形式で発行されます。?expires= サフィックスは、トークンの有効期限を Unix 秒のタイムスタンプで表します。期限を確認するには、?expires= のあとの値を解析します。

Git の http.extraHeader ↗ 設定で、git リクエストに HTTP ヘッダーを付けられます。

API が返すトークン文字列をそのまま使う場合は、Bearer トークンとして渡します。

git -c http.extraHeader="Authorization: Bearer $ARTIFACTS_TOKEN" clone "$ARTIFACTS_REMOTE" artifacts-clone

URL 形式では、パスワード欄にトークンのシークレットを使います。Artifacts は Basic 認証のユーザー名を無視します。

この形式は、短時間のコマンド用に自己完結したリモート URL が必要なときだけ使ってください。

export ARTIFACTS_TOKEN_SECRET="${ARTIFACTS_TOKEN%%\?expires=*}"
export ARTIFACTS_AUTH_REMOTE="https://x:${ARTIFACTS_TOKEN_SECRET}@${ARTIFACTS_REMOTE#https://}"

git clone "$ARTIFACTS_AUTH_REMOTE" artifacts-clone

git push "$ARTIFACTS_AUTH_REMOTE" HEAD:main

URL のユーザー名は空でなければ何でも構いません。Artifacts はそのユーザー名を受け付けますが、それ以外では使わず記録もしません。x はプレースホルダーです。

Artifacts は、clone と fetch で Git プロトコル v1 と v2 に対応しています。Git クライアントはプロトコルを自動で交渉します。