容器与云原生 / 系统课时
准备滚动发布实验应用
准备滚动发布实验应用
这一课准备一个可控的最小 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,就能在应用逻辑不变的前提下制造可观察差异,使每次升级实验的变量保持可控。
按自己的节奏,确认真正理解。