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

← Cloudflare Pages / pages / framework-guides

Hono

Hono ↗ это маленький, простой и сверхбыстрый веб-фреймворк для Cloudflare Pages и Workers, Deno и Bun. Подробнее о создании Hono можно узнать у просмотр интервью с его создателем, Yusuke Wada ↗.

В этом руководстве вы создадите новое приложение Hono и развернете его с помощью Cloudflare Pages.

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

Используйте create-cloudflare ↗ CLI (C3) для создания нового проекта. C3 создаст каталог нового проекта, запустит официальный инструмент настройки Hono и предложит возможность мгновенного развертывания.

Чтобы использовать create-cloudflare чтобы создать новый проект Hono, выполните следующую команду:

npm create cloudflare@latest -- my-hono-app --framework=hono --platform=pages

В новом проекте Hono вы найдёте public/static директория для статических файлов и src/index.ts файл, который является точкой входа для серверного кода.

Запуск в локальной разработке

Разрабатывайте ваше приложение локально, выполнив:

npm run dev

Сгенерированное веб-приложение можно посмотреть по адресу http://localhost:8788.

Прежде чем продолжить

Все руководства по фреймворкам предполагают, что у вас уже есть базовое понимание Git ↗. Если вы новичок в Git, обратитесь к этому краткое руководство по Git ↗ о том, как настроить Git на локальном компьютере.

Если вы клонируете по SSH, необходимо сгенерировать ключи SSH ↗ на каждом компьютере, с которого вы отправляете или получаете данные из GitHub.

См. документация GitHub ↗ и Документация Git ↗, где это описано подробнее.

Создайте репозиторий GitHub

Создайте новый репозиторий GitHub, перейдя по адресу repo.new ↗. После создания нового репозитория перейдите в каталог только что созданного проекта, чтобы подготовить локальное приложение и отправить его в GitHub, выполнив в терминале следующие команды:

git init
git remote add origin https://github.com/<your-gh-username>/<repository-name>
git add .
git commit -m "Initial commit"
git branch -M main
git push -u origin main

Развернуть с помощью Cloudflare Pages

Развернуть через create-cloudflare CLI (C3)

Если вы используете create-cloudflare(C3) ↗ чтобы создать новый проект Hono: C3 установит все зависимости, необходимые проекту, и предложит развернуть его через CLI. Если вы согласитесь, сайт станет доступен в сети, и вы получите URL-адрес развертывания.

Развернуть через панель управления Cloudflare

Чтобы развернуть сайт в Pages:

  1. На панели управления Cloudflare перейдите к разделу Workers & Pages страницу.

    Перейдите в Workers & Pages ↗

  2. Выберите Создать приложение.

  3. Выберите Pages на вкладке.

  4. Выберите Импорт существующего репозитория Git.

  5. Выберите созданный вами новый репозиторий GitHub, а затем нажмите Начало настройки.

  6. В Настройка сборок и деплоев раздел и укажите следующую информацию:

Параметр конфигурации Значение
Продакшен-ветка main
Команда сборки npm run build
Директория сборки dist

После настройки сайта вы можете запустить первый деплой. Вы увидите, как Cloudflare Pages устанавливает my-hono-app, зависимостей вашего проекта и сборку сайта перед его развертыванием.

После деплоя сайта вы получите уникальный поддомен для своего проекта на *.pages.dev. Каждый раз, когда вы фиксируете новый код в своем сайте Hono, Cloudflare Pages автоматически пересоберет ваш проект и развернет его. Вы также получите доступ к развёртывания предпросмотра для новых pull request, чтобы вы могли увидеть, как изменения выглядят на сайте, прежде чем разворачивать их в продакшен.