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来进行编排管理。
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 [-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+版本)
docker-compose pull [options] [SERVICE...]
命令选项如下:
–ignore-pull-failures,忽略拉取镜像过程中的错误 –parallel,多个镜像同时拉取 –quiet,拉取镜像过程中不打印进度信息
拉取服务依赖的镜像
docker-compose pull
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来重新构建服务
docker-compose start [SERVICE...]
启动已经存在的服务容器
docker-compose start
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
docker-compose ps [options][SERVICE...]
查看项目中运行中的容器
docker-compose ps
查看当前项目中的所有容器
docker-compose ps -a
docker-compose stop [options] [SERVICE...]
命令选项如下:
-t —timeout TIMEOUT停止容器时候的超时(默认为 10 秒)
停止正在运行的容器
docker-compose stop
可使用以下命令再次启动
docker-compose start
通过发送 SIGKILL 信号强制停止服务容器
docker-compsoe kill [options] [SERVICE]
命令选项如下:
-s 指定发送的信号
docker-compose rm [options] [SERVICE...]
命令选项如下:
–f, –force,强制直接删除,包括非停止状态的容器 -v 删除容器所挂载的数据卷
先停止容器
docker-compose stop
删除所有停止状态下的容器
docker-compose rm
docker-compose down [options]
命令选项如下:
-rmi type,删除镜像、类型必须是:all,删除 compose 文件中定义的所有镜像
local, 删除镜像名为空的镜像
-v -volumes 删除已经在 compose 文件中定义的和匿名的附在容器上的数据卷
-remove-orphans 删除服务中没有在 compose 中定义的容器
docker-compose logs [options][SERVICE...]
默认情况下,docker-compsoe 将对不同的服务输出使用不同的颜色用以区分,但是可以通过-no-color 关闭颜色
查看服务容器的输出
docker-compose logs
docker-compose restart [options] [SERVICE...]
命令选项如下:
-t –timeout TIMEOUT 指定重启前停止容器的超时(默认为10秒)
重启项目服务
docker-compose restart
暂停容器
docker-compose pause [SERVICE...]
恢复处于暂停状态的容器
docker-compsoe unpause [SERVICE...]
docker-compose run [options] [-v VOLUME...] [-p PORT...] [-e KEY=VAL...] SERVICE [COMMAND] [ARGS...]
在指定容器执行 ping 命令
docker-compose run Ubuntu ping www.baidu.com
设置指定服务运行的容器个数
docker-compose scale web=3 db=2
docker-compsoe push [options][SERVICE...]
命令选项如下:
–ignore-push-failures 忽略推送镜像过程中的错误
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 内存限制
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
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
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
https://www.leftso.com/article/906.html