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.html je i /about/ a soubor _redirects nastavuje 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:

bash
npm run build
futrou statico deploy --include ./dist

První 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:

yaml
# 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: false
bash
futrou deploy

V 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.

bash
futrou statico deploy --include ./dist --fallback-file /index.html --fallback-status 200

Nebo ve futrou.yml:

yaml
statico:
  app:
    include:
      ./dist: true
    fallbackFile: /index.html
    fallbackStatus: 200

Zá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:

VolbaVýznam
--include ./distSoubory z ./dist v kořeni.
--include ./dist:docsTytéž soubory pod docs/.
--include ./robots.txt:seo/robots.txtJeden 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:

text
/old-page   /new-page   301
/blog/*     /news/:splat

Stav 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.

SouboryCache-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:

https://github.com/futrou/futrou-templates

Naposledy upraveno

futrou.czfutrou.defutrou.cloudfutrou.linkfutrou.eu

hosting statických webů, statické weby, hosting Astro Starlight, hosting statického exportu Next.js, hosting Docusaurus, hosting statické dokumentace, hosting single page aplikací, hosting SPA, Futrou, cloud hosting, spravovaný cloud, nasazení aplikací