Najważniejsze komendy¶
make help jest źródłem prawdy — poniżej tematyczny przegląd najważniejszych targetów.
Wdrożenie¶
make run # Pełne wdrożenie (pull, build, configs, up)
make up # Start wszystkich usług (force recreate)
make up-quick # Szybki start bez recreation
make refresh # prune + pull + recreate (po update obrazu)
make wait # Czeka na build z GH Actions, potem make refresh
make stop # Zatrzymaj usługi
make restart-appserver # Restart serwera aplikacji
Baza danych¶
make migrate # Migracje Django (bezpiecznie zatrzymuje workery denorm)
make db-backup # Backup bazy (równoległy pg_dump, tar.gz)
make dbshell # Django database shell
make dbshell-psql # Bezpośredni psql
make upgrade-postgres # Upgrade major wersji PostgreSQL (np. 16.13 → 18.3)
Szczegóły: Baza danych, PostgreSQL.
Shell i konta¶
make shell # Shell w appserverze
make shell-python # Python shell (Django)
make shell-plus # shell_plus (django-extensions)
make shell-dbserver # Shell w kontenerze bazy
make shell-workerserver # Shell w workerze
make createsuperuser # Utwórz superusera Django
make changepassword # Zmień hasło użytkownika
Monitoring i logi¶
make health # Szybki healthcheck wszystkich usług
make ps # Lista kontenerów
make logs # Logi wszystkich usług
make logs-appserver # Logi serwera aplikacji
make logs-celery # Logi workerów Celery
make logs-dbserver # Logi bazy
make logs-denorm # Logi denormalizacji
make logs-netdata # Logi Netdaty (metryki + alerty)
make celery-stats # Statystyki zadań Celery
make celery-status # Status workerów
make ntfy-test # Wyślij testowy push na ntfy (alerty na telefon)
Szczegóły: Monitoring i logi.
Celery / denormalizacja¶
make celery-stats # Statystyki zadań
make denorm-rebuild # Pełna przebudowa denormalizacji
make denorm-purge-queues # Czyszczenie kolejek denorm
make denorm-flush # Flush denorm
Konfiguracja¶
make update-configs # Regeneruj datasources.yaml (envsubst)
make update-ssl-certs # Przeładuj nginx po zmianie certyfikatów
make init-configs # Uzupełnij brakujące pliki/zmienne (idempotentne)
make configure-resources # Dostrój limity RAM/CPU
make generate-snakeoil-certs # Wygeneruj samopodpisane certyfikaty SSL
make ssl-letsencrypt-issue # Wystaw cert Let's Encrypt (PROD=1 dla prawdziwego)
make ssl-letsencrypt-renew # Manualny renew certów LE
Szczegóły: SSL, Limity zasobów.
Backup¶
make db-backup # Pojedynczy pg_dump (równoległy, tar.gz)
make backup-cycle # Pełen cykl: pg_dump + tar mediów + rclone + powiadomienia
make rclone-config # Konfiguracja zdalnego backupu (Google Drive, S3, ...)
make rclone-sync # Wymuszona synchronizacja z chmurą
make rclone-check # Sprawdzenie spójności kopii zdalnej
Szczegóły: Backup i rclone.
Konserwacja¶
make docker-clean # Sprzątanie Dockera
make prune-orphan-volumes # Usuń osierocone wolumeny
make open-docker-volume # Otwórz wolumen do podglądu
make rmrf # Niebezpieczne, pyta o potwierdzenie
Wydanie i wersja¶
make release # Tag + push: YYYY.MM.DD lub YYYY.MM.DD.N (calendar versioning)
make version # Wyświetl bieżącą wersję
Szczegóły: Wydanie.