Docker Compose 入门:一个文件起一套本地环境

举报
yd_234737719 发表于 2026/11/15 00:30:49 2026/11/15
【摘要】 本地开发最烦的不是写代码,是凑环境:数据库、缓存、消息队列各来一个容器,每次重启都要回忆一堆 docker run 参数。Compose 解决的就是这件事——把一堆参数变成一份 YAML。 docker-compose.yml 里写 version 可以省略(新版本已不要求),核心只有 services。一个 Postgres 加一个 Redis,各自写 image、ports、environme

本地开发最烦的不是写代码,是凑环境:数据库、缓存、消息队列各来一个容器,每次重启都要回忆一堆 docker run 参数。Compose 解决的就是这件事——把一堆参数变成一份 YAML。

一、最小可用文件

docker-compose.yml 里写 version 可以省略(新版本已不要求),核心只有 services。一个 Postgres 加一个 Redis,各自写 image、ports、environment、volumes 四行,docker compose up -d 就直接起来。

容器名不要写死,交给 Compose 按项目名生成,避免和别的项目冲突。需要固定名字再用 container_name。

二、volumes 与数据不丢

容器删了数据就没了,这是新手最常见的坑。命名卷写法是 volumes: [pgdata:/var/lib/postgresql/data],再在文件底部声明 volumes: pgdata:。绑定挂载(./data:/var/lib/...)适合本地调试看文件,命名卷适合「数据要一直留着」。

数据库容器第一次初始化用 environment 里的 POSTGRES_PASSWORD,之后改密码必须进容器改,改 env 不生效——这条坑过很多人。

三、depends_on 不是「等它启动好」

depends_on 只保证启动顺序,不保证服务可用。应用起来时数据库可能还在初始化。稳妥的做法是应用侧加重试,或者用 healthcheck 加 condition: service_healthy,让 Compose 真等到健康检查通过。

四、网络与互访

同一份 Compose 文件里的服务默认在同一个网络里,用服务名当主机名就能互访:应用连数据库写 host: db、port: 5432,不需要知道容器 IP。要让外部访问才映射端口,内部互访根本不用 ports。

反过来,只在内部用的服务(比如只被应用访问的数据库)不要映射到宿主机,少一个暴露面,也少一次端口冲突。

五、常用命令就四个

docker compose up -d 起,down 停并删容器(加 -v 连卷一起删),ps 看状态,logs -f 看日志。改完 YAML 用 up -d 会做增量重建,不需要先 down。

一份 Compose 文件本身就是环境文档:新人 clone 下来 docker compose up -d 就能跑,比在 README 里写十条安装步骤可靠得多。先把这三个服务的版本钉死(写具体 tag,别用 latest),团队环境才算真的统一。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。