Docker-compose

• 一. Docker-compose简介
• 二. 工程、服务、容器
• 三. Docker-Compose安装
• 四. 常用命令
• 五. docker-compose.yml 语法
  • 参数扩展
• 六. Docker-compose version问题

一. Docker-compose简介

Docker-Compose项目是Docker官方的开源项目，负责实现对Docker容器集群的快速编排。
Docker-Compose项目由Python编写，调用Docker服务提供的API来对容器进行管理。因此，只要所操作的平台支持Docker API，就可以在其上利用Compose来进行编排管理。

二. 工程、服务、容器

Docker Compose 将所管理的容器分为三层，分别是工程（project）、服务（service）、容器（container）
Docker Compose 运行目录下的所有文件（docker-compose.yml）组成一个工程,一个工程包含多个服务，每个服务中定义了容器运行的镜像、参数、依赖，一个服务可包括多个容器实例

三. Docker-Compose安装

yum groupinstall "Development Tools"
pip install docker-compose -i https://pypi.douban.com/simple

四. 常用命令

1. ps：列出所有运行容器

   docker-compose ps
   

2. logs：查看服务日志输出

   docker-compose logs
   

3. port：打印绑定的公共端口，下面命令可以输出 eureka 服务 8761 端口所绑定的公共端口

   docker-compose port eureka 8761
   

4. build：构建或者重新构建服务

   docker-compose build
   

5. start：启动指定服务已存在的容器

   docker-compose start eureka
   

6. stop：停止已运行的服务的容器

   docker-compose stop eureka
   

7. rm：删除指定服务的容器

   docker-compose rm eureka
   

8. up：构建、启动容器

   docker-compose up
   

9. kill：通过发送 SIGKILL 信号来停止指定服务的容器

   docker-compose kill eureka
   

10. pull：下载服务镜像

11. scale：设置指定服务运气容器的个数，以 service=num 形式指定

    docker-compose scale user=3 movie=3
    

12. run：在一个服务上执行一个命令

    docker-compose run web bash
    

五. docker-compose.yml 语法

# yaml 配置实例
version: '3' # 指定 docker-compose.yml 文件的写法格式
services:    # 多个容器集合
  web:       
    build: . # 配置构建时，Compose 会利用它自动构建镜像，该值可以是一个路径，也可以是一个对象，用于指定 Dockerfile 参数
    ports:
   - "5000:5000"
    volumes:
   - .:/code
    - logvolume01:/var/log
    links:
   - redis
  redis:
    image: redis
volumes:
  logvolume01: {}

version: '3'
services:
  back:
    image: backService:1.0
    container_name: back
    environment:
      - name=tom
      - DB_PATH=jdbc:sqlite:/data/ns.db
    restart: always
    privileged: true
    ports:
      - "9000:9000"
    networks:
      - "net"
    volumes:
      - "/root/k3s.kube.config:/k3s.kube.config"
      - "/root/data:/data"
      - "/etc/network/interfaces:/etc/network/interfaces"
  front:
    image: front:1.0
    container_name: front
    restart: always
    ports:
      - "10087:80"
    networks:
      - "net"
    volumes:
      - "/root/nginx.conf:/etc/nginx/nginx.conf"
networks:
  net:
    driver: bridge

参数扩展

build:配置构建时，Compose 会利用它自动构建镜像，该值可以是一个路径，也可以是一个对象，用于指定 Dockerfile 参数

build:
    context: ./dir
    dockerfile: Dockerfile
    args:
        buildno: 1

command: 覆盖容器启动后默认执行的命令

command: [bundle,exec,thin,-p,3000]

dns: 配置 dns 服务器，可以是一个值或列表

dns:
    - 8.8.8.8
    - 9.9.9.9

dns_search: 配置 DNS 搜索域，可以是一个值或列表

dns_search:
    - dc1.example.com
    - dc2.example.com

environment: 环境变量配置

environment:
    RACK_ENV: development
    SHOW: 'ture'

env_file: 从文件中获取环境变量，可以指定一个文件路径或路径列表，其优先级低于 environment 指定的环境变量

env_file:
    - ./common.env

expose: 暴露端口，只将端口暴露给连接的服务，而不暴露给主机

expose:
    - "3000"
    - "8000"

network_mode:设置网络模式

network_mode: "bridge"
network_mode: "host"
network_mode: "none"
network_mode: "service:[service name]"
network_mode: "container:[container name/id]"

ports:对外暴露的端口定义，和 expose 对应

ports:   # 暴露端口信息  - "宿主机端口:容器暴露端口"
- "8763:8763"
- "8763:8763"

links:将指定容器连接到当前连接，可以设置别名，避免ip方式导致的容器重启动态改变的无法连接情况

links:    # 指定服务名称:别名 
    - docker-compose-eureka-server:compose-eureka

volumes: 卷挂载路径

volumes:
  - /lib:/ccc
  - /var:/var

healthcheck:用于检测 docker 服务是否健康运行。

healthcheck:
  test: ["CMD", "curl", "-f", "http://localhost"] # 设置检测程序
  interval: 1m30s # 设置检测间隔
  timeout: 10s # 设置检测超时时间
  retries: 3 # 设置重试次数
  start_period: 40s # 启动后，多少秒开始启动检测程序

restart:

• no：是默认的重启策略，在任何情况下都不会重启容器。
• always：容器总是重新启动。
• on-failure：在容器非正常退出时（退出状态非0），才会重启容器。
• unless-stopped：在容器退出时总是重启容器，但是不考虑在Docker守护进程启动时就已经停止了的容器

六. Docker-compose version问题

https://docs.docker.com/compose/compose-file/compose-versioning/

Compose file format	Docker Engine release
3.8	19.03.0+
3.7	18.06.0+
3.6	18.02.0+
3.5	17.12.0+
3.4	17.09.0+
3.3	17.06.0+
3.2	17.04.0+
3.1	1.13.1+
3.0	1.13.0+
2.4	17.12.0+
2.3	17.06.0+
2.2	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1.+