deploy_azure.sh — deploy TaskFlow to Azure Container Apps

8.5 Example: Automating a Full Deployment Workflow

A full deployment workflow turns source code into a running, observable service with one command. In practice, that means codifying build, test, package, release, deploy, health check, and rollback. Claude Code strengthens this loop by generating the boilerplate, reasoning about edge cases, and keeping each step minimal and auditable. In this example you will create a complete, runnable workflow for the TaskFlow FastAPI app: local build and tests, container packaging, registry push, remote deploy with health checks, and an automatic rollback path. Everything is self-contained and ready to adapt to your stack.

Concept Development

A production-shaped automation sequence has five concerns. First, repeatability: the same inputs produce the same artifact, so you tag images deterministically. Second, safety: tests must gate releases and deployments must verify health before going live. Third, reversibility: rollbacks should be one command away. Fourth, observability: health probes and logs surface problems quickly. Fifth, clarity: scripts should be short and explicit so Claude can reason about them and suggest improvements. We will encode these concerns with a Makefile, a Dockerfile, a few small shell scripts, and a GitHub Actions workflow. Claude’s role is to keep the pieces aligned and provide just-in-time explanations or refinements when you change requirements.

Hands-On Example

Create the following files in a clean folder. The set is intentionally small but complete.

requirements.txt

fastapi==0.114.0

uvicorn==0.30.5

app.py

from typing import List, Optional, Dict

from fastapi import FastAPI, HTTPException

from pydantic import BaseModel, Field

from datetime import date

app = FastAPI(title="TaskFlow", version="1.0.0")

class TaskCreate(BaseModel):

    title: str = Field(min_length=1)

    description: Optional[str] = ""

    completed: bool = False

    due_date: Optional[date] = None

class Task(TaskCreate):

    id: int

_tasks: Dict[int, Task] = {}

_next_id = 1

@app.get("/health")

def health():

    return {"status": "ok", "service": "taskflow"}

@app.post("/tasks", response_model=Task, status_code=201)

def create_task(payload: TaskCreate) -> Task:

    global _next_id

    task = Task(id=_next_id, payload.model_dump())

    _tasks[_next_id] = task

    _next_id += 1

    return task

@app.get("/tasks", response_model=List[Task])

def list_tasks() -> List[Task]:

    return list(_tasks.values())

@app.get("/tasks/{task_id}", response_model=Task)

def get_task(task_id: int) -> Task:

    task = _tasks.get(task_id)

    if not task:

        raise HTTPException(status_code=404, detail="not found")

    return task

Dockerfile

# Stage 1: build deps (cached)
FROM python:3.11-slim AS builder

ENV PYTHONDONTWRITEBYTECODE=1 PYTHONUNBUFFERED=1

WORKDIR /app

COPY requirements.txt .

RUN pip install --upgrade pip && pip install --prefix=/install --no-warn-script-location -r requirements.txt