docker-compose.yml怎么使用

<think>我们正在讨论docker-compose.yml文件的使用方法和示例。根据引用内容，docker-compose.yml是Docker Compose的核心配置文件，用于定义多容器应用的服务、网络、卷等资源。下面我将逐步介绍如何编写和使用docker-compose.yml文件。 ### 1. docker-compose.yml文件的基本结构 docker-compose.yml文件采用YAML格式，通常包含以下顶级元素： - `version`: 指定使用的Compose文件格式版本（如'3.8'），这决定了可用的配置选项和Docker Engine的兼容性[^1][^2]。 - `services`: 定义容器服务，每个服务对应一个容器，可以配置镜像、端口映射、卷挂载、环境变量等[^1][^2]。 - `volumes`: 定义数据卷，用于数据持久化和共享[^1][^2]。 - `networks`: 定义网络，用于容器之间的通信[^1][^2]。 ### 2. 服务配置详解 在`services`部分，每个服务可以配置以下常用选项： - `image`: 指定使用的Docker镜像（如`nginx:latest`）[^4]。 - `container_name`: 自定义容器名称（如`my_nginx_container`）[^4]。 - `ports`: 端口映射，格式为`"主机端口:容器端口"`（如`"8080:80"`）[^4]。 - `volumes`: 卷挂载，支持主机路径挂载、命名卷挂载（如`./html:/usr/share/nginx/html`）[^3][^4]。 - `environment`: 设置环境变量（如`NGINX_ENV_VAR=value`）[^4]。 - `networks`: 指定服务连接的网络[^4]。 - `depends_on`: 定义服务启动依赖顺序（如服务B依赖服务A）[^2]。 - `restart`: 容器重启策略（如`always`）[^4]。 - `deploy`: 仅用于Swarm模式，可设置资源限制（如CPU、内存）[^3]。 ### 3. 示例：部署Nginx和MySQL应用 下面是一个典型的docker-compose.yml示例，包含一个Nginx服务和一个MySQL服务： ```yaml version: '3.8' services: web: image: nginx:latest container_name: my_nginx ports: - "8080:80" volumes: - ./html:/usr/share/nginx/html - ./nginx.conf:/etc/nginx/nginx.conf networks: - app_network depends_on: - db restart: always db: image: mysql:5.7 container_name: my_mysql environment: MYSQL_ROOT_PASSWORD: example volumes: - mysql_data:/var/lib/mysql networks: - app_network volumes: mysql_data: driver: local networks: app_network: driver: bridge ``` #### 示例说明： - **服务互联**：通过`app_network`网络，`web`服务可通过服务名`db`访问MySQL容器[^2]。 - **数据持久化**：使用命名卷`mysql_data`保存MySQL数据，即使容器重启数据也不会丢失[^3]。 - **配置管理**：将主机上的`nginx.conf`文件挂载到容器中，实现配置动态更新[^4]。 - **启动顺序**：`web`服务通过`depends_on`确保在`db`服务启动后再启动[^2]。 ### 4. 常用命令 编写好docker-compose.yml后，可通过以下命令操作： - 启动所有服务：`docker-compose up -d` - 停止并删除容器：`docker-compose down` - 查看服务状态：`docker-compose ps` - 查看服务日志：`docker-compose logs -f web` ### 5. 最佳实践 - **多环境配置**：通过多个Compose文件管理不同环境（如开发、生产）： ```bash docker-compose -f docker-compose.yml -f docker-compose.prod.yml up ``` - **资源限制**：在`deploy`中限制CPU和内存（Swarm模式）[^3]： ```yaml services: web: deploy: resources: limits: cpus: '0.50' memory: 512M ``` - **卷驱动选择**：根据需求使用NFS等驱动实现跨主机共享存储[^3]。 ### 总结 docker-compose.yml通过声明式配置简化了多容器应用的管理。合理配置服务、网络和卷是高效编排的关键[^1][^3]。 §§相关问题§§ 1. 如何解决docker-compose中服务间的依赖启动顺序问题？ 2. docker-compose如何实现跨主机容器通信？ 3. docker-compose.yml中`deploy`配置在非Swarm模式下是否有效？</think>### Docker Compose 文件使用指南 #### 一、核心结构（顶级元素） 1. **`version`** 指定 Compose 文件格式版本（如 `'3.8'`），需与 Docker Engine 版本兼容[^2]。 ```yaml version: '3.8' ``` 2. **`services`** 定义容器服务，每个服务对应一个容器[^1][^2]： ```yaml services: web: # 服务名称 image: nginx:latest # Docker 镜像 ports: - "8080:80" # 端口映射（主机:容器） volumes: - ./html:/usr/share/nginx/html # 卷挂载 ``` 3. **`volumes`** 管理持久化存储，支持 NFS 等驱动[^3]： ```yaml volumes: db_data: # 卷名称 driver: local driver_opts: type: nfs o: addr=192.168.1.1,rw ``` 4. **`networks`** 定义容器网络（支持桥接/覆盖网络）[^2]： ```yaml networks: app_net: driver: bridge ``` --- #### 二、服务配置详解 1. **基础配置** ```yaml services: web: container_name: my_nginx # 自定义容器名 restart: always # 自动重启策略 environment: - NGINX_ENV=production # 环境变量 ``` 2. **资源限制** 通过 `deploy` 限制 CPU/内存（需 Swarm 模式）[^3]： ```yaml db: deploy: resources: limits: cpus: '0.50' memory: 512M ``` 3. **依赖管理** 使用 `depends_on` 控制启动顺序： ```yaml web: depends_on: - db # 先启动db服务 ``` --- #### 三、完整示例：Nginx + MySQL ```yaml version: '3.8' services: web: image: nginx:latest ports: - "8080:80" volumes: - ./html:/usr/share/nginx/html networks: - app_net db: image: mysql:5.7 environment: MYSQL_ROOT_PASSWORD: example volumes: - mysql_data:/var/lib/mysql networks: - app_net volumes: mysql_data: # 持久化MySQL数据 networks: app_net: driver: bridge ``` --- #### 四、操作命令 1. **启动服务** ```bash docker-compose up -d # 后台运行 ``` 2. **停止服务** ```bash docker-compose down ``` 3. **多环境配置** 叠加多个配置文件[^3]： ```bash docker-compose -f docker-compose.yml -f docker-compose.prod.yml up ``` > 提示：通过 `docker-compose config` 可验证文件语法是否正确。