容器与云原生 / 系统课时

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 或其他编排系统的策略。

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

目录与阅读设置

阅读设置

17

记录一个想法

EXPOSE USER 与 HEALTHCHECK

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

登录哪都通