← Cloudflare Workers / workers / local-development

Переменные окружения и секреты

Разместите секреты для использования при локальной разработке либо в .dev.vars файл или .env файл, в том же каталоге, что и файл конфигурации Wrangler.

Эти файлы должны быть отформатированы с помощью dotenv ↗ синтаксис. Например:

.dev.vars / .env

SECRET_KEY="value"
API_TOKEN="eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9"

Чтобы задать разные секреты для каждого окружения Cloudflare, создайте файлы с именами .dev.vars.<environment-name> или .env.<environment-name>.

Когда вы выбираете окружение Cloudflare в локальной разработке, соответствующий файл конкретного окружения загружается раньше общего .dev.vars (или .env) файл.

При использовании .dev.vars.<environment-name> файлов все секреты должны быть определены отдельно для каждого окружения. Если .dev.vars.<environment-name> существует, то будет загружен только он; .dev.vars файл не будет загружен.
В противоположность этому все соответствующие .env файлов, и их значения объединяются. Для каждой переменной используется значение из наиболее специфичного файла в следующем порядке приоритета:
- .env.<environment-name>.local (наиболее специфичный)
- .env.local
- .env.<environment-name>
- .env (наименее специфичный)

Управление обработкой `.env`

Вы можете управлять тем, как .env файлы загружаются при локальной разработке путём установки переменных окружения для процесса, запускающего инструменты.

Чтобы отключить загрузку local dev vars из .env файлы без указания .dev.vars файле задайте CLOUDFLARE_LOAD_DEV_VARS_FROM_DOT_ENV переменную окружения на "false".
Чтобы включить все переменные окружения, заданные в окружении процесса вашей системы, в качестве переменных локальной разработки, убедитесь, что отсутствует .dev.vars а затем задайте CLOUDFLARE_INCLUDE_PROCESS_ENV переменную окружения на "true". Это не требуется при использовании secrets свойство конфигурации, который загружается из process.env автоматически.

Базовая настройка

Далее описаны шаги по настройке переменных окружения для локальной разработки с помощью .dev.vars или .env файлы.

Создайте .dev.vars / .env файл в корне вашего проекта.

Добавьте пары ключ-значение:

.dev.vars/.env

API_HOST="localhost:3000"
DEBUG="true"
SECRET_TOKEN="my-local-secret-token"

Запустите ваш dev команда

Wrangler
npx wrangler dev
Плагин Vite
npx vite dev

Несколько локальных окружений

Чтобы смоделировать разные локальные окружения, можно указать файлы для конкретных окружений. Например, у вас может быть файл staging окружение, которому требуются настройки, отличные от вашего окружения разработки.

Создайте файл с именем .dev.vars.<environment-name>/.env.<environment-name>. Например, можно использовать .dev.vars.staging/.env.staging.
Добавьте пары ключ-значение:
.dev.vars.staging/.env.staging
```
API_HOST="staging.localhost:3000"
DEBUG="false"
SECRET_TOKEN="staging-token"
```
Укажите окружение при запуске dev команда:

Wrangler
npx wrangler dev --env staging
Плагин Vite
CLOUDFLARE_ENV=staging npx vite dev
- При использовании .dev.vars.staging, будут применены только значения из этого файла вместо .dev.vars.
- При использовании .env.staging, значения будут объединены с .env файлов, причём наиболее специфичный файл имеет приоритет.

Подробнее

Чтобы узнать, как настроить несколько сред в конфигурации Wrangler, ознакомьтесь с документацией.
Чтобы узнать, как использовать среды Wrangler и среды Vite вместе, ознакомьтесь с документацией по плагину Vite