容器与云原生 / 系统课时

写出第一份 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:

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 所在目录执行:

bash
docker compose up -d

预期结果类似:

text
[+] Running 2/2
 ✔ Network <PROJECT>_default  Created
 ✔ Container <PROJECT>-web-1  Started

<PROJECT> 会随 Project 名称变化;首次运行时如果本地没有 nginx:alpine,终端还会先出现镜像拉取过程。-d 表示让容器在后台运行,因此命令结束后终端会立即返回。

验证端口映射

服务启动后,用 HTTP 请求检查 Nginx 是否能通过主机的 8080 端口访问:

bash
curl -s -o /dev/null -w '%{http_code}\n' http://localhost:8080

预期输出:

text
200

如果得到 200,说明 Compose 已完成从配置解析、容器创建到端口映射的整条链路。也可以在浏览器访问 http://localhost:8080,页面应显示 Nginx 默认欢迎页。

Compose 文件带来的变化

使用 docker run 时,镜像、端口、环境变量等运行参数散落在命令行中;Compose 则把期望状态写进文件。以后需要重新创建同一套服务时,重点维护的是 compose.yaml,而不是重新拼接一长串启动参数。

这也是 Compose 的核心价值:用可保存、可审查、可重复执行的声明描述多服务应用。即使当前示例只有一个 Nginx,后续增加数据库、缓存或消息队列时,仍然是在同一个 services 区域继续扩展。

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

目录与阅读设置

阅读设置

17

记录一个想法

写出第一份 Compose 文件

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

登录哪都通