# Dockerfile —— 每一行是一条「装箱指令」，从上往下执行
FROM python:3.11-slim          # 1) 底座：一个已装好 Python 3.11 的精简系统
WORKDIR /app                   # 2) 在箱子里建个 /app 文件夹当工作台
COPY requirements.txt .        # 3) 先只拷贝依赖清单（为了利用缓存，见下讲）
RUN pip install -r requirements.txt   # 4) 照清单装依赖（Day05 的 -r 还记得吗）
COPY . .                       # 5) 再把项目所有代码拷进箱子
EXPOSE 8000                    # 6) 声明：这个服务对外用 8000 端口
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]
                               # 7) 箱子启动时默认跑的命令（启动 FastAPI 服务）

# 1) 封箱：照当前目录的 Dockerfile 构建镜像，起名 my-agent，版本 v1
docker build -t my-agent:v1 .
#         └ -t 给镜像起名字:标签      └ . 表示「用当前目录的 Dockerfile」

# 2) 卸货运行：用镜像启动一个容器
docker run -p 8000:8000 my-agent:v1
#          └ -p 宿主机端口:容器端口  把箱内 8000 接到你电脑的 8000

# 现在浏览器打开 http://localhost:8000/docs 就能访问箱子里的 FastAPI 了！

# 常用查看命令：
docker images        # 看有哪些镜像（有哪些箱子模板）
docker ps            # 看正在运行的容器（哪些箱子在跑）
docker logs 容器ID   # 看某个容器的日志（对应 Day55 的可观测）
docker stop 容器ID   # 停掉一个容器

# main.py —— 一个最小 Agent 服务（复习 Day09 FastAPI）
import os
from fastapi import FastAPI
app = FastAPI()

API_KEY = os.environ.get("LLM_API_KEY")   # ✅ 从环境变量读，不写死在代码里

@app.get("/ask")
def ask(q: str):
    # 这里正常调你的 Agent；演示就直接回显
    return {"question": q, "answer": f"（用 key 尾号 …{str(API_KEY)[-4:]} 生成的回答）"}

@app.get("/health")     # 健康检查接口：K8s / 负载均衡靠它判断「箱子还活着吗」
def health():
    return {"status": "ok"}

# 构建 + 运行，运行时用 -e 把 key 作为环境变量注入（不进镜像）
docker build -t my-agent:v1 .
docker run -p 8000:8000 -e LLM_API_KEY="sk-你的密钥" my-agent:v1
#                        └ -e 名=值：运行时才把秘密塞进箱子

# 验证：另开一个终端
curl "http://localhost:8000/health"          # → {"status":"ok"}
curl "http://localhost:8000/ask?q=你好"        # → 看到回答

# docker-compose.yml（示意）：一次描述「Agent 服务 + Redis 缓存」两个箱子
# services:
#   agent:
#     build: .                    # 用当前目录 Dockerfile 构建
#     ports: ["8000:8000"]
#     environment: [LLM_API_KEY]  # 从外部传密钥
#   cache:
#     image: redis:7              # 直接用现成 Redis 镜像（给 Day56 的缓存用）

docker compose up      # 一句话把上面所有箱子一起起来，它们还能互相通信
docker compose down    # 一句话全部停掉并清理

✋ 动手 10 分钟：把一个最小服务打成镜像跑起来

建一个文件夹,放三个文件,然后 build + run:

# 1) main.py（3 行的 FastAPI）
# from fastapi import FastAPI
# app = FastAPI()
# @app.get("/health")
# def health(): return {"status": "ok"}

# 2) requirements.txt
# fastapi
# uvicorn

# 3) Dockerfile
# FROM python:3.11-slim
# WORKDIR /app
# COPY requirements.txt .
# RUN pip install -r requirements.txt
# COPY . .
# CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]

# 然后在该文件夹里执行：
docker build -t hello-agent:v1 .        # 封箱
docker run -p 8000:8000 hello-agent:v1  # 卸货运行
# 浏览器开 http://localhost:8000/health → 看到 {"status":"ok"} 就成功了！

还没装 Docker?去装 Docker Desktop(Mac/Windows 一键装,自带图形界面能看到你的镜像和容器)。装不了也没关系,把上面三个文件和命令读懂、能讲出每行在干嘛,就达标了。