容器与云原生 / 系统课时
容器化前端应用
容器化前端应用
本课把一个静态前端页面打包进 Nginx 镜像,并使用自定义配置提供访问。完成后,你将构建一个不依赖本地 Node.js 或 Web 服务器的前端镜像,并通过宿主机 8080 端口看到页面内容。
学习目标
- 准备可由 Nginx 提供的静态资源
- 编写前端镜像和 Web 服务配置
- 构建、运行并验证页面响应
准备静态页面
创建 frontend/index.html:
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Docker 多容器示例</title>
</head>
<body>
<main>
<h1>Docker 多容器示例</h1>
<p>前端容器已经成功运行。</p>
</main>
</body>
</html>这是可直接部署的静态资源。真实项目通常先在构建阶段执行前端打包,再把 dist 目录复制进运行镜像;本课先聚焦最终运行镜像。
配置 Nginx
创建 frontend/nginx.conf:
server {
listen 80;
server_name _;
root /usr/share/nginx/html;
index index.html;
location / {
try_files $uri $uri/ /index.html;
}
}try_files 让不存在的前端路由回退到 index.html,适合单页应用。配置文件生效后,访问 / 或前端路由都由同一个入口页面处理。
编写并构建镜像
创建 frontend/Dockerfile:
FROM nginx:alpine
COPY nginx.conf /etc/nginx/conf.d/default.conf
COPY index.html /usr/share/nginx/html/index.html
EXPOSE 80在项目根目录构建镜像:
docker build -t demo-frontend:1.0 ./frontend预期输出:
[+] Building FINISHED
=> naming to docker.io/library/demo-frontend:1.0基础镜像已经提供前台运行的 Nginx 启动命令,因此不需要重复编写 CMD。
运行并验证页面
启动前端容器:
docker run --rm -d \
--name demo-frontend \
-p 8080:80 \
demo-frontend:1.0预期输出:
<ID><ID> 是本次创建的容器 ID,实际值每次都不同。检查页面标题:
curl -s http://localhost:8080 | grep -o '<title>[^<]*</title>'预期输出:
<title>Docker 多容器示例</title>浏览器访问 http://localhost:8080 时,应看到标题和“前端容器已经成功运行”文本。如果看到默认欢迎页,检查页面是否复制到了生效的站点根目录。如果返回 403,检查入口文件是否存在,以及 Nginx 工作进程能否读取它。
分开验证路由回退与资源缺失
本例保留 location / 的页面回退,用于客户端路由。真实的单页应用通常还会把打包资源放在单独目录。若打包输出使用 /assets/,可在同一个 server 块内、location / 之外增加这段配置,让缺失资源返回 404。
location /assets/ {
try_files $uri =404;
}保存后停止旧容器,重新构建并执行上面的启动命令。页面路由预期返回 200 和入口 HTML,缺失的 JavaScript 文件预期返回 404。这样浏览器控制台会指向真正缺失的资源路径,排查时可以检查打包文件是否复制进镜像,以及资源前缀是否和部署路径一致。Nginx try_files 文档
docker stop demo-frontend
docker build -t demo-frontend:1.0 ./frontend
docker run --rm -d --name demo-frontend -p 8080:80 demo-frontend:1.0
curl -i http://localhost:8080/settings
curl -i http://localhost:8080/assets/missing.js本课的静态 HTML 不包含客户端路由器,因此直接请求 /settings 会显示同一个页面。引入路由器后,前端代码会读取地址并选择对应视图。