Statico
Hosting statických webů (Astro Starlight, Next.js, Docusaurus, Vitepress, čisté HTML)
Úvod
Statico hostuje statické weby: složku s HTML, CSS, JavaScriptem a obrázky. Složku vyrobí váš build nástroj, jeden příkaz ji nasadí a web je online s TLS a adresou zdarma.
- Astro Starlight
- Export z Next.js
- Docusaurus
- VitePress
- Vite (React, Vue, Svelte)
- Čisté HTML
Vlastnosti
- Bez výpadku. Stará verze odpovídá, dokud není nová kompletní. Nasazení, které selže, nic nezmění.
- Rychlý upload. Posílají se jen změněné soubory, malé pohromadě v archivech.
- Hezké adresy a přesměrování.
about.htmlje i/about/a soubor_redirectsnastavuje přesměrování. - Veřejný, nebo privátní. Ve výchozím stavu veřejný. Privátní web vyžaduje API token.
Nasazení MPA
MPA (vícestránková aplikace) je výchozí: web se stránkou pro každou cestu, například Astro Starlight, Docusaurus, VitePress nebo export z Next.js. Nepotřebuje žádné další volby. Nasazuje se z CLI, takže to zapadne do jakékoli CI pipeline, příkazem nebo konfiguračním souborem.
Příkazem
Web sestavte a nasaďte složku:
npm run build
futrou statico deploy --include ./distPrvní spuštění web vytvoří a pojmenuje podle aktuální složky (nebo zadejte název). Další spuštění pošlou jen změny a když se nic nezměnilo, neudělají nic. Příkaz vypíše, kde je web živý.
./dist dá soubory složky do kořene webu. Přidejte --dry-run, abyste nejdřív viděli, co se změní.
Přes futrou.yml
Dejte web ke svému kódu. futrou deploy jednou spustí instalační příkaz, při každém spuštění build a výsledek nahraje:
# futrou.yml
workspace: acme
project: website
installCommand: npm ci # jednou na zařízení
buildCommand: npx astro build # před každým nasazením
statico:
docs:
include:
./dist: true
./dist/**/*.map: falsefutrou deployV CI použijte futrou deploy -y a secret FUTROU_API_TOKEN.
Nasazení SPA
SPA (single page aplikace) odpovídá na každou cestu souborem index.html a přebírá ji router v prohlížeči, jako aplikace v Reactu, Vue nebo Svelte sestavené Vite. Potřebuje dvě další volby: záložní soubor a jeho stav.
futrou statico deploy --include ./dist --fallback-file /index.html --fallback-status 200Nebo ve futrou.yml:
statico:
app:
include:
./dist: true
fallbackFile: /index.html
fallbackStatus: 200Záložní soubor se hledá po složkách, takže aplikace se složkou pro každý jazyk dostane vlastní index.html pro každý.
Výběr souborů
Include je soubor, složka nebo glob (*, **, {a,b}), relativně k místu spuštění, nebo absolutní cesta. Includy se spouští popořadě, takže můžete složku zahrnout a pak z ní něco vynechat:
| Volba | Význam |
|---|---|
--include ./dist | Soubory z ./dist v kořeni. |
--include ./dist:docs | Tytéž soubory pod docs/. |
--include ./robots.txt:seo/robots.txt | Jeden soubor, přesunutý. |
--exclude './dist/**/*.map' | Vynechá source mapy. |
Skryté soubory a složky (například .env a .git) a soubory .map se při nalezení ve složce nebo globem nikdy nenahrávají, takže tajemství nemůže odejít omylem. Chcete-li je zahrnout, uveďte je výslovně, třeba --include ./dist/.well-known. Váš konfigurační soubor se také nikdy nenahrává.
Přesměrování
Dejte do kořene webu soubor _redirects s jedním pravidlem na řádek:
/old-page /new-page 301
/blog/* /news/:splatStav je výchozně 302, :name odpovídá jednomu segmentu cesty a * zbytku (v cíli :splat). Vyhrává první odpovídající pravidlo.
Jak se soubory servírují
Pro každý požadavek Statico hledá přesný soubor, pak index.html složky, pak nejbližší 404.html (hledá se od požadované složky nahoru, takže fungují vícejazyčné weby). Přijímají se jen GET a HEAD.
| Soubory | Cache-Control |
|---|---|
Stránky (.html a cesty bez přípony) | no-cache |
| Assety (kód, obrázky, fonty, audio, video, dokumenty) | public, max-age=31536000, immutable |
| Vše ostatní | public, max-age=0, must-revalidate |
Dávejte assetům názvy s hashem (většina build nástrojů to dělá), aby nové nasazení mělo nové URL.
Vlastní domény
Každý web funguje na své adrese statico-xxx.futrou.cloud. Pro vlastní doménu vytvořte ve stejném projektu HTTP proxy s webem jako cílem. Viz Proxy.
Limity
Velikost webu, počet souborů a další limity najdete na stránce Limity.
Šablony
Hotové projekty s futrou.yml najdete v repozitáři se šablonami:
Naposledy upraveno
