Cloudflare cf
CLI ハンズオンガイド

node --version
npm --version
jq --version

# このガイドと同じ版を入れる
npm install -g cf@1.0.0-beta.5
cf --version

# 検証用の作業場所
mkdir cf-hands-on
cd cf-hands-on

# このシェルではcf自身のテレメトリを無効にする
export CF_SEND_TELEMETRY=false

cf cli search "list DNS records"
cf dns records list --help
cf schema dns records list

cf cli search "create KV namespace"
cf kv namespaces create --help
cf schema kv namespaces create
cf kv namespaces create --title cf-guide-lab --dry-run

{
  "command": "cf kv namespaces create",
  "method": "POST",
  "url": "https://api.cloudflare.com/client/v4/accounts/<account-id>/storage/kv/namespaces",
  "pathParams": {},
  "bodyKind": "json",
  "body": { "title": "cf-guide-lab" }
}

cf auth login
cf auth list

# 環境変数は各自の対象IDへ置き換える
export CLOUDFLARE_ACCOUNT_ID="自分のアカウントID"
export CLOUDFLARE_ZONE_ID="自分のゾーンID"

# 複数のログインを使い分けたい場合
cf auth create lab
cf auth activate lab
cf auth list

# このコマンドだけlabを選ぶ
cf kv namespaces list --profile lab

# フォルダへの関連付けを外す
cf auth deactivate

# DNS：指定ゾーンにあるAレコードを1ページ取得
cf dns records list --zone "$CLOUDFLARE_ZONE_ID"   --type A --page 1 --per-page 5 > dns-records.json

# JSONの配列から必要な列だけを抜き出す
jq '.[] | {id, name, type, content}' dns-records.json

# ドメインがない場合はこちら
cf kv namespaces list --page 1 --per-page 20 > namespaces.json
jq '.[] | {id, title}' namespaces.json

cf kv keys put greeting --namespace-id cf-guide-lab   --body "Hello cf" --local --persist-to ./cf-state

cf kv keys get greeting --namespace-id cf-guide-lab   --text --local --persist-to ./cf-state

cf kv keys list --namespace-id cf-guide-lab   --local --persist-to ./cf-state

cf kv keys delete greeting --namespace-id cf-guide-lab   --local --persist-to ./cf-state --force

cf kv namespaces create --title cf-guide-lab --dry-run

# Account IDとtitleを確認した後に実行
cf kv namespaces create --title cf-guide-lab > kv-created.json
cat kv-created.json

# 作成結果のIDを使う（.idがあることを先に確認）
export CF_LAB_KV_ID="$(jq -er '.id' kv-created.json)"
: "${CF_LAB_KV_ID:?KVの作成結果を確認してください}"

cf kv keys put greeting --namespace-id "$CF_LAB_KV_ID"   --body "Hello cf" --dry-run
cf kv keys put greeting --namespace-id "$CF_LAB_KV_ID"   --body "Hello cf"
cf kv keys get greeting --namespace-id "$CF_LAB_KV_ID" --text

# 同じキーへのputは値を置き換える
cf kv keys put greeting --namespace-id "$CF_LAB_KV_ID"   --body "Hello again"
cf kv keys list --namespace-id "$CF_LAB_KV_ID" --prefix greeting

# kv-created.jsonのtitleとidが今回の演習のものか照合
jq '{id, title}' kv-created.json
cf kv namespaces delete "$CF_LAB_KV_ID" --dry-run

# namespace内の全キーも消える。ID確認後、対話確認して実行
cf kv namespaces delete "$CF_LAB_KV_ID"

# 削除後の一覧も確認（複数ページの場合は続きも見る）
cf kv namespaces list --page 1 --per-page 100
unset CF_LAB_KV_ID

# cf-hands-onディレクトリで実行
cf init cf-worker-lab --package-manager npm
cd cf-worker-lab

# 以後はプロジェクト内のcfを使う
npm run dev

npm run typecheck
npm run build
npx cf deploy --dry-run

import { bindings, defineConfig } from "cf/config";
import * as entrypoint from "./src/index.ts" with { type: "cf-worker" };

export default defineConfig(({ mode }) => ({
  worker: {
    name: mode === "production" ? "cf-worker-lab" : "cf-worker-lab-dev",
    compatibilityDate: "2026-09-25",
    entrypoint,
    env: {
      WORLD: bindings.text(mode === "production" ? "Production" : "Local"),
    },
  },
}));

import { env } from "cloudflare:workers";

export default {
  fetch() {
    return new Response(`Hello ${env.WORLD}!`);
  },
} satisfies ExportedHandler;

npm run typecheck
npx cf dev --mode development
# 開発サーバーを止めてから
npx cf build --mode production
npx cf deploy --mode production --dry-run

// worker.envに追加する例
API_TOKEN: bindings.secret(),
CACHE: bindings.kv({ id: "環境別のKV namespace ID" }),
DATABASE: bindings.d1({ name: "cf-lab-db" }),
UPLOADS: bindings.r2({ name: "cf-lab-uploads" }),

// import { defineConfig, triggers } from "cf/config";
// worker.triggersに置く部分例
triggers: [
  triggers.fetch({ pattern: "example.com/*" }),
  triggers.scheduled({ schedule: "0 * * * *" }),
  triggers.queue({ name: "jobs", maxBatchSize: 10 }),
],

# 同じmodeで内容を確認
npx cf deploy --mode production --dry-run

# 実際の配備（ユーザーが実施する演習）
npx cf deploy --mode production

# 出力されたURLをブラウザ、またはcurlで確認
curl -i "https://配備ログに表示されたURL/"

# 既存プロジェクトの作業ツリーがきれいな状態で開始
 git status --short
 git switch -c migrate-cf
 cf migrate
 git diff --stat
 git diff

# 実際に用意されているプロジェクトのスクリプトで確認
 npm run build

#!/usr/bin/env bash
set -euo pipefail
: "${CLOUDFLARE_API_TOKEN:?CIの秘密変数を設定してください}"
: "${CLOUDFLARE_ACCOUNT_ID:?対象アカウントIDを設定してください}"
export CF_SEND_TELEMETRY=false
export CF_QUIET=1
npm ci
npx --no-install cf kv namespaces list --page 1 --per-page 100 > namespaces.json
jq -e 'type == "array"' namespaces.json >/dev/null
jq '[.[] | {id, title}]' namespaces.json > namespace-summary.json

cfを使い、指定した検証アカウントのKV namespace一覧だけを取得する。
最初に cf cli search で操作を探し、help / schemaで引数を確認する。
検索には個人名、ドメイン、ID、トークンを含めない。
新規作成・更新・削除・配備は実行しない。
出力形式とページング範囲を確認してから結果を要約する。

cf cli telemetry status
cf cli telemetry disable
# コマンド単位で止めたい場合
CF_SEND_TELEMETRY=false cf cli search "list KV namespaces"