Template for FastAPI + Docker + uv + direnv + Cloud Run

Author: treefrog00

fastapi-docker-cloudrun/.dockerignore

@@ -0,0 +1,2 @@
+.venv
+__pycache__

fastapi-docker-cloudrun/.envrc

@@ -0,0 +1,34 @@
+# this function is from https://github.com/direnv/direnv/issues/1338
+# maybe one day there will be a more official version
+
+layout_uv() {
+    if [[ -d "$UV_PROJECT_ENVIRONMENT" ]]; then
+        log_status "Existing project virtual environment \'$UV_PROJECT_ENVIRONMENT\'"
+    else
+        log_status "No project virtual environment exists."
+
+        if [[ ! -f "pyproject.toml" ]]; then  # No project in-place
+            log_status "Initializing a new Python project via \`uv init\`."
+            uv init --no-readme
+        else
+            log_status "Python project already initialized. Skipping \`uv init\`."
+        fi
+        [[ -f "hello.py" ]] && rm hello.py  # a file created by `uv init`
+
+        if [[ ! -z "$UV_PROJECT_ENVIRONMENT" ]]; then
+            log_status "Project virtual environment path set to : $UV_PROJECT_ENVIRONMENT"
+            uv venv "$UV_PROJECT_ENVIRONMENT"
+        else
+            uv venv
+            UV_PROJECT_ENVIRONMENT="$(pwd)/.venv"
+        fi
+    fi
+
+    PATH_add "$UV_PROJECT_ENVIRONMENT/bin"
+    export UV_ACTIVE=1  # or VENV_ACTIVE=1
+    export UV_PROJECT_ENVIRONMENT
+}
+
+export UV_PROJECT_ENVIRONMENT=.venv
+dotenv
+layout uv

fastapi-docker-cloudrun/.gitignore

@@ -0,0 +1,3 @@
+.venv
+__pycache__
+.env

fastapi-docker-cloudrun/.python-version

@@ -0,0 +1 @@
+3.11

fastapi-docker-cloudrun/Dockerfile

@@ -0,0 +1,13 @@
+FROM python:3.13.2-slim-bookworm
+COPY --from=ghcr.io/astral-sh/uv:0.6.8 /uv /uvx /bin/
+
+# StreamHandler in CPython already flushes after each emit/line, not entirely sure if this is really necessary
+ENV PYTHONUNBUFFERED=1
+ENV PORT=1234
+
+WORKDIR /app
+ADD . /app
+RUN uv sync --frozen
+
+# As an example here we're running the web service with one worker on uvicorn.
+CMD ["uv", "run", "uvicorn", "server:app", "--host", "0.0.0.0", "--port", "${PORT}", "--workers", "1", "--app-dir", "src"]

fastapi-docker-cloudrun/README.md

@@ -0,0 +1,54 @@
+FastAPI + Docker + uv + direnv + Cloud Run
+==========================================
+
+Local without docker:
+=====================
+
+install uv
+
+install direnv:
+
+https://github.com/direnv/direnv/blob/master/docs/installation.md
+
+add direnv hook:
+
+https://github.com/direnv/direnv/blob/master/docs/hook.md
+
+uvicorn server:app --host 0.0.0.0 --port 1234 --workers 1 --app-dir src
+
+Local with docker
+===================
+
+Create .env, and add:
+
+PROJECT_ID=<YOUR_UNIQUE_LOWER_CASE_PROJECT_ID>
+APP=<app name>
+PORT=1234
+TAG="gcr.io/$PROJECT_ID/$APP"
+REGION="europe-west1"
+
+Then:
+
+```
+export TAG="gcr.io/$PROJECT_ID/$APP"
+```
+
+docker build -t $TAG .
+docker run --rm -dp $PORT:$PORT -e PORT=$PORT $TAG
+
+Cloud run:
+==========
+
+Set up project, billing project etc (some hints at https://github.com/sekR4/FastAPI-on-Google-Cloud-Run)
+
+To build
+
+```
+gcloud builds submit --tag $TAG
+```
+
+To deploy:
+
+``
+gcloud run deploy $APP --image $TAG --platform managed --region $REGION
+```

fastapi-docker-cloudrun/pyproject.toml

@@ -0,0 +1,10 @@
+[project]
+name = "fastapi-docker-cloudrun"
+version = "0.1.0"
+description = "Add your description here"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+    "fastapi>=0.115.11",
+    "uvicorn>=0.34.0",
+]

fastapi-docker-cloudrun/src/server.py

@@ -0,0 +1,8 @@
+from fastapi import FastAPI
+
+app = FastAPI()
+
+
+@app.get("/")
+async def root():
+    return {"message": "Hello World"}