Workers

Worker から Artifacts リポジトリを作成し、標準の Git クライアントでコンテンツを push / pull します。

このガイドの最後までに、Worker を作成し、Artifacts にバインドし、Workers バインディングでリポジトリを作り、コミットを push し、同じリポジトリを標準の Git クライアントで clone します。

先に 名前空間 を読み、使う名前空間名を決めてください。このガイドの例では default を使います。

1. Cloudflare アカウント ↗ に登録します。
2. Node.js ↗ をインストールします。

次も必要です。

• Wrangler がインストールされていること。このガイドでローカルの Wrangler コマンドを使う場合は、先に Wrangler で認証してください。ローカルの OAuth 認証や CI の設定は、wrangler login と CI/CD で Wrangler を実行する を参照してください。
• Cloudflare アカウントで Artifacts を利用できること。
• 名前空間名（例: default）。
• ローカルの git クライアント。
• レスポンスフィールドを自動抽出する場合は jq。

Wrangler 設定ファイルを開き、Artifacts バインディングを追加します。

{
  "$schema": "./node_modules/wrangler/config-schema.json",
  "name": "artifacts-worker",
  "main": "src/index.ts",
  // Set this to today's date
  "compatibility_date": "2026-09-20",
  "artifacts": [
    {
      "binding": "ARTIFACTS",
      "namespace": "default"
    }
  ]
}

name = "artifacts-worker"
main = "src/index.ts"
# Set this to today's date
compatibility_date = "2026-09-20"

[[artifacts]]
binding = "ARTIFACTS"
namespace = "default"
# Set remote = true if you want Wrangler to use the remote Artifacts service in local dev.

これで Worker 内から env.ARTIFACTS として Artifacts を使えます。

TypeScript を使っている場合は、ローカルのバインディング型を再生成します。

npx wrangler types

yarn wrangler types

pnpm wrangler types

Wrangler は、生成した worker-configuration.d.ts に Artifacts 型を追加します。

src/index.ts を次のコードに置き換えます。

export default {
	async fetch(request, env) {
		const url = new URL(request.url);

		if (request.method === "POST" && url.pathname === "/repos") {
			// Read the repo name from the request body so the route is reusable.
			const body = await request.json().catch(() => ({}));

			const repoName = body.name ?? "starter-repo";

			// Create the repo and return the remote URL plus initial write token.
			const created = await env.ARTIFACTS.create(repoName);

			return Response.json({
				name: created.name,
				remote: created.remote,
				token: created.token,
			});
		}

		return new Response("Use POST /repos to create an Artifacts repo.", {
			status: 405,
			headers: { Allow: "POST" },
		});
	},
};

export default {
	async fetch(request, env) {
		const url = new URL(request.url);

		if (request.method === "POST" && url.pathname === "/repos") {
			// Read the repo name from the request body so the route is reusable.
			const body = await request.json().catch(() => ({}));

			const repoName = body.name ?? "starter-repo";

			// Create the repo and return the remote URL plus initial write token.
			const created = await env.ARTIFACTS.create(repoName);

			return Response.json({
				name: created.name,
				remote: created.remote,
				token: created.token,
			});
		}

		return new Response("Use POST /repos to create an Artifacts repo.", {
			status: 405,
			headers: { Allow: "POST" },
		});
	},
};

この Worker は Artifacts リポジトリを作成し、Git クライアントが push / pull に使うリモート URL とトークンを返します。

デモでは、Worker が初回の write トークンを返します。本番では、clone と pull 向けに短命の read トークンを発行し、write トークンは push が必要な操作だけに発行してください。

ローカル開発を開始します。

npx wrangler dev

yarn wrangler dev

pnpm wrangler dev

次に、別のターミナルを開き、Worker にリクエストを送って新しい Artifacts リポジトリを作成します。

curl http://localhost:8787/repos \
  --header "Content-Type: application/json" \
  --data '{
    "name": "starter-repo"
  }'

{
	"name": "starter-repo",
	"remote": "https://<ACCOUNT_ID>.artifacts.cloudflare.net/git/default/starter-repo.git",
	"token": "art_v1_0123456789abcdef0123456789abcdef01234567?expires=1760000000"
}

export ARTIFACTS_REMOTE="<PASTE_REMOTE_FROM_RESPONSE>"
export ARTIFACTS_TOKEN="<PASTE_TOKEN_FROM_RESPONSE>"

RESPONSE=$(curl --silent http://localhost:8787/repos \
  --header "Content-Type: application/json" \
  --data '{"name":"starter-repo"}')

export ARTIFACTS_REMOTE=$(printf '%s' "$RESPONSE" | jq -r '.remote')
export ARTIFACTS_TOKEN=$(printf '%s' "$RESPONSE" | jq -r '.token')

前の手順で、Worker は空の Artifacts リポジトリを作成しました。次にローカル Git リポジトリを作り、ファイルを追加して Artifacts に push します。通常の Git リモートへの push と同じ手順です。

mkdir artifacts-demo
cd artifacts-demo
git init -b main
printf '# Artifacts demo\n' > README.md
git add README.md
git commit -m "Initial commit"
git remote add origin "$ARTIFACTS_REMOTE"
git -c http.extraHeader="Authorization: Bearer $ARTIFACTS_TOKEN" push -u origin main

-c http.extraHeader フラグはトークンをリクエストヘッダーとして渡すので、Git 設定やシェル履歴に残りません。

短時間のコマンド用に自己完結したリモート URL が必要な場合は、トークンのシークレットから組み立てます。

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

同じリポジトリを 2 つ目のディレクトリに clone します。

cd ..
git -c http.extraHeader="Authorization: Bearer $ARTIFACTS_TOKEN" clone "$ARTIFACTS_REMOTE" artifacts-clone
git -C artifacts-clone log --oneline -1

前の手順で push したコミットが表示されるはずです。

短時間のコマンド用に、自己完結したリモート URL で clone することもできます。

git clone "$ARTIFACTS_AUTH_REMOTE" artifacts-clone

Worker プロジェクトのディレクトリに戻ります。

cd artifacts-worker

wrangler dev を動かさなくてもリポジトリを作れるよう、Worker をデプロイします。

npx wrangler deploy

yarn wrangler deploy

pnpm wrangler deploy

Wrangler は workers.dev URL を表示します。その URL に対して同じ curl リクエストを送り、本番から追加のリポジトリを作成できます。