Docker-compose

一. 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.+

发表评论

邮箱地址不会被公开。

Captcha Code