容器与云原生 / 系统课时
EXPOSE USER 与 HEALTHCHECK
EXPOSE USER 与 HEALTHCHECK
本课解决“镜像能够启动,但端口、运行身份和健康状态不清晰”的问题。完成后,你将能声明服务端口、切换到非 root 用户,并让 Docker 根据真实探测结果判断容器是否健康。
学习目标
- 理解
EXPOSE与端口发布的区别 - 使用
USER降低容器进程权限 - 编写并验证
HEALTHCHECK
EXPOSE 只做声明
EXPOSE 8080 表示镜像设计为监听 8080 端口,便于使用者和编排工具理解服务接口,但它不会自动把端口发布到宿主机。真正发布端口仍需在运行时使用 -p <HOST_PORT>:8080。
声明应与应用实际监听端口一致。若应用只监听 127.0.0.1,即使发布端口,宿主机也可能无法访问;容器内服务通常应监听 0.0.0.0。
USER 限制运行权限
容器默认可能以 root 身份运行。生产镜像应创建专用用户,并在复制文件、安装依赖和调整权限后使用 USER 切换身份。
非 root 用户不能自动修复权限错误。应用需要写入日志、缓存或上传目录时,应在切换前创建目录并设置所有者,而不是运行后再授予过大的权限。
完整健康检查示例
app.py 提供普通页面和 /health 健康端点:
python
from http.server import BaseHTTPRequestHandler, HTTPServer
class Handler(BaseHTTPRequestHandler):
def do_GET(self):
body = b"ok" if self.path == "/health" else b"hello"
self.send_response(200)
self.send_header("Content-Type", "text/plain")
self.send_header("Content-Length", str(len(body)))
self.end_headers()
self.wfile.write(body)
def log_message(self, format, *args):
return
HTTPServer(("0.0.0.0", 8080), Handler).serve_forever()Dockerfile 内容:
dockerfile
FROM python:3.12-slim
WORKDIR /app
RUN useradd --create-home --uid 10001 appuser
COPY --chown=appuser:appuser app.py .
EXPOSE 8080
USER appuser
HEALTHCHECK --interval=10s --timeout=3s --start-period=5s --retries=3 CMD ["python", "-c", "import urllib.request; urllib.request.urlopen('http://127.0.0.1:8080/health', timeout=2).read()"]
CMD ["python", "app.py"]构建镜像:
bash
docker build -q -t docker-health-demo:1.0 .预期输出:
text
<IMAGE_ID>启动容器并发布端口:
bash
docker run -d --name docker-health-demo -p 8080:8080 docker-health-demo:1.0预期输出:
text
<CONTAINER_ID>等待至少一次健康检查后验证配置:
bash
docker inspect --format '{{.Config.User}} {{json .Config.ExposedPorts}} {{.State.Health.Status}}' docker-health-demo预期输出:
text
appuser {"8080/tcp":{}} healthy首次检查时可能暂时显示 starting,实际等待时间由 start-period 和 interval 决定。若持续为 unhealthy,应先在容器内确认健康端点、监听地址和探测命令,而不是单纯增加重试次数。
健康检查边界
健康检查应验证服务是否具备继续接收请求的能力,但不应执行耗时操作,也不要把所有外部依赖都设为强制条件。过重的检查会放大故障,过轻的检查又无法识别进程假活。
HEALTHCHECK 只提供状态信号,是否重启或摘除容器取决于 Docker Compose、Swarm、Kubernetes 或其他编排系统的策略。
按自己的节奏,确认真正理解。