容器与云原生 / 系统课时

容器化后端应用

容器化后端应用

本课使用一个最小 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,容器停止后会自动删除。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

容器化后端应用

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通