tidyrailroad/docker-compose

docker-composer 镜像文档

概述

docker-composer是一个用于定义和运行多容器Docker应用程序的工具。它允许用户通过单个YAML文件配置应用所需的所有服务，然后使用统一命令创建和管理这些服务，简化了多容器应用的部署与维护流程。

核心功能与特性

• 集中式配置管理：通过docker-compose.yml文件统一定义服务、网络和数据卷配置
• 多服务编排：支持一键启动、停止、重启和构建多个关联服务
• 依赖关系处理：自动管理服务间依赖，按顺序启动相关服务
• 环境隔离：支持通过.env文件或命令行传递环境变量，实现配置与代码分离
• 网络自动配置：自动创建和管理服务间通信网络，无需手动配置网络规则
• 数据持久化：集成Docker数据卷功能，确保服务数据持久化存储

使用场景与适用范围

• 本地开发环境：快速搭建包含数据库、缓存、Web服务等多组件的开发环境
• 测试环境部署：在测试服务器上快速部署完整应用栈，确保测试环境一致性
• 小型应用生产环境：适用于规模较小的生产环境，简化多服务部署流程
• CI/CD集成：作为持续集成/部署流程的一部分，自动化应用栈的构建与测试

使用方法与配置说明

获取镜像

通过Docker Hub获取官方镜像：

bash
docker pull docker/compose

基本命令

启动服务

bash
docker-compose up

• 选项：
  • -d：后台运行服务
  • --build：启动前重新构建服务镜像
  • --force-recreate：强制重新创建容器

停止服务

bash
docker-compose down

• 选项：
  • -v：删除关联的数据卷
  • --rmi all：删除构建的服务镜像
  • --remove-orphans：删除未在compose文件中定义的容器

查看服务状态

bash
docker-compose ps

查看服务日志

bash
docker-compose logs [服务名]

• 选项：
  • -f：实时跟踪日志输出
  • --tail=100：显示最近100行日志

配置文件示例

以下是包含Web应用和PostgreSQL数据库的docker-compose.yml示例：

yaml
version: '3.8'

services:
  web:
    build: ./app  # 从本地Dockerfile构建
    ports:
      - "8080:80"  # 端口映射：主机8080 -> 容器80
    volumes:
      - ./app:/usr/share/nginx/html  # 挂载本地代码目录到容器
    depends_on:
      - db  # 依赖db服务，确保db先启动
    environment:
      - DATABASE_HOST=db
      - DATABASE_PORT=5432
      - DATABASE_NAME=mydb

  db:
    image: postgres:14  # 使用官方PostgreSQL镜像
    volumes:
      - postgres_data:/var/lib/postgresql/data  # 持久化数据卷
    environment:
      - POSTGRES_USER=admin
      - POSTGRES_PASSWORD=secret
      - POSTGRES_DB=mydb
    ports:
      - "5432:5432"  # 可选：暴露数据库端口供外部访问

volumes:
  postgres_data:  # 定义命名数据卷

环境变量配置

创建.env文件管理环境变量：

env
# .env文件
DB_USER=admin
DB_PASSWORD=secret
DB_NAME=mydb
WEB_PORT=8080

在docker-compose.yml中引用环境变量：

yaml
services:
  web:
    ports:
      - "${WEB_PORT}:80"
    environment:
      - DATABASE_USER=${DB_USER}
      - DATABASE_PASSWORD=${DB_PASSWORD}
      - DATABASE_NAME=${DB_NAME}

注意事项

• 确保Docker引擎版本与docker-compose.yml中声明的版本兼容（如version: '3.8'需要Docker Engine 19.03.0+）
• 生产环境中建议配合使用Docker Swarm或Kubernetes等更强大的编排工具
• 敏感配置（如密码）应通过环境变量或Docker Secrets管理，避免直接写入配置文件
• 使用depends_on仅保证启动顺序，不保证服务就绪状态，生产环境需实现健康检查机制