feat: add Docker support with docker-compose and Prometheus integration

Author: milsman2

.dockerignore

@@ -0,0 +1,74 @@
+# ===============================
+# Python bytecode / caches
+# ===============================
+__pycache__/
+*.py[cod]
+*$py.class
+
+# ===============================
+# Virtual environments
+# ===============================
+.venv/
+venv/
+ENV/
+env/
+
+# ===============================
+# Test / coverage artifacts
+# ===============================
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+
+# ===============================
+# Build / packaging outputs
+# ===============================
+build/
+dist/
+*.egg-info/
+
+# ===============================
+# Editor / OS junk
+# ===============================
+.vscode/
+.idea/
+.DS_Store
+Thumbs.db
+
+# ===============================
+# Git / CI
+# ===============================
+.git/
+.gitignore
+.github/
+
+# ===============================
+# Logs
+# ===============================
+*.log
+
+# ===============================
+# Local tooling caches
+# ===============================
+.ruff_cache/
+.mypy_cache/
+.isort_cache/
+
+# ===============================
+# Node (just in case)
+# ===============================
+node_modules/
+
+# ===============================
+# Docker files you DON'T need inside image
+# ===============================
+docker-compose.yml
+
+# ===============================
+# IMPORTANT: DO NOT IGNORE THESE
+# ===============================
+# pyproject.toml
+# uv.lock
+# src/

Dockerfile

@@ -1,10 +1,7 @@
 FROM ghcr.io/astral-sh/uv:python3.13-bookworm-slim AS builder
 ENV UV_COMPILE_BYTECODE=1 UV_LINK_MODE=copy
-
 ENV UV_NO_DEV=1
-
 ENV UV_PYTHON_DOWNLOADS=0
-
 WORKDIR /app
 RUN --mount=type=cache,target=/root/.cache/uv \
     --mount=type=bind,source=uv.lock,target=uv.lock \
@@ -14,26 +11,15 @@ COPY . /app
 RUN --mount=type=cache,target=/root/.cache/uv \
     uv sync --locked
 
-FROM python:3.13-slim-bookworm
-
+FROM python:3.13-slim-bookworm AS runtime
 RUN apt-get update \
     && apt-get upgrade -y \
     && apt-get clean \
     && rm -rf /var/lib/apt/lists/*
-
 RUN groupadd --system --gid 999 nonroot \
- && useradd --system --gid 999 --uid 999 --create-home nonroot
-
-COPY --from=builder --chown=nonroot:nonroot /app /app
-
+    && useradd --system --gid 999 --uid 999 --create-home nonroot
+COPY --from=builder --chown=nonroot:nonroot /app/ /app
 ENV PATH="/app/.venv/bin:$PATH"
-
 USER nonroot
-
-WORKDIR /app
-
-USER nonroot
-
-WORKDIR /app
-
-CMD ["python", "-m","sample_python_app.main"]
+WORKDIR /app/src
+CMD ["python", "-m", "sample_python_app.main"]

docker-compose.yml

@@ -0,0 +1,31 @@
+services:
+  python-app:
+    build: .
+    container_name: python-app
+    ports:
+      - "8000:8000"
+    environment:
+      - PYTHONUNBUFFERED=1
+
+  prometheus:
+    image: prom/prometheus:latest
+    container_name: prometheus
+    ports:
+      - "9090:9090"
+    volumes:
+      - ./prometheus.yml:/etc/prometheus/prometheus.yml
+
+  grafana:
+    image: grafana/grafana:latest
+    container_name: grafana
+    ports:
+      - "3000:3000"
+    depends_on:
+      - prometheus
+    environment:
+      - GF_SECURITY_ADMIN_PASSWORD
+    volumes:
+      - grafana-data:/var/lib/grafana
+
+volumes:
+  grafana-data:

prometheus.yml

@@ -0,0 +1,7 @@
+global:
+  scrape_interval: 15s
+
+scrape_configs:
+  - job_name: "python-app"
+    static_configs:
+      - targets: ["python-app:8000"]

src/sample_python_app/__init__.py

@@ -1,5 +1 @@
 """Sample Python app package initialization."""
-
-from sample_python_app.main import run_app
-
-__all__ = ["run_app"]

src/sample_python_app/core/config.py

@@ -4,6 +4,7 @@
 
 from pydantic_extra_types.coordinate import Coordinate, Latitude, Longitude
 from pydantic_settings import BaseSettings, SettingsConfigDict
+from pydantic import SecretStr
 
 
 class WeatherSettings(BaseSettings):
@@ -26,6 +27,7 @@ class Settings(BaseSettings):
     DATE_FORMAT: str = "%Y-%m-%d %I:%M:%S %p %Z"
     TIMEZONE: str = "America/Chicago"
     PROMETHEUS_METRICS_PORT: int = 8000
+    GF_SECURITY_ADMIN_PASSWORD: SecretStr = SecretStr("admin")
 
     model_config = SettingsConfigDict(
         env_file=".env",