Docker Compose на VPS: деплой приложения за 10 минут

curl -fsSL https://get.docker.com | sh

# Запустить Docker и добавить в автозапуск
systemctl enable --now docker

# Проверить версии
docker --version        # Docker version 26.x.x
docker compose version  # Docker Compose version v2.x.x

sudo usermod -aG docker $USER

# Применить изменения (перелогиниться или выполнить)
newgrp docker

# Проверить — должно работать без sudo
docker ps

mkdir -p ~/myapp && cd ~/myapp

# Версия схемы — опциональна в Compose v2, но помогает IDE
version: "3.9"

services:
  web:
    image: nginx:alpine          # Образ с Docker Hub
    container_name: myapp-nginx
    restart: unless-stopped      # Автоперезапуск (кроме явной остановки)
    ports:
      - "8080:80"                # хост:контейнер
    volumes:
      - ./html:/usr/share/nginx/html:ro  # bind mount — только чтение

mkdir html
echo "<h1>Hello from Docker Compose!</h1>" > html/index.html

# Запустить в фоне (-d = detached)
docker compose up -d

# Проверить статус
docker compose ps

# Открыть в браузере или curl
curl http://localhost:8080

docker compose stop    # Остановить (контейнеры остаются)
docker compose start   # Запустить снова
docker compose down    # Остановить И удалить контейнеры (volumes сохраняются)
docker compose down -v # Удалить контейнеры И volumes

myapp/
├── docker-compose.yml
├── .env                  # секреты (в .gitignore!)
├── .env.example          # шаблон для команды (в git)
└── app/
    ├── Dockerfile
    └── ...               # исходный код

# База данных
POSTGRES_USER=appuser
POSTGRES_PASSWORD=ЗАМЕНИТЕ_НА_СЛОЖНЫЙ_ПАРОЛЬ
POSTGRES_DB=appdb

# Подключение приложения к БД
DATABASE_URL=postgresql://appuser:ЗАМЕНИТЕ_НА_СЛОЖНЫЙ_ПАРОЛЬ@postgres:5432/appdb

# Redis
REDIS_URL=redis://redis:6379/0

# Приложение
SECRET_KEY=СГЕНЕРИРУЙТЕ_openssl_rand_-hex_32
APP_ENV=production

version: "3.9"

services:
  # ──── База данных ────────────────────────────────────────
  postgres:
    image: postgres:16-alpine
    container_name: myapp-postgres
    restart: unless-stopped
    env_file: .env
    environment:
      POSTGRES_USER: ${POSTGRES_USER}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
      POSTGRES_DB: ${POSTGRES_DB}
    volumes:
      - postgres_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
      interval: 10s
      timeout: 5s
      retries: 5

  # ──── Кэш ────────────────────────────────────────────────
  redis:
    image: redis:7-alpine
    container_name: myapp-redis
    restart: unless-stopped
    volumes:
      - redis_data:/data

  # ──── Приложение ─────────────────────────────────────────
  app:
    build:
      context: ./app      # Dockerfile в директории app/
      dockerfile: Dockerfile
    container_name: myapp-app
    restart: unless-stopped
    env_file: .env
    ports:
      - "127.0.0.1:8000:8000"   # только localhost, Nginx снаружи
    depends_on:
      postgres:
        condition: service_healthy  # ждать готовности БД
      redis:
        condition: service_started

# ──── Именованные volumes (данные не удаляются при down) ───
volumes:
  postgres_data:
  redis_data:

cd ~/myapp

# Сборка образа и запуск всего стека
docker compose up -d --build

# Смотреть логи запуска
docker compose logs -f

# Проверить что все сервисы healthy
docker compose ps

apt install nginx certbot python3-certbot-nginx -y

server {
    listen 80;
    server_name example.com www.example.com;

    location / {
        proxy_pass         http://127.0.0.1:8000;
        proxy_http_version 1.1;

        proxy_set_header Host              $host;
        proxy_set_header X-Real-IP         $remote_addr;
        proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        # Для WebSocket (Next.js HMR, FastAPI WebSocket)
        proxy_set_header Upgrade    $http_upgrade;
        proxy_set_header Connection "upgrade";

        client_max_body_size 50M;
        proxy_read_timeout   300s;
    }
}

ln -s /etc/nginx/sites-available/myapp /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx

# SSL через Let's Encrypt
certbot --nginx -d example.com -d www.example.com

cd ~/myapp

# 1. Получить новый код
git pull

# 2. Пересобрать образ и перезапустить ТОЛЬКО сервис app
#    --no-deps — не трогать postgres и redis
docker compose up -d --build --no-deps app

# 3. Убедиться, что всё работает
docker compose ps
docker compose logs -f app --tail 50

# Скачать обновлённые образы
docker compose pull postgres redis

# Пересоздать только обновлённые сервисы
docker compose up -d --no-deps postgres redis

# Создать дамп (замените appuser/appdb на значения из .env)
# docker compose exec читает переменные из .env — docker exec не читает
docker compose exec postgres pg_dump -U appuser appdb \
  > backup-$(date +%Y%m%d-%H%M).sql

# Восстановить (если что-то пошло не так)
# -T — отключить псевдо-TTY, необходимо при передаче stdin через pipe
cat backup-YYYYMMDD-HHMM.sql | docker compose exec -T postgres \
  psql -U appuser appdb

# Вместо:
image: postgres:16-alpine
image: redis:7-alpine

# Фиксированные патч-версии:
image: postgres:16.4-alpine
image: redis:7.4-alpine

# Посмотреть все переменные окружения контейнера
docker compose exec app env

# Выполнить команду в контейнере без интерактивного режима
docker compose exec postgres psql -U appuser appdb

# Скопировать файл из контейнера на хост
docker compose cp app:/app/logs/error.log ./error.log

# Посмотреть реальное потребление ресурсов
docker stats --no-stream