Add FastAPI hello-world structure with Docker and DB health check

- app/main.py: root endpoint + /health that reports DB connectivity
- app/db.py: pymysql connection check from MYSQL_* env vars, logged at startup
- Dockerfile: python:3.12-slim, port 8720
- docker-compose.yml: mysql:8.2 with healthcheck, app waits for DB ready
- requirements.txt: fastapi, uvicorn, pymysql

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Martin Hohenberg
2026-06-18 19:21:55 +02:00
parent 71beb2d65d
commit f66af4c732
6 changed files with 98 additions and 0 deletions

0
app/__init__.py Normal file
View File

22
app/db.py Normal file
View File

@@ -0,0 +1,22 @@
import os
import pymysql
def _params() -> dict:
return {
"host": os.environ["MYSQL_HOST"],
"port": int(os.environ.get("MYSQL_PORT", 3306)),
"user": os.environ["MYSQL_USER"],
"password": os.environ["MYSQL_PASSWORD"],
"database": os.environ["MYSQL_DATABASE"],
"connect_timeout": 3,
}
def check_db() -> bool:
try:
conn = pymysql.connect(**_params())
conn.close()
return True
except Exception:
return False

34
app/main.py Normal file
View File

@@ -0,0 +1,34 @@
import logging
from contextlib import asynccontextmanager
from fastapi import FastAPI
from app.db import check_db
logger = logging.getLogger("pops")
@asynccontextmanager
async def lifespan(app: FastAPI):
if check_db():
logger.info("Database connection OK")
else:
logger.warning("Database unreachable — check MYSQL_* environment variables")
yield
app = FastAPI(title="POPS", lifespan=lifespan)
@app.get("/")
def root():
return {"message": "Hello from POPS"}
@app.get("/health")
def health():
db_ok = check_db()
return {
"status": "ok" if db_ok else "degraded",
"db": "connected" if db_ok else "unreachable",
}