INTEGRITY Документация

RedwoodSDK

В этом руководстве вы создадите новый RedwoodSDK приложение и разверните его в Cloudflare Workers.

RedwoodSDK представляет собой фреймворк для создания серверных веб-приложений на Cloudflare. Это плагин для Vite, который предоставляет SSR, React Server Components, Server Functions и возможности работы в реальном времени.

Развертывание нового приложения RedwoodSDK на Workers

  1. Создайте новый проект.

    Выполните следующую команду, заменив my-project-name желаемым именем проекта:

    npx create-rwsdk my-project-name
  2. Измените каталог.

    cd my-project-name
  3. Установите зависимости.

    npm install
  4. Локальная разработка.

    Выполните следующую команду в каталоге проекта, чтобы запустить локальный сервер разработки. RedwoodSDK представляет собой плагин Vite, поэтому вы можете использовать тот же процесс разработки, что и в любом другом проекте на Vite:

    npm run dev

    Доступ к серверу разработки в браузере по адресу http://localhost:5173, где на странице должно отображаться "Hello, World!".

  5. Добавьте свой первый маршрут.

    Точка входа вашего приложения: src/worker.tsx. Откройте этот файл в редакторе.

    Вы увидите defineApp функция, которая обрабатывает запросы, возвращая ответы клиенту:

    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!"))]),
    ]);

    Добавьте /ping обработчик маршрута:

    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>;
        }),
      ]),
    ]);

    Перейдите в http://localhost:5173/ping чтобы увидеть на странице надпись "Pong!".

    Маршруты могут возвращать JSX напрямую. RedwoodSDK поддерживает React Server Components, которые рендерят JSX на сервере и отправляют HTML клиенту.

  6. Разверните ваш проект.

    Проект можно развернуть в *.workers.dev поддомен или Custom Domain, как с локального компьютера, так и из любой системы CI/CD, включая Cloudflare Workers CI/CD.

    Используйте следующую команду для сборки и развёртывания. Если вы используете CI, обязательно обновите команда deploy конфигурацию соответствующим образом.

    npm run release

    При первом запуске команды она может завершиться ошибкой и предложить вам создать поддомен workers.dev. Перейдите в Dashboard и откройте меню Workers. При первом открытии стартовой страницы Workers поддомен workers.dev будет создан автоматически.