INTEGRITY Dokumentace

RedwoodSDK

V tomto průvodci vytvoříte nový RedwoodSDK aplikaci a nasaďte ji na Cloudflare Workers.

RedwoodSDK je framework pro tvorbu serverových webových aplikací na Cloudflare. Jde o Vite plugin, který poskytuje SSR, React Server Components, Server Functions a možnosti práce v reálném čase.

Nasaďte novou aplikaci RedwoodSDK na Workers

  1. Vytvořte nový projekt.

    Spusťte následující příkaz, přičemž nahraďte my-project-name požadovaným názvem projektu:

    npx create-rwsdk my-project-name
  2. Změňte adresář.

    cd my-project-name
  3. Nainstalujte závislosti.

    npm install
  4. Vývoj lokálně.

    Spusťte v adresáři projektu následující příkaz, čímž spustíte místní vývojový server. RedwoodSDK je plugin pro Vite, takže můžete použít stejný vývojový postup jako u jakéhokoli jiného projektu Vite:

    npm run dev

    Vývojářský server otevřete v prohlížeči na adrese http://localhost:5173, kde byste na stránce měli vidět zobrazený text "Hello, World!".

  5. Přidejte svou první trasu.

    Vstupní bod vaší aplikace je src/worker.tsx. Otevřete tento soubor ve svém editoru.

    Uvidíte defineApp funkce, která zpracovává požadavky vracením odpovědí klientovi:

    import { defineApp } from "rwsdk/worker";
    import { route, render } from "rwsdk/router";
    
    import { Document } from "@/app/Document";
    import { Home } from "@/app/pages/Home";
    
    export default defineApp([
      render(Document, [route("/", () => new Response("Hello, World!"))]),
    ]);

    Přidejte /ping obslužnou rutinu trasy:

    import { defineApp } from "rwsdk/worker";
    import { route, render } from "rwsdk/router";
    
    export default defineApp([
      render(Document, [
        route("/", () => new Response("Hello, World!")),
        route("/ping", function () {
          return <h1>Pong!</h1>;
        }),
      ]),
    ]);

    Přejděte na http://localhost:5173/ping a zobrazí se vám na stránce "Pong!".

    Trasy mohou vracet JSX přímo. RedwoodSDK podporuje React Server Components, které vykreslují JSX na serveru a odesílají HTML klientovi.

  6. Nasaďte svůj projekt.

    Svůj projekt můžete nasadit do *.workers.dev subdoména nebo Custom Domain, ať už z místního počítače, nebo z libovolného systému CI/CD, včetně Cloudflare Workers CI/CD.

    K sestavení a nasazení použijte následující příkaz. Pokud používáte CI, nezapomeňte upravit své příkaz deploy konfiguraci odpovídajícím způsobem.

    npm run release

    Při prvním spuštění příkazu může dojít k chybě a výzvě k vytvoření subdomény workers.dev. Přejděte do dashboardu a otevřete nabídku Workers. Otevřením úvodní stránky Workers poprvé se subdoména workers.dev vytvoří automaticky.