← Cloudflare Workers / workers / wrangler / commands

Containers

Interakce s Containers pomocí Wrangler.

Sestavte image kontejneru ze souboru Dockerfile.

wrangler containers build [PATH] [OPTIONS]

• PATH string volitelné
  • Cesta k adresáři obsahujícímu Dockerfile, který se má sestavit.
• -t, --tag string povinné
  • Název a volitelně tag (formát: "name:tag").
• --path-to-docker string volitelné
  • Cesta k binárnímu souboru dockeru, pokud se nenachází v $PATH.
  • Výchozí: "docker"
• -p, --push boolean volitelné
  • Odešlete sestavený image do registru spravovaného Cloudflare.
  • Výchozí: false

Odstranit Container (aplikaci).

wrangler containers delete <CONTAINER_ID> [OPTIONS]

• CONTAINER_ID string povinné
  • ID Containeru, který chcete odstranit.

Provádět operace s images v registru vašich kontejnerů.

Vypsat images v registru vašich kontejnerů.

wrangler containers images list [OPTIONS]

• --filter string volitelné
  • Regulární výraz pro filtrování výsledků.
• --json boolean volitelné
  • Vrátí výstup jako čistý JSON.
  • Výchozí: false

Odebrat image z registru vašich kontejnerů.

wrangler containers images delete [IMAGE] [OPTIONS]

• IMAGE string povinné
  • Obrázek ke smazání ve tvaru IMAGE:TAG

Nakonfigurujte a zobrazte registry dostupné pro váš kontejner. Přečtěte si více o aktuálně podporovaných externích registrech.

Vypsat registry, které mohou vaše kontejnery používat.

wrangler containers registries list [OPTIONS]

• --json boolean volitelné
  • Vrátí výstup jako čistý JSON.
  • Výchozí: false

Nakonfigurujte nový registr pro váš účet.

wrangler containers registries configure [DOMAIN] [OPTIONS]

• DOMAIN string povinné
  • Doména, kterou chcete nakonfigurovat pro registr.
• --dockerhub-username string volitelné
  • Uživatelské jméno Docker Hub, kterým se ověřujete. Použijte s docker.io doména. Secret je osobní přístupový token pro Docker Hub.
• --aws-access-key-id string volitelné
  • ID přístupového klíče AWS, kterým se ověřujete. Použijte s doménou Amazon ECR. Tajným klíčem je odpovídající tajný přístupový klíč AWS.
• --gar-email string volitelné
  • E-mail servisního účtu Google, kterým se ověřujete. Použijte s *-docker.pkg.dev domény.
• --secret-store-id string volitelné
  • ID Secrets Store, který chcete použít k uložení přihlašovacích údajů registru
• --secret-name string volitelné
  • Název, pod kterým má Wrangler uložit přihlašovací údaje k registru

Příznaky přihlašovacích údajů se vzájemně vylučují. Použijte ten, který odpovídá registru, který konfigurujete.

Při interaktivním spuštění vás wrangler vyzve k zadání secretu a uloží ho do Secrets Store. Chcete-li ho spustit neinteraktivně, můžete hodnotu secretu poslat wrangleru přes stdin a secret se za vás vytvoří.

Odebrat konfiguraci registru z vašeho účtu.

wrangler containers registries delete [DOMAIN] [OPTIONS]

• DOMAIN string povinné
  • doména registru, který má být odstraněn

Vygenerujte dočasné přihlašovací údaje pro nahrávání (push) a stahování (pull) obrazů ze spravovaného registru Cloudflare (registry.cloudflare.com).

wrangler containers registries credentials [OPTIONS]

• --push boolean volitelné
  • Vygenerovat přihlašovací údaje s oprávněním push.
• --pull boolean volitelné
  • Vygenerovat přihlašovací údaje s oprávněním pull.
• --expiration-minutes number volitelné
  • Jak dlouho mají být přihlašovací údaje platné (v minutách).
  • Výchozí: 15

Alespoň jeden z --push nebo --pull musí být zadáno.

Získat informace o konkrétním Containeru včetně základních údajů a seznamu instancí.

wrangler containers info <CONTAINER_ID> [OPTIONS]

• CONTAINER_ID string povinné
  • ID Containeru, o kterém chcete získat informace.

Vypsat všechny instance kontejnerů pro danou aplikaci. Zobrazí ID instance, název, stav, umístění, verzi a datum vytvoření.

V interaktivním režimu jsou výsledky stránkované. Stiskněte Enter k načtení další stránky nebo Esc/q k zastavení. V neinteraktivních prostředích (například při přesměrování výstupu nebo spuštění v CI) se všechny stránky načtou automaticky.

Použijte --json příznak, který vrátí výstup jako ploché pole JSON. Každý prvek obsahuje pole id, name, state, location, version, a created. Zároveň jde o výchozí výstupní formát v neinteraktivních prostředích.

wrangler containers instances <APPLICATION_ID> [OPTIONS]

• APPLICATION_ID string povinné
  • UUID aplikace, jejíž instance chcete vypsat. Použijte wrangler containers list k vyhledání ID aplikací.
• --per-page number volitelné
  • Počet instancí na stránku.
  • Výchozí: 25
• --json boolean volitelné
  • Vrátí výstup jako čistý JSON.
  • Výchozí: false

Chcete-li například vypsat instance pro aplikaci:

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

Chcete-li získat stejná data ve formátu 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"
	}
]

Vypsat Containers ve vašem účtu.

wrangler containers list [OPTIONS]

Odešlete otagovaný image do registru spravovaného Cloudflare, který se automaticky integruje s vaším účtem.

wrangler containers push [TAG] [OPTIONS]

• TAG string povinné
  • Název a tag imagu kontejneru, který se má nahrát.
• --path-to-docker string volitelné
  • Cesta k binárnímu souboru dockeru, pokud se nenachází v $PATH.
  • Výchozí: "docker"

Připojte se k běžící instanci Container pomocí SSH. Viz SSH pro podrobnosti o konfiguraci.

wrangler containers ssh <INSTANCE_ID>

Místo výchozího shellu můžete také zadat příkaz, který se má spustit. Například:

wrangler containers ssh <INSTANCE_ID> -- ls -al

• INSTANCE_ID string povinné
  • ID instance Container, ke které se připojujete přes SSH.