Linux之docker-compose入门篇

一. Compose简介

Compose 项目是 Docker 官方的开源项目,负责实现对 Docker 容器集群的快速编排.通过Compose,可以使用YAML文件来配置应用程序需要的所有服务,然后使用docker-compose up 命令就可以从YAML文件配置中创建并启动所有服务.
Compose 使用的三个步骤:

• 使用 Dockerfile 定义应用程序的环境.
• 使用 docker-compose.yml 定义构成应用程序的服务,这样它们可以在隔离环境中一起运行.
• 执行 docker-compose up 命令来启动并运行整个应用程序.

二. 安装

a). 查看安装环境

[root@freedev ~] uname -a 
Linux freedev 3.10.0-1062.1.2.el7.x86_64 #1 SMP Mon Sep 30 14:19:46 UTC 2019 x86_64 x86_64 x86_64 GNU/Linux
[root@freedev ~] lsb_release -a
LSB Version:	:core-4.1-amd64:core-4.1-noarch
Distributor ID:	CentOS
Description:	CentOS Linux release 7.7.1908 (Core)
Release:	7.7.1908
Codename:	Core

b). 从GitHub下载二进制包进行使用,发行版本地址

# uname -s 操作系统名称
# uname -m 操作系统类型
[root@freedev bin] curl -L "https://github.com/docker/compose/releases/download/1.24.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   633  100   633    0     0    556      0  0:00:01  0:00:01 --:--:--   556
100 15.4M  100 15.4M    0     0   196k      0  0:01:20  0:01:20 --:--:--  188k
[root@freedev bin] ls
docker-compose
# 赋予权限
[root@freedev bin] chmod +x /usr/local/bin/docker-compose
# 建立软链接
[root@freedev bin] ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
[root@freedev bin] docker-compose -v
docker-compose version 1.24.1, build 4667896b

三. Compose配置及使用

3.1 常用命令

3.1.1 命令格式

docker-compose [-f …] [options] [COMMAND] [ARGS…]

选项参数:

• -f --file FILE指定Compose模板文件,默认为docker-compose.yml;
• -p --project-name NAME指定项目名称,默认使用当前项目所在目录为项目名;
• –verbose 输出调试信息;
• -v --version 版本信息;
• –log-level LEVEL 定义日志登记(DEBUG,INFO,WARING,ERROR,CRITICAL);

3.1.2 docker-compose up

docker-compose up [options] [–scale SERVICE=NUM…] [SERVICE…]
启动容器
选项参数:

• -d 在后台运行服务容器;
• –no-color 用颜色来区分不同的服务的控制输出;
• –no-deps 不启动服务所链接的容器;
• –force-recreate 强制重新创建容器,不能与-no-recreate同时使用;
• –no-recreate 如果容器已经存在,则不重新创建,不能与–force-recreate同时使用;
• –no-build 不自动构建缺失的服务镜像;
• –build 在启动容器前构建服务镜像;
• –abort-on-container-exit 停止所有容器(如果有任何一个容器呗停止),不能与-d同时使用;
• -t,–timeout TIMEOUT 停止容器时候的超时（默认为10秒）;
• – remove-orphans 删除服务中没有在compose文件中定义的容器;

3.1.3 docker-compose down

docker-compose down [options] 停止和删除容器、网络、卷、镜像

选项参数:

• –rmi type, 删除镜像, 类型必须是：all, 删除compose文件中定义的所有镜像；local, 删除镜像名为空的镜像;
• -v,–volumes, 删除已经在compose文件中定义的和匿名的附在容器上的数据卷;
• –remove-orphans 删除服务中没有在compose中定义的容器;
• -t, --timeout TIMEOUT 指定关闭超时时间(默认10S);

3.2 docker-compose.yml配置指令参考

3.2.1 运行编译模板配置

version: '3'
services:
  web:
    # 指定为构建镜像上下文路径
    build: ./dir

build: 指定为构建镜像的上下文路径,或者作为具有在上下文指定的路径的对象,以及可选的 Dockerfile 和 args

version: '3'
services:
  web:
    # 指定为构建镜像上下文对象
    build:
      # 上下文路径
      context: ./dir
      #  指定构建镜像的 Dockerfile 文件名
      dockerfile: Dockerfile-alternate
      # 添加构建参数,只能在构建过程中访问的环境变量
      args: 
        buildno: 1
	  # 设置构建镜像的标签
	  labels:
	    - "com.example.descrption:my app"
	  # 多层构建,可以指定构建哪一层
	  targer: prod
	  # 添加容器拥有的宿主机内核功能
	  cap_add: 
	  	# 开启全部功能
	    - ALL 
	   # 反之,删除容器拥有的宿主机内核功能
	   cap_drop:
	     # 关闭 ptrace权限
	     - SYS_PTRACE 
	   # 为容器指定父 cgroup 组,继承该组的资源限制
	   cgroup_parent: m-executor-a
	   # 覆盖容器启动的默认命令
	   command: ["java", "-jar", "MyApp-1.0.0.RELEASE.jar"]
	   # 覆盖容器默认的 entrypoint
  	   entrypoint: ./entrypoint.sh

3.2.2 具有容器依赖关系模板配置

version: '3'
services:
  web:
    image: morton.freer.com:8088/app/myapp:1.0
    # # 设置依赖关系,以依赖性顺序启动服务,在以下示例中,先启动mysql和redis,才会启动web
    depends_on:
      - mysql
      - redis
  redis: 
    image: redis
  mysql:
    image: mysql/mysql-server
    # 添加环境变量
    environment: 
      MYSQL_ROOT_PASSWORD_FILE: /run/secrets/my_secrets 
    # 存储敏感数据
    secrets: 
      - my_secret
secret:
  my_secret:
    file: ./my_secret.txt

注: web服务并不会等mysql和redis完全启动之后才启动

3.2.3 docker-compose模板文件示例

# 指定本 yml 依从的 compose 哪个版本制定的
versions: '3'
services:
  web:
    # 指定容器运行镜像 ip/域名:port/namespace/appName:tag,也可以是镜像ID
    image: morton.freer.com:8088/app/myapp:1.0
    # 自定义容器名称
    contaniner_name: myApp
    # 重启策略 no: 任何情况下都不会重启容器(默认),always：容器总是重新启动,on-failure：在容器非正常退出时才从新启动,unless-stopped：在容器退出时总是重启容器,但是不考虑在Docker守护进程启动时就已经停止了的容器
    # 注：swarm 集群模式,请改用 restart_policy
    restart: always
    # 端口映射,将容器的80端口映射到宿主机的8989端口
    ports:
      - '8080:80'
    # 将主机的数据卷或文件挂载到容器里
    volumes:
      - './logs:/app/logs'
      - './data:/app/data'
    # 自定义 DNS 服务器,可以是单个值或列表的多个值。 
    dns:
     - 0.0.0.0
     - 1.1.1.1
    # 自定义 DNS 搜索域。可以是单个值或列表
    dns_search:
      - dns1.example.com
      - dns2.example.com
    # 添加环境变量
    environment:
      - JAVA_OPTS=-Xmx256m
      - Dfile.encoding=UTF-8
    # 暴露端口,但不映射到宿主机,只被连接的服务访问
    expose:
      - "6379"
      - "3306"
    # 添加主机名映射,类似 docker client --add-host
    # 该配置会在容器内部/etc/hosts中创建IP地址和主机名的映射关系
    # 10.0.0.1  nacos.example.cn mysql.example.cn
    expost_hosts:
      - "nacos.example.cn:10.0.0.1"
      - "mysql.example.cn:10.0.0.1"
      - "rabbitmq.example.cn:10.0.0.2"
    # 用于检测 docker 服务是否健康运行
    healthcheck:
   	  # 设置检测程序
      test: ["CMD", "curl", "-f", "http://127.0.0.1:8080"]
      # 设置检测间隔
      interval: 1m30s 
      # 设置检测超时时间
      timeout: 10s 
      # 设置重试次数
      retries: 3 
      # 启动后,多少秒开始启动检测程序
      start_period: 40s 
    # 日志记录配置 none,syslog,json-file,默认为json-file
    logging:
      driver: json-file
      options:
        # 单个文件大小为200k
        max-size: "200k" 
        # 最多10个文件,当达到文件限制上限,会自动删除旧得文件
        max-file: "10" 
    # 设置容器中的内核参数,可以使用数组或字典格式
    sysctls:
     - net.core.somaxconn=1024
     - net.ipv4.tcp_syncookies=0
    # 在容器内安装一个临时文件系统,可以是单个值或列表的多个值
    tmpfs:
      - /run
      - /tmp
    # 设置网络模式
    network_mode: "bridge"

docker网络配置参考