容器与云原生 / 系统课时
容器化后端应用
容器化后端应用
本课使用一个最小 Flask 接口演示后端容器化:准备依赖文件、编写 Dockerfile、构建镜像并启动容器。完成后,你可以通过宿主机端口访问健康检查接口,并确认应用在没有本地 Python 环境的机器上也能一致运行。
学习目标
- 编写分层清晰、可缓存依赖的后端 Dockerfile
- 构建并启动后端镜像
- 通过 HTTP 请求验证容器内应用
准备最小后端服务
在 backend 目录创建依赖文件。示例同时安装 MySQL 驱动,为后续 Compose 接入数据库做好准备。
text
Flask==3.0.3
mysql-connector-python==9.0.0将其保存为 backend/requirements.txt。依赖文件变化时,Docker 才需要重新执行安装层;只修改应用代码时,可以复用已有依赖缓存。创建 backend/app.py:
python
import os
import mysql.connector
from flask import Flask, jsonify
app = Flask(__name__)
app.json.sort_keys = False
@app.get("/api/health")
def health():
db_host = os.getenv("DB_HOST")
if not db_host:
return jsonify(
status="ok",
service="backend",
database="not-configured",
)
try:
connection = mysql.connector.connect(
host=db_host,
port=int(os.getenv("DB_PORT", "3306")),
user=os.environ["DB_USER"],
password=os.environ["DB_PASSWORD"],
database=os.environ["DB_NAME"],
connection_timeout=2,
)
cursor = connection.cursor()
cursor.execute("SELECT 1")
cursor.fetchone()
cursor.close()
connection.close()
return jsonify(status="ok", service="backend", database="up")
except mysql.connector.Error:
return jsonify(
status="degraded",
service="backend",
database="down",
), 503
if __name__ == "__main__":
app.run(host="0.0.0.0", port=8000)应用未配置数据库时仍能独立启动;配置了数据库环境变量后,健康接口会执行一次真实连接检查。
编写 Dockerfile
创建 backend/Dockerfile:
dockerfile
FROM python:3.12-slim
ENV PYTHONDONTWRITEBYTECODE=1 \
PYTHONUNBUFFERED=1
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY app.py .
RUN useradd --create-home appuser
USER appuser
EXPOSE 8000
CMD ["python", "app.py"]先复制依赖文件再复制源码,可以提高构建缓存命中率。USER appuser 避免应用长期以 root 身份运行,EXPOSE 只声明容器端口,不会自动发布到宿主机。
再创建 backend/.dockerignore:
text
__pycache__/
*.pyc
.venv/
.git/该文件会减少发送给 Docker 构建器的上下文内容,验证方法是构建日志中不再包含这些目录。
构建并启动镜像
在项目根目录执行:
bash
docker build -t demo-backend:1.0 ./backend预期输出中的耗时会因机器不同而变化:
text
[+] Building FINISHED
=> naming to docker.io/library/demo-backend:1.0启动容器并把宿主机 8000 端口映射到容器 8000 端口:
bash
docker run --rm -d \
--name demo-backend \
-p 8000:8000 \
demo-backend:1.0预期输出:
text
<ID><ID> 是本次创建的容器 ID,实际值每次都不同。
验证接口与日志
请求健康检查接口:
bash
curl -s http://localhost:8000/api/health预期输出:
json
{"status":"ok","service":"backend","database":"not-configured"}查看应用日志:
bash
docker logs demo-backend预期结果包含:
text
* Running on all addresses (0.0.0.0)
* Running on http://127.0.0.1:8000日志中的具体提示格式可能随 Flask 版本略有变化,但必须能看到服务监听 8000 端口。完成验证后停止容器:
bash
docker stop demo-backend预期输出:
text
demo-backend由于启动时使用了 --rm,容器停止后会自动删除。
按自己的节奏,确认真正理解。