Docker Compose 进阶：使用 extends 实现配置复用与扩展-优快云博客

Docker Compose 进阶：使用 extends 实现配置复用与扩展

docs Source repo for Docker's Documentation 项目地址: https://gitcode.com/gh_mirrors/docs3/docs

概述

在 Docker Compose 项目中，extends 是一个强大但常被忽视的功能，它允许你在不同的 Compose 文件甚至不同项目之间共享和复用服务配置。本文将深入探讨这一功能的使用场景、实现原理和最佳实践。

为什么需要 extends 功能

在复杂的微服务架构中，多个服务往往共享相似的配置。例如：

相同的构建上下文
类似的环境变量设置
共用的资源限制
标准化的日志配置

传统做法是复制粘贴这些配置，但这会导致维护困难。extends 提供了一种 DRY（Don't Repeat Yourself）的解决方案。

基本用法

跨文件扩展配置

假设我们有一个基础配置文件 base-services.yml：

services:
  app_base:
    build: .
    environment:
      NODE_ENV: production
      LOG_LEVEL: info
    volumes:
      - ./logs:/app/logs

在项目的主 compose.yaml 中可以这样扩展：

services:
  web_service:
    extends:
      file: base-services.yml
      service: app_base
    ports:
      - "8080:80"

同文件内扩展

services:
  base_service:
    image: nginx:alpine
    restart: always
    
  extended_service:
    extends: base_service
    environment:
      - NGINX_HOST=example.com

高级特性

配置覆盖与合并

扩展时可以覆盖或新增配置项：

services:
  customized_service:
    extends:
      file: base-config.yml
      service: standard_app
    environment:
      DEBUG: "1"  # 覆盖原有环境变量
    deploy:
      replicas: 3  # 新增部署配置

相对路径处理

当使用跨文件的 extends 时，所有路径都会自动转换为相对于主 Compose 文件的路径：

项目结构：
/my-project/
  ├── compose.yaml
  └── configs/
      ├── base.yml
      └── app.env

在 base.yml 中定义的 env_file: ./app.env 会被正确解析为 ../configs/app.env

实际应用场景

场景一：多环境配置

# base.yml
services:
  app:
    build: .
    env_file: .env

# compose.dev.yaml
services:
  dev_app:
    extends:
      file: base.yml
      service: app
    environment:
      DEBUG: "true"

# compose.prod.yaml  
services:
  prod_app:
    extends:
      file: base.yml
      service: app
    deploy:
      replicas: 3

场景二：微服务共享配置

# common.yml
services:
  microservice_base:
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"

# compose.yaml
services:
  user_service:
    extends:
      file: common.yml
      service: microservice_base
    build: ./user-service

  order_service:
    extends:
      file: common.yml
      service: microservice_base  
    build: ./order-service