Astro

1. Создайте новый проект с помощью create-cloudflare CLI (C3).

   npmyarnpnpm

   npm create cloudflare@latest -- my-astro-app --framework=astro

   Что происходит за кулисами?

   Когда вы выполняете эту команду, C3 создаёт каталог нового проекта, инициализирует Официальный инструмент настройки Astro ↗, и настраивает проект для Cloudflare. Затем предлагается возможность мгновенно развернуть ваше приложение в Cloudflare.

2. Локальная разработка.

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

   npmyarnpnpm

   npm run dev

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

   Проект можно развернуть в *.workers.dev поддомен или пользовательский домен с локального компьютера или из любой системы CI/CD (включая Workers Builds). Используйте следующую команду для сборки и развёртывания. Если вы используете CI-сервис, обязательно обновите соответствующим образом свою команду "deploy command".

   npmyarnpnpm

   npm run deploy

1. Добавление файла конфигурации Wrangler

   В корне проекта создайте файл конфигурации Wrangler со следующим содержимым:

   {
   	"name": "my-astro-app",
   	// Set this to today's date
   	"compatibility_date": "2026-08-28",
   	"assets": {
   		"directory": "./dist"
   	}
   }

   name = "my-astro-app"
   # Set this to today's date
   compatibility_date = "2026-08-28"
   
   [assets]
   directory = "./dist"

   Что делает эта конфигурация?

   Ключевой частью этой конфигурации является assets поле, которое указывает Wrangler, где искать статические ресурсы. В этом случае мы указываем Wrangler искать в ./dist каталог. Если ваши ресурсы находятся в другом каталоге, обновите directory значение соответствующим образом. Подробнее о других параметры конфигурации ресурсов.

   Также обратите внимание, что здесь нет main поле в этой конфигурации: это потому, что вы обслуживаете только статические ресурсы, поэтому код Worker для рендеринга по требованию или SSR не нужен.

2. Создайте и разверните свой проект

   Проект можно развернуть в *.workers.dev поддомен или пользовательский домен с локального компьютера или из любой системы CI/CD (включая Workers Builds). Используйте следующую команду для сборки и развёртывания. Если вы используете CI-сервис, обязательно обновите соответствующим образом свою команду "deploy command".

   npmyarnpnpm

   npx astro build

   npmyarnpnpm

   npx wrangler@latest deploy

1. Установка адаптера Astro для Cloudflare

   npmyarnpnpm

   npx astro add cloudflare

   Что происходит за кулисами?

   Эта команда устанавливает адаптер Cloudflare и вносит необходимые изменения в ваш astro.config.mjs файл за один шаг. По умолчанию это задает конфигурацию выходных данных сборки как output: 'server', который по умолчанию рендерит все ваши страницы на сервере. Если есть страницы, которые Нельзя нуждаются в рендеринге по требованию (SSR), например статические страницы вроде политики конфиденциальности, следует задать export const prerender = true для этой страницы или маршрута, чтобы предварительно рендерить её. Подробнее о параметрах конфигурации адаптера можно узнать в документации Astro ↗.

2. Добавьте .assetsignore файл Создайте .assetsignore файл в вашем public/ папку и добавьте в неё следующие строки:

   .assetsignore

   _worker.js
   _routes.json

3. Добавление файла конфигурации Wrangler

   В корне проекта создайте файл конфигурации Wrangler со следующим содержимым:

   {
   	"name": "my-astro-app",
   	"main": "./dist/_worker.js/index.js",
   	// Update to today's date
   	// Set this to today's date
   	"compatibility_date": "2026-08-28",
   	"compatibility_flags": ["nodejs_compat"],
   	"assets": {
   		"binding": "ASSETS",
   		"directory": "./dist"
   	},
   	"observability": {
   		"enabled": true
   	}
   }

   name = "my-astro-app"
   main = "./dist/_worker.js/index.js"
   # Set this to today's date
   compatibility_date = "2026-08-28"
   compatibility_flags = [ "nodejs_compat" ]
   
   [assets]
   binding = "ASSETS"
   directory = "./dist"
   
   [observability]
   enabled = true

   Что делает эта конфигурация?

   Ключевые части этой конфигурации:

   • main указывает на точку входа скрипта Worker. Он создаётся адаптером Astro и обеспечивает работу страниц, отрисованных на сервере.
   • assets.directory сообщает Wrangler, где искать статические ресурсы. В данном случае мы указываем Wrangler искать в ./dist каталог. Если ваши ресурсы находятся в другом каталоге, обновите directory значение соответствующим образом.

   Подробнее о Параметры конфигурации Wrangler и параметры конфигурации ресурсов.

4. Создайте и разверните свой проект

   Проект можно развернуть в *.workers.dev поддомен или пользовательский домен с локального компьютера или из любой системы CI/CD (включая Workers Builds). Используйте следующую команду для сборки и развёртывания. Если вы используете CI-сервис, обязательно обновите соответствующим образом свою команду "deploy command".

   npmyarnpnpm

   npx astro build

   npmyarnpnpm

   npx wrangler@latest deploy

---
export const prerender = false;
const cart = await Astro.session?.get("cart");
---

<a href="/checkout">{cart?.length ?? 0} items</a>