容器与云原生 / 系统课时

准备滚动发布实验应用

准备滚动发布实验应用

这一课准备一个可控的最小 HTTP 应用:它能返回版本号,分别暴露存活与就绪接口,并通过环境变量模拟响应变慢或实例未就绪。后续滚动升级实验只改变这些运行参数,就能稳定观察版本切换、探针摘流和慢响应。

学习目标

  • 构建一个能返回版本号的最小 HTTP 应用。
  • 区分 /livez 与 /readyz,并用环境变量控制延迟和就绪状态。
  • 构建可复用镜像,为后续 Kubernetes 滚动发布实验提供稳定对象。

实现实验应用

下面只使用 Python 标准库。APP_VERSION 标识版本,RESPONSE_DELAY_MS 模拟根路径响应延迟,READY 控制就绪接口,PORT 控制监听端口。

python
import json
import os
import time
from http.server import BaseHTTPRequestHandler, HTTPServer

VERSION = os.getenv("APP_VERSION", "v1")
DELAY_MS = int(os.getenv("RESPONSE_DELAY_MS", "0"))
READY = os.getenv("READY", "true").lower() == "true"
PORT = int(os.getenv("PORT", "8080"))

class Handler(BaseHTTPRequestHandler):
    def _write_json(self, status, payload):
        body = json.dumps(payload).encode("utf-8")
        self.send_response(status)
        self.send_header("Content-Type", "application/json")
        self.send_header("Content-Length", str(len(body)))
        self.end_headers()
        self.wfile.write(body)

    def do_GET(self):
        if self.path == "/livez":
            self._write_json(200, {"status": "alive"})
            return
        if self.path == "/readyz":
            self._write_json(200 if READY else 503, {"ready": READY})
            return
        if self.path == "/":
            time.sleep(DELAY_MS / 1000)
            self._write_json(200, {"version": VERSION, "delayMs": DELAY_MS})
            return
        self._write_json(404, {"error": "not found"})

    def log_message(self, fmt, *args):
        return

if __name__ == "__main__":
    HTTPServer(("0.0.0.0", PORT), Handler).serve_forever()

将文件保存为 app.py。先以 v1 启动,并加入 200 ms 延迟:

bash
APP_VERSION=v1 RESPONSE_DELAY_MS=200 READY=true PORT=8080 python3 app.py

预期结果

text
进程保持前台运行且默认不输出访问日志。

另开一个终端验证三个接口:

bash
curl -sS http://127.0.0.1:8080/
curl -sS http://127.0.0.1:8080/livez
curl -sS http://127.0.0.1:8080/readyz

预期输出

text
{"version": "v1", "delayMs": 200}
{"status": "alive"}
{"ready": true}

验证就绪状态

存活表示进程仍能处理请求;就绪表示实例当前是否应该接收业务流量。为了复现“进程仍存活,但暂时不进入 Service 可用后端”的状态,将 READY 改为 false 后重新启动。

bash
APP_VERSION=v1 RESPONSE_DELAY_MS=0 READY=false PORT=8080 python3 app.py

预期结果

text
进程保持前台运行。

在另一个终端只检查状态码:

bash
curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:8080/livez
curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:8080/readyz

预期输出

text
200
503

这说明后续可以让 livenessProbe 保持成功,同时让 readinessProbe 失败,从而观察 Pod 存活但被流量端点摘除的行为。

构建版本化镜像

镜像只封装相同的应用代码,版本和实验参数都在容器启动时注入,因此不必为 v1、v2 维护两份源码。

dockerfile
FROM python:3.12-slim
WORKDIR /app
COPY app.py /app/app.py
EXPOSE 8080
CMD ["python", "/app/app.py"]

这是配置文件示例,不单独产生控制台输出;保存为 Dockerfile 后,用下面命令构建并确认镜像标签:

bash
docker build -t rolling-demo:local .
docker image inspect rolling-demo:local --format '{{index .RepoTags 0}}'

预期输出

text
rolling-demo:local

运行镜像并注入 v2:

bash
docker run --rm -p 8080:8080 -e APP_VERSION=v2 -e RESPONSE_DELAY_MS=0 -e READY=true rolling-demo:local

预期结果

text
容器保持前台运行。

另开终端验证版本:

bash
curl -sS http://127.0.0.1:8080/

预期输出

text
{"version": "v2", "delayMs": 0}

后续滚动发布只需改变 APP_VERSION、RESPONSE_DELAY_MS 或 READY,就能在应用逻辑不变的前提下制造可观察差异,使每次升级实验的变量保持可控。

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

目录与阅读设置

阅读设置

17

记录一个想法

准备滚动发布实验应用

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

登录哪都通