← Cloudflare Workers / workers / framework-guides / web-apps
RedwoodSDK
В этом руководстве вы создадите новый RedwoodSDK ↗ приложение и разверните его в Cloudflare Workers.
RedwoodSDK представляет собой фреймворк для создания серверных веб-приложений на Cloudflare. Это плагин для Vite, который предоставляет SSR, React Server Components, Server Functions и возможности работы в реальном времени.
Развертывание нового приложения RedwoodSDK на Workers
-
Создайте новый проект.
Выполните следующую команду, заменив
my-project-nameжелаемым именем проекта:npx create-rwsdk my-project-name -
Измените каталог.
cd my-project-name -
Установите зависимости.
npm install -
Локальная разработка.
Выполните следующую команду в каталоге проекта, чтобы запустить локальный сервер разработки. RedwoodSDK представляет собой плагин Vite, поэтому вы можете использовать тот же процесс разработки, что и в любом другом проекте на Vite:
npm run devДоступ к серверу разработки в браузере по адресу
http://localhost:5173, где на странице должно отображаться "Hello, World!". -
Добавьте свой первый маршрут.
Точка входа вашего приложения:
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 клиенту.
-
Разверните ваш проект.
Проект можно развернуть в
*.workers.devподдомен или Custom Domain, как с локального компьютера, так и из любой системы CI/CD, включая Cloudflare Workers CI/CD.Используйте следующую команду для сборки и развёртывания. Если вы используете CI, обязательно обновите команда deploy конфигурацию соответствующим образом.
npm run releaseПри первом запуске команды она может завершиться ошибкой и предложить вам создать поддомен workers.dev. Перейдите в Dashboard и откройте меню Workers. При первом открытии стартовой страницы Workers поддомен workers.dev будет создан автоматически.