deploy_azure.sh — 将 TaskFlow 部署到 Azure 容器应用

8.5 示例：自动化完整的部署工作流

完整的部署工作流只需一条命令，就能将源代码转变为正在运行且可观测的服务。在实践中，这意味着将构建、测试、打包、发布、部署、健康检查和回滚等环节全部代码化。Claude Code 通过生成样板代码、推理各种边界情况，并使每个步骤保持简洁且可审计，从而强化了这一闭环。在本示例中，你将为 TaskFlow FastAPI 应用创建一个完整、可运行的工作流：本地构建与测试、容器打包、镜像仓库推送、带健康检查的远程部署，以及一条自动回滚路径。所有内容都是自包含的，可直接适配到你的技术栈中。

概念阐述

一个具备生产形态的自动化序列涉及五个关注点。第一，可重复性：相同的输入应产生相同的制品，因此你需要为镜像打上确定性的标签。第二，安全性：测试必须把关发布，部署必须先验证健康状态再正式上线。第三，可逆性：回滚应只需一条命令即可完成。第四，可观测性：健康探针和日志能够快速暴露问题。第五，清晰性：脚本应当简短而明确，以便 Claude 能够对其加以推理并提出改进建议。我们将使用一个 Makefile、一个 Dockerfile、几个小型 shell 脚本以及一个 GitHub Actions 工作流来编码实现这些关注点。Claude 的作用是保持各个部分之间的协调一致，并在你修改需求时提供恰到好处的解释或改进建议。

动手示例

在一个干净的文件夹中创建以下文件。这些文件数量虽少，但功能完整。

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