← Containers / containers
Nasaďte Containers
Nasazení z vlastního počítače
-
Pokud
imageve vaší konfiguraci Wrangler je cesta k Dockerfile, spusťte Docker ↗ nebo jiný motor kompatibilní s Docker. Zadejte přímo Dockerfile, nikoli jeho adresář. Pokudimageje odkaz na registr (Cloudflare Registry, Docker Hub, Amazon ECR nebo Google Artifact Registry), Docker při nasazení nepotřebujete. Viz Správa obrazů. -
Ve složce svého projektu spusťte:
npx wrangler deploy -
Počkejte, až příkaz dokončí činnost.
wrangler deploy nahraje a aktivuje váš Worker ještě předtím, než zpracuje konfiguraci kontejneru. U obrazu z Dockerfile pak Wrangler obraz sestaví a nahraje, je-li to potřeba. U obrazu z registru použije nakonfigurovaný odkaz na obraz. Tyto kroky nejsou transakční: sestavení obrazu, nahrání obrazu nebo rollout chyba může nastat až poté, co je nový Worker již aktivní.
U existující kontejnerové aplikace spustí Wrangler rollout, jakmile se změní efektivní konfigurace kontejneru. Příkaz nečeká, až budou nahrazeny všechny instance kontejneru, takže nový kód Worker může krátce komunikovat s kontejnery, které ještě běží na předchozím obrazu. První nasazení vytvoří kontejnerovou aplikaci přímo a nasazení bez efektivní změny konfigurace kontejneru nespustí žádný rollout.
Informace o příznacích rolloutu a konfiguraci kroků najdete v Rollouty.
Nasazení pomocí Workers Builds
Workers Builds spustí příkazy pro sestavení a nasazení, které nakonfigurujete pro Worker propojený s vaším repozitářem Git.
| Větev Git | Výchozí příkaz pro nasazení | Containers |
|---|---|---|
| Produkční větev | npx wrangler deploy |
V případě potřeby publikuje image a nasadí instance kontejnerů formou rolloutu. Sestavení z Dockerfile lze spouštět v prostředí Workers Builds. |
| Ostatní větve (pokud sestavení neprodukčních větví jsou povoleny) | npx wrangler versions upload |
Nahraje pouze kód Workeru. Nepublikuje nový obraz ani nespouští rollout instancí kontejnerů. |
Produkce
-
V Cloudflare dashboardu přejděte na Workers & Pages, otevřete Worker, který chcete nasadit, a poté přejděte na Nastavení > Builds.
Přejděte na Workers & Pages ↗ -
Nastavte Příkaz pro nasazení na
npx wrangler deploy, nebo do skriptu balíčku, který spouští úplné nasazení. -
Udržujte konfiguraci Wrangleru a Dockerfile nebo odkaz na obraz pod limitem Workers Builds kořenový adresář.
-
Odešlete do svého produkční větev.
-
Ověřte, že sestavení proběhlo úspěšně, a poté zkontrolujte nasazení.
Pro připojení repozitáře viz Workers Builds.
Před nasazením do produkce
wrangler deploypublikuje images kontejneru (je-li to potřeba) a nasazuje instance kontejnerů pro Worker, který nasazujete.wrangler versions upload(výchozí příkaz nasazení pro neprodukční větev ve Workers Builds) nahraje pouze novou verzi Workeru. Nepublikuje nový obraz ani nespouští rollout instancí kontejneru.- Preview URLs se negenerují pro Workers, které implementují Durable Objects, což zahrnuje i Containers Workers. Úspěšný neprodukční běh Workers Builds i tak vytvoří verzi Workeru, ale nikoli náhledovou adresu URL celé aplikace.
| Cíl | Co dělat |
|---|---|
| Měňte Worker a kontejner společně na svém počítači | Lokální vývoj hodnotou wrangler dev |
| Sdílejte nasazené prostředí s vlastním image a instancemi kontejneru | A Prostředí Wrangleru nebo samostatný Worker, každý připojený k Workers Builds s úplným nasazovacím příkazem, jako například npx wrangler deploy --env staging. Viz Workers Builds a prostředí Wrangler. |
| Aktualizovat produkci | Sloučit do produkční větve (nebo spustit wrangler deploy lokálně) |
Zkontrolujte své nasazení
Po wrangler deploy nebo produkční nasazení přes Workers Builds:
-
V dashboardu ověřte, že je nové nasazení Workeru aktivní.
-
Odešlete požadavek, který musí dosáhnout kontejneru, a potvrďte, že se chová podle očekávání.
-
Volitelně spusťte
Přejděte na Containers ↗npx wrangler containers listanpx wrangler containers images list, nebo otevřete dashboard Containers:
Informace o postupných krocích, ochranných lhůtách a režimech rolloutu najdete v Rollouty.
Řešení potíží
| Problém | Co dělat |
|---|---|
| Neprodukční běh služby Workers Builds proběhne úspěšně, ale aplikaci nelze plně zobrazit v náhledu | Použijte lokální vývoj nebo staging Worker či prostředí s wrangler deploy. Viz Před nasazením do produkce. |
| Nasazení nebo běh Workers Builds proběhne úspěšně, ale instance kontejneru vypadají beze změny | Postupné nasazení možná stále probíhá, nebo příkaz kontejnery neaktualizoval (versions upload nebo --containers-rollout=none). Viz Rollouty. |
| Nasazení se nezdaří, protože chybí Docker | Vyžadováno pouze pokud image je cesta k Dockerfile. Spusťte Docker, použijte Workers Builds, nebo přepněte na image registru, nebo použijte --containers-rollout=none pro nasazení pouze Workeru. |
| První nasazení: Worker funguje, směrování do kontejneru vrací chybu | Počkejte několik minut na dokončení provisioningu a poté zkontrolujte logy. |