Docker-Compose 安装简介和常用命令

编程教程 > Softwares (1908) 2025-04-09 11:44:03

一. Docker-Compose 简介

1. Docker-Compose 简介

Docker-Compose项目是Docker官方的开源项目，负责实现对Docker容器集群的快速编排。

Docker-Compose将所管理的容器分为三层，分别是工程（project），服务（service）以及容器（container）。
Docker-Compose运行目录下的所有文件（docker-compose.yml，extends文件或环境变量文件等）组成一个工程，若无特殊指定工程名即为当前目录名。一个工程当中可包含多个服务，每个服务中定义了容器运行的镜像，参数，依赖。一个服务当中可包括多个容器实例，Docker-Compose并没有解决负载均衡的问题，因此需要借助其它工具实现服务发现及负载均衡。 Docker-Compose的工程配置文件默认为docker-compose.yml，可通过环境变量COMPOSE_FILE或-f参数自定义配置文件，其定义了多个有依赖关系的服务及每个服务运行的容器。使用一个Dockerfile模板文件，可以让用户很方便的定义一个单独的应用容器。在工作中，经常会碰到需要多个容器相互配合来完成某项任务的情况。例如要实现一个Web项目，除了Web服务容器本身，往往还需要再加上后端的数据库服务容器，甚至还包括负载均衡容器等。Docker-Compose允许用户通过一个单独的docker-compose.yml模板文件（YAML 格式）来定义一组相关联的应用容器为一个项目（project）。 Docker-Compose项目由Python编写，调用Docker服务提供的API来对容器进行管理。因此，只要所操作的平台支持Docker API，就可以在其上利用Compose来进行编排管理。

2. Docker-Compose安装

sudo curl -L "https://github.com/docker/compose/releases/download/1.28.5/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

sudo chmod +x /usr/local/bin/docker-compose
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

检查安装结果

$ docker-compose --version
docker-compose version 1.28.5, build 1110ad01

二. Docker-Compose常用命令

1. Docker-Compose 命令格式

docker-compose [-f <arg>] [options][command][args]

常用命令选项如下：

-f -file FILE 可指定Compose 模版文件，默认为 docker-compose.yml

-p -project-name NAME指定项目名称，默认将使用所在目录名称为项目名

-v --version 打印版本并退出

-verbose 输出调试信息

-x-network-driver 使用 Docker 的可插拔网络后端特性(需要 Docker 1.9+版本，可操作性有待商榷)

-x-network-deover DRIVER指定网络后端的驱动，默认为 bridge(需要 Docker 1.9+版本)

2. Docker-Compose 拉取服务镜像

docker-compose pull [options] [SERVICE...]

命令选项如下：

–ignore-pull-failures，忽略拉取镜像过程中的错误 –parallel，多个镜像同时拉取 –quiet，拉取镜像过程中不打印进度信息

拉取服务依赖的镜像

docker-compose pull

3. Docker-Compose 构建服务

docker-compose build [options] [--build-arg key=val...] [SERVICE...]

命令选项包括： –compress 通过gzip压缩构建上下环境 –force-rm 删除构建过程中的临时容器 –no-cache 构建镜像过程中不使用缓存 –pull 始终尝试通过拉取操作来获取更新版本的镜像 -m, –memory MEM为构建的容器设置内存大小 –build-arg key=val为服务设置build-time变量 服务容器一旦构建后，将会带上一个标记名。可以随时在项目目录下运行docker-compose build来重新构建服务

4. Docker-Compose 启动容器

docker-compose start [SERVICE...]

启动已经存在的服务容器

docker-compose start

5. Docker-compose 构建并启动容器

docker-compose up [option][--scale SERVICE=NUM...][SERVICE...]

常用命令选项如下：

-d 在后台运行服务器

-t -timeout TIMEOUT 停止容器是的超时(默认为 10 秒)

-f -file FILE 可指定Compose 模版文件，默认为 docker-compose.yml

-build 在启动容器前自动构建服务镜像

-no-build 不自动构建缺失的镜像

常用命令实例

启动所有服务

docker-compose up

在后台启动所有服务

docker-compose up -d

重新构建镜像

docker-compose up -d --build

-f 使用指定的 Compose 模版文件启动服务,默认为 docker-compose.yml 文件

docker-compose -f docker-compose.yml up

6. Docker-Compose 查看容器

docker-compose ps [options][SERVICE...]

查看项目中运行中的容器

docker-compose ps

查看当前项目中的所有容器

docker-compose ps -a

7. Docker-Compose 停止容器

docker-compose stop [options] [SERVICE...]

命令选项如下：

-t —timeout TIMEOUT停止容器时候的超时(默认为 10 秒)

停止正在运行的容器

docker-compose stop

可使用以下命令再次启动

docker-compose start

通过发送 SIGKILL 信号强制停止服务容器

docker-compsoe kill [options] [SERVICE]

命令选项如下：

-s 指定发送的信号

8. Docker-Compose 移除容器

docker-compose rm [options] [SERVICE...]

命令选项如下：

–f, –force，强制直接删除，包括非停止状态的容器 -v 删除容器所挂载的数据卷

先停止容器

docker-compose stop

删除所有停止状态下的容器

docker-compose rm

9. Docker-Compose 停用移除所有容器以及网络相关

docker-compose down [options]

命令选项如下：

-rmi type，删除镜像、类型必须是：all，删除 compose 文件中定义的所有镜像

local，删除镜像名为空的镜像

-v -volumes 删除已经在 compose 文件中定义的和匿名的附在容器上的数据卷

-remove-orphans 删除服务中没有在 compose 中定义的容器

10. Docker-Compose 查看输出日志

docker-compose logs [options][SERVICE...]

默认情况下，docker-compsoe 将对不同的服务输出使用不同的颜色用以区分，但是可以通过-no-color 关闭颜色

查看服务容器的输出

docker-compose logs

11. Docker-Compose 重启服务

docker-compose restart [options] [SERVICE...]

命令选项如下：

-t –timeout TIMEOUT 指定重启前停止容器的超时（默认为10秒）

重启项目服务

docker-compose restart

12. Docker-Compose 暂停、恢复容器

暂停容器

docker-compose pause [SERVICE...]

恢复处于暂停状态的容器

docker-compsoe unpause [SERVICE...]

13. Docker-Compose 执行命令

docker-compose run [options] [-v VOLUME...] [-p PORT...] [-e KEY=VAL...] SERVICE [COMMAND] [ARGS...]

在指定容器执行 ping 命令

docker-compose run Ubuntu ping www.baidu.com

14. Docker-Compose 指定运行容器数量

设置指定服务运行的容器个数

docker-compose scale web=3 db=2

15. Docker-Compose 推送镜像

docker-compsoe push [options][SERVICE...]

命令选项如下：

–ignore-push-failures 忽略推送镜像过程中的错误

三.Docker-Compose配置文件docker-compose.yml

案例一：tomcat镜像

docker-compose.yaml:

version: "3.8"

networks:
  vRouter: # 定义网络名：因使用已经存在的网络，所以名称与已经存在的bridge网络名称相同
    external: true #使用外部（已存在）的网络

services: 
  app-xs-1: 
    image: tomcat:8  #镜像名称和版本
    container_name: app-xs-01 # 等同于 --name app-xs
    hostname: app-xs-01 #等同于 --hostname app-xs
    ports: 
      - "8001:8080" #等同于 -p 8001:8080

    networks: 
      vRouter: #等同于 --network  vRouter （注意这里的vRouter必须在顶层networks定义）
        aliases: 
          - app-xs-01.server #等同于 --network-alias app-xs-01.server

    volumes:
      - "/data/upload:/data/xs_uploadFile"
      - "/data/app/ROOT:/opt/tomcat/webapps/ROOT" # -v /data/app/ROOT:/opt/tomcat/webapps/ROOT

    deploy: 
      resources: 
        limits: 
          memory: 1568M # -m 1568M 内存限制

案例二：MySQL

docker-compose.yaml:

version: "3.8"

networks:
  mysql-net:  # 定义网络名：##因使用已经存在的网络，所以名称与已经存在的bridge网络名称相同


services: 
  mysql5732: 
    image: harbor.ifok.net:10202/ifok/mysql:5.7.32-Shanghai
    container_name: mysql5732 # 等同于 --name mysql5732
    hostname: mysql5732 #等同于 --hostname mysql5732
    ports: 
      - "13306:3306"  #等同于 -p 13306:3306

    networks: 
      mysql-net:  #等同于 --network  vRouter （注意这里的vRouter必须在顶层networks定义）
        aliases: 
          - mysql5732.server #等同于 --network-alias mysql5732.server
    command: [  
      '--character-set-server=utf8mb4',
      '--collation-server=utf8mb4_unicode_ci'
    ]
    environment: 
      - MYSQL_ROOT_PASSWORD=root
    volumes:
      - "/data/mysql5732/data:/var/lib/mysql"   
      - "/data/mysql5732/conf.d:/etc/mysql/conf.d"  
  #    - "./init/:/docker-entrypoint-initdb.d/" #挂载初始化的脚本目录


    deploy: 
      resources: 
        limits: 
          memory: 2048M

案例三 : 其他

version: "3.8"

#定义网络相关
networks: 
  #网络名称(可以定义多个网络)
  vRouter: 
    #外部网络:(false : 加入已存在网络, 可以先通过命令 docker network create vRouter 创建网络，执行docker-compose down 时候不会删除该网络)
    external: true 
  router:
    #外部网络：（true : 创建网络，通过 docker network ls 查看创建的一般为“名称_default”,例如下面的“router_app”,
    #注意该网络会在docker-compose down命令执行时候删除）
    external: false
    #配置了name则，网络名为 router_app  (默认name为default)
    name: app
    driver: bridge
    ipam:
      driver: default
      config:
        # 注意子网ip不能与已存在的冲突
        - subnet: 172.1.0.1/24

#定义服务
services: 
  mysql57: 
    #镜像选择，私服则直接写全路径，如：harbor.ifok.net:10202/ifok/mysql:5.7.32-Shanghai
    image: mysql:5.7.32
    #容器名称，与docker run --name mysql57相似
    container_name: mysql57
    #重启机制
    restart: always
    #文件挂载 与 docker run -v /data/mysql57/data:/var/lib/mysql 功能相同
    volumes: 
      - "/data/mysql57/data:/var/lib/mysql"
      - "/data/mysql57/conf.d:/etc/mysql/conf.d"
    #网络(可以加入多个网络也可以只加入一个网络)
    networks: 
      #外部网络，如果不配置则自动获取ip等网络信息
      vRouter:
        aliases: 
          #等同于 --network-alias mysql5732.server
          - mysql5732.server 
      #内部网络
      router: 
        #分配网络地址给MySQL服务注意同一个网络中不要冲突
        ipv4_address: 172.1.0.2

    deploy:
      resources: 
        limits: 
          # -m 1568M 内存限制
          memory: 1568M 
    #容器健康检查
    healthcheck: 
      #grep -v grep 是不显示grep查询这个进程
      #test: ["CMD-SHELL", "ps -ef|grep mysqld|grep -v grep  && exit 0|| exit 1"]
      #下面是访问某个url，HTTP状态码（500、404、403 错误代码）会失败（200成功）； exit 0 （健康）失败exit 1 （不健康）
      test: ["CMD-SHELL", "curl -f http://localhost:8080 && exit 0 || exit 1"]
      #间隔时间
      interval: 30s
      #超时时间
      timeout: 10s
      #重试次数
      retries: 3
      #初始化时间(启动时间)
      start_period: 10s

案例四：bingpu

version: "3.8"

networks:
  bingpu-net:

services:
  mysql5732:
    image: harbor.ifok.net:10202/ifok/mysql:5.7.32-Shanghai
    container_name: mysql5732 # 等同于 --name mysql5732
    hostname: mysql5732
    #重启策略
    restart: always
#    ports:
#      - "3306:3306"  #等同于 -p 13306:3306

    networks:
      bingpu-net:
        aliases:
          - mysql5732.server #等同于 --network-alias mysql5732.server
    volumes:
      - "/data/bingpu/mysql5732/data:/var/lib/mysql"
      - "/data/bingpu/mysql5732/conf.d:/etc/mysql/conf.d"

    environment:
      - MYSQL_ROOT_PASSWORD=root

    command: [
      '--character-set-server=utf8mb4',
      '--collation-server=utf8mb4_unicode_ci'
    ]

    deploy:
      resources:
        limits:
          memory: 1024M

  bingpu-web:
    image: bingpu:1.0
    build:
      context: ./
      dockerfile: Dockerfile
    container_name: bingpu-web
    hostname: bingpu-web
    restart: always
    #依赖的服务，配置好后会决定services的服务启动顺序
    depends_on:
      - mysql5732
    ports:
      - "8080:8080"
    networks:
      bingpu-net:
        aliases:
          - bingpu-web.server
    volumes:
      - "/data/bingpu/logs:/var/bingpu/logs"
      - "/data/bingpu/file:/var/bingpu/file"
    deploy:
      resources:
        limits:
          memory: 512M

案例五 webdav

version: "3.8"
  
networks:
  vRouter:  # 定义网络名：##因使用已经存在的网络，所以名称与已经存在的bridge网络名称相同
    external: true

services:
  webdav:
    image: harbor.ifok.net:10202/ifok/webdav:bytemark-2.4
    container_name: webdav-2.4 # 等同于 --name webdav-2.4
    hostname: webdav-2.4 #等同于 --webdav-2.4
    restart: always #重启机制
    ports:
     - "7000:80"
    networks:
      vRouter:  #等同于 --network  vRouter （注意这里的vRouter必须在顶层networks定义）
        aliases:
          - webdav.server #等同于 --network-alias webdav.server
    volumes:
      - "./data:/var/lib/dav"
      - "../xqlee/data/resources/assist:/var/lib/dav/data/xqlee/assist"
      - "../mysql/backup:/var/lib/dav/data/mysql/backup"
    environment:
      - AUTH_TYPE=Digest
      - USERNAME=root
      - PASSWORD=root
    deploy:
      resources:
        limits:
          memory: 150M