← Cloudflare Pages / pages / get-started

Direct Upload

Direct Upload umožňuje nahrát předem sestavené soubory do Pages a nasadit je do globální sítě Cloudflare. Direct Upload byste měli zvolit místo Git integration, pokud chcete integrovat vlastní sestavovací platformu nebo je nahrajte z místního počítače.

Tento průvodce vás naučí, jak nahrát soubory pomocí Wrangler nebo metody přetažení.

Než nasadíte projekt pomocí Direct Upload, spusťte příslušný příkaz pro sestavení a sestavte svůj projekt.

Jakmile máte předsestavené assety připravené, nahrát je můžete dvěma způsoby:

• Wrangler.
• Přetažení.

Níže jsou podporované typy souborů pro jednotlivé možnosti Direct Upload:

• Wrangler: jedna složka s aktivy. (Soubory ZIP nejsou podporovány.)
• Přetažení: soubor zip nebo jedna složka se soubory.

Nejprve nainstalujte npm ↗. Poté nainstalujte Wrangler, CLI vývojářské platformy.

Přihlaste se do Wrangleru pomocí wrangler login příkaz. Poté spusťte pages project create příkaz:

npx wrangler pages project create

Poté budete vyzváni k zadání názvu projektu. Váš projekt bude dostupný na <PROJECT_NAME>.pages.dev (nebo název projektu doplněný o několik náhodných znaků, pokud je název už obsazený). Budete také vyzváni k zadání produkční větve.

Další nasazení budou tyto hodnoty opakovaně používat (uložené ve vašem node_modules/.cache/wrangler složky).

Nyní máte vytvořený prázdný projekt a můžete nasadit své soubory pro první i všechna další nasazení v produkčním prostředí. K tomu spusťte wrangler pages deploy příkaz:

npx wrangler pages deploy <BUILD_OUTPUT_DIRECTORY>

Vhodný výstupní adresář sestavení pro váš projekt najdete v Adresář sestavení v části Framework presets.

Vaše produkční nasazení bude dostupné na <PROJECT_NAME>.pages.dev.

Chcete-li nasadit assety do náhledového prostředí, spusťte:

npx wrangler pages deploy <OUTPUT_DIRECTORY> --branch=<BRANCH_NAME>

Pro každou vytvořenou větev budete mít k dispozici alias větve na adrese <BRANCH_NAME>.<PROJECT_NAME>.pages.dev.

Pokud chcete zjednodušit kroky vytvoření projektu a nasazení assetů, můžete také použít příkaz deploy, který vytvoří i nasadí assety najednou. Pokud tento příkaz spustíte jako první, budete přesto vyzváni k zadání názvu projektu a produkční větve. Tyto hodnoty se pro další nasazení uloží do mezipaměti, jak je uvedeno výše. Pokud mezipaměť již existuje a chcete vytvořit nový projekt, budete muset spustit create příkaz.

Pokud chcete pomocí Wrangleru získat seznam všech dostupných projektů pro Direct Upload, použijte pages project list:

npx wrangler pages project list

Chcete-li získat výstup ve formátu JSON pro programové zpracování nebo skriptování, použijte --json příznak:

npx wrangler pages project list --json

Pokud chcete pomocí Wrangleru získat seznam všech unikátních náhledových URL pro konkrétní projekt, použijte pages deployment list:

npx wrangler pages deployment list

Podrobný postup, jak používat Wrangler společně s nástroji pro kontinuální integraci, jako jsou GitHub Actions, Circle CI a Travis CI, pro kontinuální nasazování najdete v Použití Direct Upload s průběžnou integrací.

Chcete-li nasadit pomocí přetažení myší:

1. V dashboardu Cloudflare přejděte na Workers & Pages stránce.

   Přejděte na Workers & Pages ↗

2. Vyberte Vytvoření aplikace > Začínáme > Přetáhněte své soubory.

3. Zadejte název projektu do zobrazeného pole a přetáhněte do něj své soubory.

4. Vyberte Nasadit web.

Váš projekt bude dostupný z <PROJECT_NAME>.pages.dev. Poté přetáhněte adresář s výstupem sestavení do nahrávacího pole. Jakmile se soubory úspěšně nahrají, vyberte Save and Deploy a pokračujte na svůj nově nasazený projekt.

Jakmile máte projekt vytvořený, vyberte Vytvořte nové nasazení a zahajte novou verzi svého webu. Dále zvolte, zda nové nasazení proběhne do produkčního nebo náhledového prostředí. Pokud zvolíte náhledové, můžete vytvořit novou větev nasazení nebo zadat existující.

Pokud používáte metodu přetažení (drag and drop), u příliš velkého a tedy neúspěšně nahraného souboru se zobrazí červený varovný symbol. V takovém případě můžete tento soubor smazat, nelze ho ale nahradit. Abyste to mohli udělat, musíte znovu nahrát celý projekt.

Pokud je váš projekt Direct Upload projektu nebudete mít možnost nastavit ovládání produkční větve. Pro její aktualizaci budete muset ručně zavolat Update Project koncový bod v API.

curl --request PATCH \
"https://api.cloudflare.com/client/v4/accounts/{account_id}/pages/projects/{project_name}" \
--header "Authorization: Bearer <API_TOKEN>" \
--header "Content-Type: application/json" \
--data "{\"production_branch\": \"main\"}"

Nasazení metodou přetažení provedená z Cloudflare dashboard aktuálně nepodporují kompilaci functions složka Pages Functions. Chcete-li nasadit functions složka, musíte použít Wrangler. Při nasazování projektu pomocí Wrangleru platí, že pokud functions složka v místě, kde se příkaz spouští, functions složka se nahraje společně s projektem.

Mějte však na paměti, že _worker.js soubor je podporován jak u Wrangler, tak u nasazení metodou drag and drop z dashboardu.