容器与云原生 / 系统课时
写出第一份 Compose 文件
写出第一份 Compose 文件
这一篇会把一次最小的声明式部署完整跑通:用 compose.yaml 描述一个 Nginx Service,再由 Compose 创建并启动容器,最后通过 HTTP 状态码验证服务可访问。完成后,你就能从多个 docker run 命令过渡到可重复使用的配置文件。
学习目标
- 写出只包含一个 Nginx Service 的最小 Compose 配置
- 使用
docker compose up -d启动声明的服务 - 通过本机 HTTP 请求验证端口映射已经生效
准备工作
开始前需要保证 Docker 引擎已经运行,并且当前环境支持 docker compose 子命令。示例使用主机端口 8080;如果该端口已被其他程序占用,应先释放端口或把配置中的主机端口改成其他可用值。
在一个空目录中创建文件 compose.yaml。现代 Compose 使用 Compose Specification,不需要再为了格式版本额外添加顶层 version 字段。
编写最小配置
把下面内容保存到 compose.yaml:
services:
web:
image: nginx:alpine
ports:
- "8080:80"services 定义 Project 中的服务集合;web 是 Service 名称;image 指定 Nginx 镜像。ports 中左侧的 8080 是主机端口,右侧的 80 是容器内 Nginx 监听的端口,所以访问本机 8080 会被转发到容器的 80。
这份文件只有一个 Service,没有显式声明网络时,Compose 会为当前 Project 创建默认网络,并让 web 容器加入该网络。
启动 Nginx
在 compose.yaml 所在目录执行:
docker compose up -d预期结果类似:
[+] Running 2/2
✔ Network <PROJECT>_default Created
✔ Container <PROJECT>-web-1 Started<PROJECT> 会随 Project 名称变化;首次运行时如果本地没有 nginx:alpine,终端还会先出现镜像拉取过程。-d 表示让容器在后台运行,因此命令结束后终端会立即返回。
验证端口映射
服务启动后,用 HTTP 请求检查 Nginx 是否能通过主机的 8080 端口访问:
curl -s -o /dev/null -w '%{http_code}\n' http://localhost:8080预期输出:
200如果得到 200,说明 Compose 已完成从配置解析、容器创建到端口映射的整条链路。也可以在浏览器访问 http://localhost:8080,页面应显示 Nginx 默认欢迎页。
Compose 文件带来的变化
使用 docker run 时,镜像、端口、环境变量等运行参数散落在命令行中;Compose 则把期望状态写进文件。以后需要重新创建同一套服务时,重点维护的是 compose.yaml,而不是重新拼接一长串启动参数。
这也是 Compose 的核心价值:用可保存、可审查、可重复执行的声明描述多服务应用。即使当前示例只有一个 Nginx,后续增加数据库、缓存或消息队列时,仍然是在同一个 services 区域继续扩展。