Containers

Wrangler で Containers を操作します。

Dockerfile から Container イメージをビルドします。

wrangler containers build [PATH] [OPTIONS]

• PATH string 任意
  • ビルドする Dockerfile があるディレクトリのパスです。
• -t, --tag string 必須
  • 名前と、任意でタグです（形式: "name:tag"）。
• --path-to-docker string 任意
  • $PATH にない場合の docker バイナリのパスです。
  • デフォルト: "docker"
• -p, --push boolean 任意
  • ビルドしたイメージを Cloudflare 管理レジストリへ push します。
  • デフォルト: false

Container（アプリケーション）を削除します。

wrangler containers delete <CONTAINER_ID> [OPTIONS]

• CONTAINER_ID string 必須
  • 削除する Container の ID です。

コンテナレジストリ内のイメージを操作します。

コンテナレジストリ内のイメージを一覧表示します。

wrangler containers images list [OPTIONS]

• --filter string 任意
  • 結果を絞り込む正規表現です。
• --json boolean 任意
  • 出力を JSON で返します。
  • デフォルト: false

コンテナレジストリからイメージを削除します。

wrangler containers images delete [IMAGE] [OPTIONS]

• IMAGE string 必須
  • 削除するイメージです。形式は IMAGE:TAG です。

Container で利用できるレジストリを設定・確認します。 現在対応している外部レジストリの 詳細 を参照してください。

Container が利用できるレジストリを一覧表示します。

wrangler containers registries list [OPTIONS]

• --json boolean 任意
  • 出力を JSON で返します。
  • デフォルト: false

アカウントに新しいレジストリを設定します。

wrangler containers registries configure [DOMAIN] [OPTIONS]

• DOMAIN string 必須
  • レジストリに設定するドメインです。
• --dockerhub-username string 任意
  • 認証に使う Docker Hub のユーザー名です。docker.io ドメインと一緒に使います。シークレットは Docker Hub の personal access token です。
• --aws-access-key-id string 任意
  • 認証に使う AWS アクセスキー ID です。Amazon ECR ドメインと一緒に使います。シークレットは対応する AWS シークレットアクセスキーです。
• --gar-email string 任意
  • 認証に使う Google サービスアカウントのメールアドレスです。*-docker.pkg.dev ドメインと一緒に使います。
• --secret-store-id string 任意
  • レジストリ認証情報の保存に使うシークレットストアの ID です。
• --secret-name string 任意
  • Wrangler がレジストリ認証情報を保存するときの名前です。

認証情報のフラグは同時に指定できません。設定するレジストリに合うものを使います。

対話モードで実行すると、Wrangler がシークレットの入力を求め、Secrets Store に保存します。 対話なしで実行する場合は、stdin からシークレット値を Wrangler に渡すと、シークレットが作成されます。

アカウントからレジストリ設定を削除します。

wrangler containers registries delete [DOMAIN] [OPTIONS]

• DOMAIN string 必須
  • 削除するレジストリのドメインです。

Cloudflare 管理レジストリ（registry.cloudflare.com）へイメージを push または pull するための一時認証情報を生成します。

wrangler containers registries credentials [OPTIONS]

• --push boolean 任意
  • push 権限付きの認証情報を生成します。
• --pull boolean 任意
  • pull 権限付きの認証情報を生成します。
• --expiration-minutes number 任意
  • 認証情報の有効期間（分）です。
  • デフォルト: 15

--push または --pull の少なくとも一方を指定する必要があります。

特定の Container の情報を取得します。概要とインスタンス一覧を含みます。

wrangler containers info <CONTAINER_ID> [OPTIONS]

• CONTAINER_ID string 必須
  • 情報を取得する Container の ID です。

指定したアプリケーションの Container インスタンスをすべて一覧表示します。インスタンス ID、名前、状態、ロケーション、バージョン、作成時刻を表示します。

対話モードでは、結果はページ分割されます。次のページを読み込むには Enter を押します。終了するには Esc または q を押します。対話なしの環境（出力のパイプや CI での実行など）では、すべてのページを自動で取得します。

--json フラグを使うと、フラットな JSON 配列で出力します。各要素には id、name、state、location、version、created フィールドがあります。対話なしの環境では、この形式がデフォルトです。

wrangler containers instances <APPLICATION_ID> [OPTIONS]

• APPLICATION_ID string 必須
  • インスタンスを一覧するアプリケーションの UUID です。アプリケーション ID は wrangler containers list で確認できます。
• --per-page number 任意
  • 1 ページあたりのインスタンス数です。
  • デフォルト: 25
• --json boolean 任意
  • 出力を JSON で返します。
  • デフォルト: false

例: アプリケーションのインスタンスを一覧表示します。

wrangler containers instances 12345678-abcd-1234-abcd-123456789abc

INSTANCE                              NAME        STATE          LOCATION  VERSION  CREATED
a1b2c3d4-e5f6-7890-abcd-ef1234567890  worker-12   running        sfo06     3        2025-06-01T12:00:00Z
b2c3d4e5-f6a7-8901-bcde-f12345678901  worker-47   provisioning   iad01     2        2025-06-01T13:00:00Z

同じデータを JSON で取得します。

wrangler containers instances 12345678-abcd-1234-abcd-123456789abc --json

[
	{
		"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
		"name": "worker-12",
		"state": "running",
		"location": "sfo06",
		"version": 3,
		"created": "2025-06-01T12:00:00Z"
	}
]

アカウント内の Container を一覧表示します。

wrangler containers list [OPTIONS]

タグ付きイメージを、アカウントに自動連携されている Cloudflare 管理レジストリへ push します。

wrangler containers push [TAG] [OPTIONS]

• TAG string 必須
  • push するコンテナイメージの名前とタグです。
• --path-to-docker string 任意
  • $PATH にない場合の docker バイナリのパスです。
  • デフォルト: "docker"

実行中の Container インスタンスに SSH で接続します。設定の詳細は SSH を参照してください。

wrangler containers ssh <INSTANCE_ID>

デフォルトのシェルの代わりに、実行するコマンドを指定することもできます。例:

wrangler containers ssh <INSTANCE_ID> -- ls -al

• INSTANCE_ID string 必須
  • SSH 接続する Container インスタンスの ID です。