DynaDock

Inteligentny orchestrator Docker Compose z automatyczną alokacją portów, TLS i lokalnymi subdomenami

Dlaczego DynaDock?

DynaDock rozwiązuje najczęstsze problemy przy pracy z Docker Compose:

Konflikty portów - automatycznie znajduje wolne porty
Certyfikaty SSL - automatyczne HTTPS przez Caddy
Lokalne domeny - każdy serwis dostępny pod własną subdomeną
Zero konfiguracji - działa od razu po instalacji
Health checks - automatyczne monitorowanie serwisów

Instalacja

Z PyPI (zalecane)

pip install dynadock

Z uv (najszybsze)

uv tool install dynadock

Ze źródeł

git clone https://github.com/dynapsys/dynadock.git
cd dynadock
make install

Szybki start

1. Podstawowe użycie

# W katalogu z docker-compose.yaml
dynadock up

# Twoje serwisy będą dostępne pod:
# http://api.dynadock.lan:8000
# http://web.dynadock.lan:8001
# http://redis.dynadock.lan:8002

2. Z HTTPS (zalecane)

dynadock up --enable-tls

# Serwisy dostępne pod:
# https://api.dynadock.lan
# https://web.dynadock.lan
# https://redis.dynadock.lan

3. Własna domena

dynadock up --domain myapp.local --enable-tls

# Serwisy dostępne pod:
# https://api.myapp.local
# https://web.myapp.local

Przykłady użycia

Aplikacja Node.js z MongoDB

# docker-compose.yaml
version: '3.8'
services:
  app:
    build: .
    environment:
      - NODE_ENV=development
  
  mongodb:
    image: mongo:6
    environment:
      - MONGO_INITDB_ROOT_USERNAME=admin
      - MONGO_INITDB_ROOT_PASSWORD=secret

dynadock up --enable-tls

# Dostępne pod:
# https://app.dynadock.lan - aplikacja Node.js
# https://mongodb.dynadock.lan - MongoDB (z auth)

Python FastAPI z PostgreSQL

# docker-compose.yaml
version: '3.8'
services:
  api:
    build: .
    command: uvicorn main:app --reload
    environment:
      - DATABASE_URL=postgresql://user:pass@postgres/db
  
  postgres:
    image: postgres:15
    environment:
      - POSTGRES_USER=user
      - POSTGRES_PASSWORD=pass
      - POSTGRES_DB=db

dynadock up --enable-tls --domain backend.dev

# Dostępne pod:
# https://api.backend.dev - FastAPI
# https://postgres.backend.dev - PostgreSQL

Mikroserwisy z Redis i RabbitMQ

# docker-compose.yaml
version: '3.8'
services:
  gateway:
    build: ./gateway
    depends_on:
      - auth-service
      - user-service
  
  auth-service:
    build: ./services/auth
    environment:
      - REDIS_URL=redis://redis:6379
  
  user-service:
    build: ./services/user
    environment:
      - RABBITMQ_URL=amqp://rabbitmq:5672
  
  redis:
    image: redis:7-alpine
  
  rabbitmq:
    image: rabbitmq:3-management

dynadock up --enable-tls --scale user-service=3

# Dostępne pod:
# https://gateway.dynadock.lan - API Gateway
# https://auth-service.dynadock.lan - Auth Service
# https://user-service.dynadock.lan - User Service (load balanced)
# https://redis.dynadock.lan - Redis
# https://rabbitmq.dynadock.lan - RabbitMQ Management

Funkcjonalności

🔧 Automatyczna konfiguracja

Alokacja portów: Znajduje wolne porty (8000-9999)
Generowanie .env: Tworzy .env.dynadock z wszystkimi zmiennymi
Certyfikaty SSL: Automatyczne HTTPS przez Caddy
Health checks: Monitorowanie stanu serwisów
CORS: Automatyczna konfiguracja dla API

🌐 Reverse Proxy (Caddy)

Load balancing: Dla skalowanych serwisów
WebSocket support: Automatyczne przekierowanie WS
Kompresja: Gzip/Brotli dla odpowiedzi
Cache: Inteligentne cache'owanie statycznych zasobów
Security headers: Automatyczne nagłówki bezpieczeństwa

🔍 Monitoring

Health checks: Sprawdzanie dostępności serwisów
Metryki: Prometheus-compatible metrics
Logi: Scentralizowane logowanie
Alerts: Powiadomienia o problemach

Komendy CLI

Podstawowe komendy

# Uruchomienie serwisów
dynadock up [OPTIONS]

# Zatrzymanie serwisów
dynadock down

# Status serwisów
dynadock ps

# Logi
dynadock logs [SERVICE]

# Wykonanie komendy w kontenerze
dynadock exec SERVICE COMMAND

# Health check
dynadock health

Opcje `dynadock up`

Opcja	Opis	Domyślnie
`--domain`	Domena bazowa	`dynadock.lan`
`--enable-tls`	Włącz HTTPS	`false`
`--port-range`	Zakres portów	`8000-9999`
`--scale SERVICE=N`	Skalowanie serwisu	`1`
`--cors-origins`	Dozwolone origins	`*`
`--no-caddy`	Wyłącz Caddy proxy	`false`
`--env-file`	Dodatkowy plik .env	-

Przykłady zaawansowane

# Produkcja z Let's Encrypt
dynadock up --domain app.com --enable-tls --email admin@app.com

# Development z custom ports
dynadock up --port-range 3000-4000 --enable-tls

# Skalowanie z load balancing
dynadock up --scale api=5 --scale worker=3

# Z custom CORS
dynadock up --cors-origins https://app.com,https://admin.app.com

Konfiguracja

Plik `.dynadock.yaml`

# .dynadock.yaml
domain: myapp.local
enable_tls: true
port_range: 8000-9999
services:
  api:
    scale: 3
    health_check: /health
    cors_origins:
      - https://app.myapp.local
  redis:
    expose_port: false
caddy:
  email: admin@example.com
  staging: false  # dla Let's Encrypt

Zmienne środowiskowe

DynaDock automatycznie generuje .env.dynadock:

# .env.dynadock (generowany automatycznie)
DYNADOCK_DOMAIN=myapp.local
DYNADOCK_PROTOCOL=https
DYNADOCK_API_PORT=8000
DYNADOCK_API_URL=https://api.myapp.local
DYNADOCK_WEB_PORT=8001
DYNADOCK_WEB_URL=https://web.myapp.local
DYNADOCK_REDIS_PORT=8002
DYNADOCK_REDIS_URL=redis://redis.myapp.local:8002

Przykładowe projekty

Repozytorium zawiera kompletne przykłady w katalogu examples/:

1. Simple Web App

cd examples/simple-web
dynadock up --enable-tls
# Otwórz: https://web.dynadock.lan

2. REST API z bazą danych

cd examples/rest-api
dynadock up --enable-tls
# API: https://api.dynadock.lan
# Docs: https://api.dynadock.lan/docs

3. Mikroserwisy

cd examples/microservices
dynadock up --enable-tls --scale worker=3
# Gateway: https://gateway.dynadock.lan
# Services: https://[service].dynadock.lan

4. Full-stack aplikacja

cd examples/fullstack
dynadock up --enable-tls
# Frontend: https://app.dynadock.lan
# Backend: https://api.dynadock.lan
# Admin: https://admin.dynadock.lan

Rozwiązywanie problemów

Port już zajęty

# Sprawdź zajęte porty
dynadock debug ports

# Użyj innego zakresu
dynadock up --port-range 9000-9999

Problemy z DNS

# Dodaj do /etc/hosts
echo "127.0.0.1 api.dynadock.lan web.dynadock.lan" | sudo tee -a /etc/hosts

# Lub użyj systemd-resolved (under development, check `dynadock --help` for availability)
dynadock setup-dns

Certyfikaty SSL

# Zaufaj certyfikatom Caddy (under development, check `dynadock --help` for availability)
dynadock trust-certs

# Lub wyłącz TLS w development
dynadock up --no-tls

Problemy z siecią Docker

# Reset sieci Docker (under development, check `dynadock --help` for availability)
dynadock network reset

# Lub użyj host network
dynadock up --network host

Rozwój

Wymagania

Python 3.8+
Docker 20.10+
Make (opcjonalne)
uv (zalecane)

Setup środowiska

# Klonuj repo
git clone https://github.com/dynapsys/dynadock.git
cd dynadock

# Instalacja dev dependencies
make dev

# Lub z uv
uv pip install -e ".[dev]"

Uruchamianie testów

# Wszystkie testy
make test

# Tylko unit tests
make test-unit

# Tylko integration tests
make test-integration

# Z coverage
make coverage

# W trybie watch
make test-watch

Budowanie dokumentacji

# Buduj dokumentację
make docs

# Serwuj lokalnie
make docs-serve
# Otwórz: http://localhost:8000

Linting i formatowanie

# Sprawdź kod
make lint

# Formatuj kod
make format

# Pre-commit checks
make pre-commit

Wkład

Zapraszamy do współtworzenia DynaDock! Zobacz nasz przewodnik dla kontrybutorów, aby dowiedzieć się więcej.

Jak pomóc?

🍴 Fork repozytorium
🌿 Stwórz branch (git checkout -b feature/amazing)
✨ Commituj zmiany (git commit -m 'Add amazing feature')
📤 Push do brancha (git push origin feature/amazing)
🎉 Otwórz Pull Request

Zgłaszanie błędów

Użyj GitHub Issues do zgłaszania błędów.

Autor

DynaDock jest rozwijany i utrzymywany przez zespół Dynapsys.

Licencja

MIT - zobacz LICENSE

Podziękowania

Caddy - za świetny reverse proxy
Docker - za konteneryzację
Click - za CLI framework
Rich - za piękne terminale

Stworzone z ❤️ przez Dynapsys

Name		Name	Last commit message	Last commit date
Latest commit History 106 Commits
.idea		.idea
certs		certs
diagnostics		diagnostics
docs		docs
examples		examples
scripts		scripts
src/dynadock		src/dynadock
templates		templates
tests		tests
.dockerignore		.dockerignore
.dynadock-compose.yaml		.dynadock-compose.yaml
.dynadock.yaml		.dynadock.yaml
.gitignore		.gitignore
.gitlab-ci.yml		.gitlab-ci.yml
.pytest-watch.ini		.pytest-watch.ini
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
Dockerfile		Dockerfile
Dockerfile.test		Dockerfile.test
LICENSE		LICENSE
Makefile		Makefile
README.md		README.md
REFACTORING_SUMMARY.md		REFACTORING_SUMMARY.md
TODO.md		TODO.md
deployment.yaml		deployment.yaml
docker-compose.yaml		docker-compose.yaml
dynadock-missing-files.md		dynadock-missing-files.md
dynadock-project.md		dynadock-project.md
dynadock-tests-docs.md		dynadock-tests-docs.md
dynadock_sudo.py		dynadock_sudo.py
health_check.py		health_check.py
pyproject.toml		pyproject.toml
run_tests.sh		run_tests.sh
test-compose.yaml		test-compose.yaml
test_cli.py		test_cli.py
test_domain_reality.py		test_domain_reality.py
test_domain_verification.sh		test_domain_verification.sh
test_dynadock_startup.py		test_dynadock_startup.py
test_framework_report.json		test_framework_report.json
test_report.json		test_report.json
test_runner.py		test_runner.py
uv.lock		uv.lock

License

dynapsys/dynadock

Folders and files

Latest commit

History

Repository files navigation