﻿---
title: Окружения
description: "Local, staging и production: назначение окружений, parity, конфигурация, секреты, тестовые данные и promotion изменений."
---

## Назначение окружений

Окружение — это полноценный набор приложения, зависимостей, конфигурации и данных, в котором выполняется определённая задача.

- **Local** — быстрая разработка и проверка на машине инженера.
- **Staging / pre-production** — проверка release candidate в условиях, приближенных к production.
- **Production** — обслуживание реальных пользователей и данных.

Дополнительные preview-окружения создаются для отдельных веток или pull request. Их смысл — ранняя проверка изолированного изменения, а не постоянный второй production.

## Parity без копирования всего

Окружения должны быть достаточно похожи, чтобы результат проверки был значимым. В первую очередь согласуют:

- версии runtime и критичных зависимостей;
- схему развёртывания и сетевые правила;
- механизм конфигурации и секретов;
- очередь, планировщик и фоновые workers;
- внешние интеграции или их контрактные заглушки;
- характеристики данных, влияющие на сценарий.

Полностью одинаковые мощность и объём данных обычно не нужны. Но staging без worker, другой СУБД или принципиально иная конфигурация кэша может оставить основной production-риск незамеченным.

## Конфигурация и секреты

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

Секреты не хранят в репозитории, образе или общем staging-файле. Для них используют менеджер секретов или защищённые переменные CI/CD с ограничением доступа и ротацией. Production-секреты недоступны preview-окружениям и не копируются в staging без необходимости.

## Данные для проверок

Production-дамп — не универсальное решение. Он может содержать персональные данные и создавать риск реальных писем, платежей или webhooks. Предпочтительны:

- синтетические фикстуры с нужными граничными случаями;
- обезличенные и минимизированные наборы;
- отдельные аккаунты внешних сервисов в test mode;
- запрет исходящих реальных операций для непроизводственных окружений.

## Promotion изменений

```text
Один артефакт → preview/staging → проверки → production
                    ↑
        конфигурация и секреты окружения
```

Готовность окружения означает не просто запущенный контейнер, а возможность выполнить целевой сценарий: зависимости доступны, миграции применены, health checks проходят, телеметрия поступает.

## Типовые ошибки

- Staging отличается архитектурой, поэтому «у нас работало» не является доказательством.
- В production попадает другой артефакт, а не проверенный на staging.
- Preview имеет доступ к production-данным или секретам.
- Staging отправляет реальные письма и вызывает боевые webhooks.
- Временные окружения не удаляются и становятся источником расходов и утечек.

## Связанные инструменты

- [Docker](https://wpcraft.ru/kb/infrastructure/tools/docker.md) — согласованный запуск приложения и зависимостей.
- [GitHub Actions](https://wpcraft.ru/kb/infrastructure/tools/github-actions.md) — environments, approvals и защищённые секреты.
- [GitLab CI/CD](https://wpcraft.ru/kb/infrastructure/tools/gitlab-ci.md) — environments и review apps.
- [Kubernetes](https://wpcraft.ru/kb/infrastructure/tools/kubernetes.md) — namespaces и декларативные рабочие нагрузки.

## Связанные материалы

- [CI/CD](https://wpcraft.ru/kb/infrastructure/devops/ci-cd.md) — продвижение артефакта и проверки.
- [Infrastructure as Code](https://wpcraft.ru/kb/infrastructure/iac.md) — воспроизводимое создание ресурсов окружения.
- [Локальная разработка](https://wpcraft.ru/kb/stacks/local-development.md) — локальный контур веб-проектов.

## Материалы и источники

- [DORA: Continuous delivery](https://dora.dev/capabilities/continuous-delivery/) — deployable state и выпуск по требованию.
- [DORA: Test data management](https://dora.dev/capabilities/test-data-management/) — безопасные и пригодные для проверок данные.
- [DORA: Flexible infrastructure](https://dora.dev/capabilities/flexible-infrastructure/) — воспроизводимость и управление окружениями.