Skip to content

DEPLOYMENT.md

Latest commit

 

History

History
107 lines (81 loc) · 3.18 KB

DEPLOYMENT.md

File metadata and controls

107 lines (81 loc) · 3.18 KB

🚀 Инструкции по деплою

⚠️ ВАЖНО: Настройка безопасности

Перед деплоем обязательно замените все шаблонные значения на свои реальные данные!

🔐 Быстрая настройка

  1. Скопируйте файл с шаблонными настройками:

    cp env.example .env

  2. Отредактируйте .env файл с вашими данными:

    nano .env

  3. Обновите Makefile:

    REGISTRY_HOST = registry.your-domain.com
REGISTRY_USER = your-username
REGISTRY_PASSWORD = your-password

  4. Настройте DNS записи:

    • app.your-domain.com → IP вашего сервера
    • registry.your-domain.com → IP вашего сервера

  5. Настройте Docker Hub (опционально):

    DOCKERHUB_USER = your-dockerhub-username
DOCKERHUB_IMAGE = fastapi-test-app
  • Docker установлен локально
  • VPS с настроенной инфраструктурой:
    • Traefik (реверс-прокси)
    • Docker Registry
    • Watchtower (автообновление)
    • Let's Encrypt сертификаты

Быстрый старт

  1. Клонировать репозиторий:

    git clone https://github.com/your-username/vps-autodeploy-fastapi.git
cd vps-autodeploy-fastapi

  2. Настроить переменные в Makefile:

    REGISTRY_HOST = your-registry.com
REGISTRY_USER = your-username
REGISTRY_PASSWORD = your-password

  3. Собрать и отправить:

    make bp

  4. Проверить работу:

    • Registry: https://your-registry.com/v2/_catalog
    • Приложение: https://your-app.com

Демонстрация

Проект демонстрирует:

  • ✅ Полный цикл разработки
  • ✅ Production-ready инфраструктуру
  • ✅ Автоматический деплой
  • ✅ Версионирование
  • ✅ SSL сертификаты

🐳 Docker Hub интеграция

Публикация в Docker Hub:

# Локальная публикация
make hub-deploy

# Или через скрипт на сервере
ssh your-server
/root/dockerhub-manager.sh deploy

Преимущества Docker Hub:

  • 🌍 Публичный доступ - любой может скачать образ
  • 🔄 Автоматические сборки - интеграция с GitHub
  • 📊 Статистика скачиваний - мониторинг использования

Репозитории:

Полезные ссылки