05 docker-compose

docker-compose介绍

是docker官方的开源项目，负责实现对docker容器集群的快速编排，从功能上看，跟openstack中的heat十分类似

compose中有两个重要的概念

• 服务（service）：一个应用的容器，实际上可以包括若干运行相同镜像的容器实例
• 项目（project）：由一个关联的应用容器组成一个完整业务单元，在docker-compose.yml文件中定义

安装

$ sudo curl -L https://github.com/docker/compose/releases/download/1.25.5/dockercompose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose
$ sudo chmod +x /usr/local/bin/docker-compose

# 测试
docker-compose version

# 卸载
二进制文件，删除即可

wordpress初体验

version: '3.0'
services:
  mysql:
    image: registry.cn-shanghai.aliyuncs.com/baim0/mysql:5.7
    container_name: mysql
    networks:
      - lnmp
    environment:
      - MYSQL_ROOT_PASSWORD=123
      - MYSQL_DATABASE=wordpress
  php:
    image: registry.cn-shanghai.aliyuncs.com/baim0/php7.1:v1
    container_name: php
    networks:
      - lnmp
    volumes:
      - /wordpress:/usr/share/nginx/html
  nginx:
    image: registry.cn-shanghai.aliyuncs.com/baim0/nginx:youhua
    container_name: nginx
    networks:
      - lnmp
    volumes:
      - /wordpress:/usr/share/nginx/html
    ports:
      - "80:80"
    depends_on:
      - php
networks:
  lnmp:

模板介绍

build

context:指定文件路径
dockerfile:指定文件名
args:指定构建时的变量，有点鸡肋，dockerfile里可以指定

# 案例
version: '3.0'
services:
  web: 
    build:
      context: .
      dockerfile: Dockerfile
      args:
        name: 1

command

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

version: '3.0'
services:
  web:
    build:
      context: .
      dockerfile: Dockerfile
      args:
        name: 1
    command: nginx -g "daemon off"

container_name

指定容器名称，默认将会使用项目名称，服务名称，序号这样的格式,相当于--name

container_name: nginx

depends_on

解决容器的依赖、先后启动的问题，先启动redis，db再启动web

version: '3'
services:
  web:
    build: .
    depends_on:
      - db
      - redis
  redis:
    image: redis
  db:
    image: postgres

env_file

从文件中获取环境变量，如果与environment指令冲突，后者为准，环境变量文件中必须符合指定格式，支持#开头的注释行

env_file: .env
env_file:
 - ./common.env
 - ./apps/web.env
 - /opt/secrets.env

environment

设置环境变量，你可以用数组或者字典格式

environment:
 RACK_ENV: development
 SESSION_SECRET:
environment:
 - RACK_ENV=development
 - SESSION_SECRET

healthcheck

容器的健康检查，配置在每个服务的那一层

version: '2.9'
services:
  mysql:
    image: registry.cn-shanghai.aliyuncs.com/baim0/mysql:5.7
    container_name: mysql
    networks:
      - lnmp
    environment:
      - MYSQL_ROOT_PASSWORD=123
      - MYSQL_DATABASE=wordpress
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost"]
      interval: 1m30s
      timeout: 10s
      retries: 3

image

为指定镜像名称或镜像ID，如果本地不存在，compose将会拉取这个镜像。

image: ubuntu
image: orchardup/postgresql
image: a4bc65fd

networks

配置容器连接的网络，先指定后使用，与service同层指定

version: '2.9'
services:
  nginx:
    image: registry.cn-shanghai.aliyuncs.com/baim0/nginx:youhua
    container_name: nginx
    networks:
      - lnmp
    volumes:
      - /wordpress:/usr/share/nginx/html
    ports:
      - "80:80"
    depends_on:
      - php
networks:
  lnmp:

ports

暴露端口，使用宿主主机端口

ports:
  - "3000"
  - "8000:8000"
  - "49100:22"
  - "127.0.0.1:8001:8001"

sysctls

设置内核参数

sysctls:
  net.core.somaxconn: 1024
  net.ipv4.tcp_syncookies: 0
sysctls:
  - net.core.somaxconn=1024
  - net.ipv4.tcp_syncookies=0

ulimits

指定容器的ulimits限制数，指定最大进程数为65535，指定文件句柄数为20000

 ulimits:
   nproc: 65535
   nofile:
   soft: 20000
   hard: 40000

volumes

数据卷的挂载路径，可以设置为宿主机路径或者数据卷名称，并且可以设置访问模式

volumes:
  - /var/lib/mysql
  - cache/:/tmp/cache
  - ~/configs:/etc/configs/:ro

如果路径时数据卷名称，必须在文件中配置数据卷

version: "3"
services:
  my_src:
  image: mysql:8.0
  volumes:
    - mysql_data:/var/lib/mysql
volumes:
  mysql_data:

常用命令

# 1. 命令对象与格式
docker-compose [COMMAND] --help
# 2. 命令选项
-f, --file FILE 指定使⽤的 Compose 模板⽂件，默认为 docker-compose.yml ，可以多次指定。
-p, --project-name NAME 指定项⽬名称，默认将使⽤所在⽬录名称作为项⽬名。
--x-networking 使⽤ Docker 的可拔插⽹络后端特性
--x-network-driver DRIVER 指定⽹络后端的驱动，默认为 bridge
--verbose 输出更多调试信息。
-v, --version 打印版本并退出。
# 3.命令使⽤说明
1、up
格式为 docker-compose up [options] [SERVICE...] 。
   # 1、该命令⼗分强⼤，它将尝试⾃动完成包括构建镜像，（重新）创建服务，启动服务，并关联服务相关容器的⼀系列操作。
   # 2、链接的服务都将会被⾃动启动，除⾮已经处于运⾏状态。
   # 3、可以说，⼤部分时候都可以直接通过该命令来启动⼀个项⽬。
   # 4、默认情况， docker-compose up 启动的容器都在前台，控制台将会同时打印所有容器的输出信息，可以很
   # 5、⽅便进⾏调试。
   # 5、当通过 Ctrl-C 停⽌命令时，所有容器将会停⽌。
   # 6、如果使⽤ docker-compose up -d ，将会在后台启动并运⾏所有的容器。⼀般推荐⽣产环境下使⽤该选项。
   # 7、默认情况，如果服务容器已经存在， docker-compose up 将会尝试停⽌容器，然后重新创建（保持使⽤ volumes-from 挂载的卷），以保证新启动的服务匹配 docker-compose.yml ⽂件的最新内容
2、down
  此命令将会停⽌ up 命令所启动的容器，并移除⽹络
3、exec
  进⼊指定的容器。
4、ps
格式为 docker-compose ps [options] [SERVICE...] 。
列出项⽬中⽬前的所有容器。
 选项：
   -q 只打印容器的 ID 信息。
5、restart
格式为 docker-compose restart [options] [SERVICE...] 。
重启项⽬中的服务。
选项：
   -t, --timeout TIMEOUT 指定重启前停⽌容器的超时（默认为 10 秒）。
6、rm
格式为 docker-compose rm [options] [SERVICE...] 。
删除所有（停⽌状态的）服务容器。推荐先执⾏ docker-compose stop 命令来停⽌容器。
选项：
   -f, --force 强制直接删除，包括⾮停⽌状态的容器。⼀般尽量不要使⽤该选项。
   -v 删除容器所挂载的数据卷。
7、start
格式为 docker-compose start [SERVICE...] 。
启动已经存在的服务容器。
8、stop
格式为 docker-compose stop [options] [SERVICE...] 。
停⽌已经处于运⾏状态的容器，但不删除它。通过 docker-compose start 可以再次启动这些容器。
选项：
   -t, --timeout TIMEOUT 停⽌容器时候的超时（默认为 10 秒）。
9、top
查看各个服务容器内运⾏的进程。
10、unpause
格式为 docker-compose unpause [SERVICE...] 。
恢复处于暂停状态中的服务。