← Cloudflare Workers / workers / vite-plugin / reference

Переход с wrangler dev

В большинстве случаев миграция с wrangler dev не представляет сложности, следуйте инструкциям в Начало работы. Можно выделить несколько ключевых отличий:

Входные и выходные конфигурационные файлы Worker

С плагином Cloudflare для Vite ваш Файл конфигурации Worker (например, wrangler.jsonc) это входная конфигурация, и в рамках сборки создаётся отдельная выходная конфигурация. Этот выходной файл представляет собой снимок вашей конфигурации на момент сборки и изменяется так, чтобы ссылаться на артефакты сборки. Именно эта конфигурация используется для предпросмотра и деплоя. После того как вы выполнили vite build, выполняя wrangler deploy или vite preview автоматически найдёт этот файл конфигурации вывода.

Cloudflare Environments

С плагином Cloudflare для Vite Cloudflare Environments применяются во время разработки и сборки. Запуск wrangler deploy --env some-env поэтому неприменим, и окружение для развёртывания следует вместо этого задавать, выполнив CLOUDFLARE_ENV=some-env vite build.

Избыточные поля в файле конфигурации Wrangler

Различные параметры доступны в Файл конфигурации Worker которые игнорируются при использовании Vite, поскольку они либо больше не применимы, либо заменены эквивалентами Vite. Если эти параметры указаны, в консоль будут выведены предупреждения с рекомендациями по дальнейшим действиям.

Не применимо

Следующие параметры, связанные со сборкой, обрабатываются Vite и неприменимы при использовании Cloudflare Vite plugin:

tsconfig
rules
build
no_bundle
find_additional_modules
base_dir
preserve_file_names

Не поддерживается

site : используйте Ресурсы Workers взамен.

Заменено эквивалентами Vite

Для следующих параметров есть эквиваленты в Vite, которые следует использовать вместо них:

Опция Wrangler	Эквивалент в Vite
`define`	`define` ↗
`alias`	`resolve.alias` ↗
`minify`	`build.minify` ↗
Настройки локальной разработки (`ip`, `port`, `local_protocol`, и т. д.)	Параметры сервера ↗

См. Окружения Vite с дополнительной информацией о настройке окружений Worker в Vite.

Выведено

Если build.sourcemap ↗ включен для конкретного окружения Worker в конфигурации Vite, "upload_source_maps": true автоматически добавляется в итоговый файл конфигурации Wrangler. Это означает, что сгенерированные sourcemaps по умолчанию загружаются. Чтобы переопределить эту настройку, можно задать значение upload_source_maps явно во входной конфигурации Worker.