leftso 293 0 2021-09-24
版权申明:本文为博主原创文章,未经博主允许不得转载。 https://www.leftso.com/blog/906.html

一. 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.27.4/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.27.4, 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"
      - "../leftso/data/resources/assist:/var/lib/dav/data/leftso/assist"
      - "../mysql/backup:/var/lib/dav/data/mysql/backup"
    environment:
      - AUTH_TYPE=Digest
      - USERNAME=root
      - PASSWORD=root
    deploy:
      resources:
        limits:
          memory: 150M

 

 

提示:本文最后更新于【 2021-09-24 10:48:47 】,某些文章具有时效性,若有错误或已失效,请在下方留言

评论区域