Переменные окружения, volume, сети
Переменные окружения, volume, сети
Если у тебя конфиги захардкожены - Docker тебя накажет. Один раз. Потом ты исправишь.
env
DATABASE_URL=postgres://...
JWT_SECRET=super-secret
volumes
Volume нужен, чтобы данные жили дольше контейнера.
volumes:
- dbdata:/var/lib/postgresql/data
networks (обычно по умолчанию)
Compose создаёт сеть сам. Но можно явно, если нужно разделить.
⚠️ Секреты в репозитории - запрет
Не коммить
.envв Git. Используй переменные CI/CD или секреты на сервере. Как настроить.gitignoreи что делать, если секрет всё-таки уехал в историю - в уроке про git ignore и секреты.
Named volumes vs bind mounts
services:
db:
volumes:
- dbdata:/var/lib/postgresql/data # named volume (Docker управляет)
- ./init.sql:/docker-entrypoint-initdb.d/init.sql # bind mount (твой файл)
volumes:
dbdata: {}
- Named volume - данные живут внутри Docker, переживают
docker compose down - Bind mount - монтируешь файл/каталог с хоста. Удобно для конфигов и dev-режима
ℹ️ Dev-режим с bind mount
В разработке монтируй исходники:
- ./backend:/app. Код меняется на хосте - виден в контейнере. Для Go нужен live-reload (air), для Python - встроенный reload сервера (uvicorn --reload,flask --debug), а PHP-FPM подхватывает изменённые файлы сам, если в opcache не выключенvalidate_timestamps.
.env vs env_file vs Docker secrets
Три способа передать значения в контейнер - у каждого своя ниша:
Подход Где живёт Когда выбирать
──────────── ───────────────── ──────────────────────────────────
.env (compose) рядом с compose.yaml dev/local; compose сам подхватит
env_file указанный путь staging/prod; разные файлы под
окружения (.env.staging, .env.prod)
Docker secrets docker swarm/k8s secret прод-секреты (пароли БД, JWT_KEY)
монтируются как файл - не светятся в `docker inspect`
services:
backend:
env_file: .env.staging # переменные из файла
environment:
- LOG_LEVEL=debug # переопределяем точечно
secrets:
- db_password # монтируется в /run/secrets/db_password
secrets:
db_password:
file: ./secrets/db_pass.txt
⚠️
environmentсветит секреты вdocker inspectЛюбая переменная из
environmentили.envвидна черезdocker inspect <container>и в логах процесса. Для реальных секретов (БД, JWT, API ключи) в проде используй Docker secrets / Kubernetes secrets / Vault - они монтируются файлом, а не переменной.
Volumes: ловушки с правами на файлы
# Контейнер пишет от root (UID=0):
docker run -v $(pwd)/data:/app/data myapp
ls -la data/
# -rw-r--r-- 1 root root file.log ← на хосте теперь файл от root
Это классическая боль bind mount: процесс в контейнере запускается от root, и файлы на хосте получают владельца root. Локально мешает (sudo rm), в CI ломает следующие шаги.
# Решение: запускать процесс от обычного пользователя
RUN addgroup -g 1000 app && adduser -D -u 1000 -G app app
USER app
Либо в compose: user: "1000:1000". Совпадение UID хоста и контейнера = одинаковые права.
Bind mount поверх named volume = «пустая» БД
services:
db:
volumes:
- dbdata:/var/lib/postgresql/data
- ./fresh-init:/var/lib/postgresql/data # ← тот же путь в контейнере!
В одном файле Docker такое просто не запустит: контейнер не создастся с ошибкой Duplicate mount point: /var/lib/postgresql/data. Коварнее, когда второй mount на тот же путь приезжает из override-файла: compose сливает volumes по пути в контейнере, и bind mount молча заменит named volume. Данные в dbdata останутся, но контейнер их не увидит. Симптом: «БД стартует пустой, хотя volume есть». Проверка - docker compose config и docker compose exec db ls /var/lib/postgresql/data.
Бэкап тома
Docker сам тома не бэкапит. Универсальный приём - временный контейнер, который монтирует том и каталог хоста и упаковывает данные в архив:
# имя тома смотри в docker volume ls: compose добавляет префикс проекта (myproject_dbdata)
docker run --rm -v myproject_dbdata:/data -v "$(pwd)":/backup alpine \
tar czf /backup/dbdata.tgz -C /data .
Для работающей БД архив сырых файлов может выйти несогласованным, поэтому PostgreSQL бэкапят его собственным средством:
docker compose exec -T db pg_dump -U postgres app > backup.sql
Пользовательские сети
По умолчанию compose создаёт одну сеть. Но можно разделить:
services:
frontend:
networks:
- frontend-net
backend:
networks:
- frontend-net
- backend-net
db:
networks:
- backend-net
networks:
frontend-net: {}
backend-net: {}
Здесь frontend видит backend, но не видит db напрямую. Это изоляция: к базе ходит только backend. Можно усилить её флагом internal: true у backend-net - тогда у этой сети вообще нет выхода наружу. Одного отсутствия ports: у db мало: внутри общей сети к ней всё равно достучится любой контейнер.
Network modes: bridge / host / none / custom
Режим Изоляция Когда использовать
───── ───────── ──────────────────────────────────────────────
bridge полная дефолт; почти всегда правильный выбор
host нет высокая производительность сети (proxy, VPN,
мониторинг); порты контейнера = порты хоста
none полная контейнер без сети (изолированная обработка
данных, security sandboxing)
custom управляемая свой DNS, фиксированные подсети, multi-host
через overlay (swarm)
services:
proxy:
network_mode: host # nginx видит сетевой интерфейс хоста напрямую
sandbox:
network_mode: none # никакой сети - даже DNS нет
⚠️ host mode ломает портовый мэппинг
В
network_mode: hostдирективаports:игнорируется - контейнер слушает порты хоста как обычный процесс. Конфликт двух сервисов на одном порту = краш. На macOS/Windowshostработает иначе из-за VM (Docker Desktop) - реально host только на Linux.
DNS в Docker network
Docker встроил собственный DNS на адресе 127.0.0.11. В кастомной сети сервисы резолвят друг друга по имени сервиса из compose. Поэтому для compose-проекта не нужен внешний service discovery (системы вроде Consul или etcd, где сервисы регистрируют свои адреса): строка подключения просто postgres://db:5432/mydb.
// Из контейнера backend в той же сети:
db, _ := sql.Open("postgres", "host=db port=5432 user=postgres ...")
// ^^ имя сервиса из docker-compose.yml
В PHP то же самое - host берётся из имени сервиса compose. Через PDO:
<?php
declare(strict_types=1);
// Подключение к Postgres внутри той же docker network
$pdo = new PDO(
'pgsql:host=db;port=5432;dbname=app',
// ^^ имя сервиса из docker-compose.yml
'postgres',
$_SERVER['POSTGRES_PASSWORD'] ?? '',
[
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
PDO::ATTR_EMULATE_PREPARES => false,
],
);
В Symfony связь конфигурируется через переменную окружения DATABASE_URL - DoctrineBundle сам распарсит host из URL. Без фреймворка в Doctrine DBAL 4 параметра url больше нет, DSN разбирают явно:
<?php
declare(strict_types=1);
use Doctrine\DBAL\DriverManager;
use Doctrine\DBAL\Tools\DsnParser;
// DATABASE_URL=postgresql://postgres:password@db:5432/app?serverVersion=16
$params = (new DsnParser(['postgresql' => 'pdo_pgsql']))->parse($_SERVER['DATABASE_URL']);
$conn = DriverManager::getConnection($params);
import os
import psycopg
# Подключение к Postgres внутри той же docker network
conn = psycopg.connect(
host="db", # имя сервиса из docker-compose.yml
port=5432,
dbname="app",
user="postgres",
password=os.environ.get("POSTGRES_PASSWORD", ""),
)
# В SQLAlchemy/Django связь задают переменной окружения DATABASE_URL -
# host внутри URL тот же: имя сервиса compose
# DATABASE_URL=postgresql://postgres:password@db:5432/app
# Проверка из контейнера:
docker compose exec backend nslookup db
# Server: 127.0.0.11
# Name: db
# Address: 172.18.0.3
Это работает только внутри той же docker network. Если frontend-net и backend-net разные - frontend не зарезолвит db.
Best practices
.dockerignoreобязателен - даже если думаешь, что не нужен. Без него.git,node_modules,__pycache__улетят в образ.- Секреты в Dockerfile через
ARGоставляют след - значение оседает в истории образа (docker history) и в метаданных сборки (кеш, provenance), даже multi-stage не спасает полностью. Для build-time секретов -RUN --mount=type=secretиdocker build --secret(BuildKit). .envвсегда в.gitignore+ храни рядом.env.exampleс пустыми значениями как документацию.- Volume для БД делается один раз и навсегда - переименование (
dbdata→pgdata) создаёт новый пустой volume. Симптом тот же: «БД пустая после рестарта». depends_on≠ «БД готова» - он ждёт только запуск контейнера, не его сервиса. Для надёжности -healthcheck+depends_on: condition: service_healthy(тема следующего урока).
Мини-задание
- Сделай
.env.exampleс перечнем переменных (POSTGRES_PASSWORD, JWT_SECRET) - Подключи env в compose через
env_file: .env - Добавь named volume для данных PostgreSQL
- Проверь, что данные сохраняются после
docker compose downиdocker compose up - Проверь, что данные НЕ сохраняются после
docker compose down -v
Итог
.env- для локальной конфигурации и подстановки в compose-файл, не для секретов в проде: любая переменная изenvironmentвидна черезdocker inspect. Для реальных секретов - Docker secrets, Kubernetes secrets или Vault (см. врезку выше в этом уроке). Никогда не коммить.env.- Named volumes хранят данные между перезапусками. Bind mounts - для разработки.
- Сети изолируют сервисы: frontend не должен иметь прямой доступ к БД.
Типичная ошибка
Хранить секреты в docker-compose.yml и коммитить его. Или забыть named volume для БД - и потерять все данные при docker compose down.
Мини-практика (10 минут)
- Создай
.envсPOSTGRES_PASSWORD=secret123. 2. Вdocker-compose.ymlподключи черезenv_file: .env. 3. Подними postgres, создай таблицу черезdocker compose exec db psql -U postgres -c "CREATE TABLE test (id serial);". 4. Выполниdocker compose downиdocker compose up -d. 5. Проверь, что таблица на месте:docker compose exec db psql -U postgres -c "\dt". 6. Выполниdocker compose down -vи повтори - таблицы нет.