1 Docker Compose单机编排

Compose面向项目project进行管理，一个项目包含多个服务service，一个服务service就是一个应用容器，实际上可以运行多个相同镜像的实例。
每次编排一个项目，会同时创建项目专用的bridge网络，该网络下的 DNS服务器 127.0.0.11会为容器提供域名解析，一个项目内的容器可以通过service名称直接相互访问。

1.1 安装

sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
或
访问官方GitHub页面 https://github.com/docker/compose/releases 下载二进制文件

chmod +x /usr/local/bin/docker-compose

1.2 Compose 模板文件

默认的模板文件名称为 docker-compose.yml或docker-compose.yaml。
包含version和services两大部分，每个service都必须通过 image 指令指定镜像或 build 指令（需要 Dockerfile）等来自动构建生成镜像。

例子：

version: "3.9"
services:
  web:
    build: .
    ports:
      - "5000:5000"
  redis:
    image: "redis:alpine"

1.2.1 build

指定 Dockerfile 所在文件夹的路径（可以是绝对路径，或者相对 docker-compose.yml文件的路径）。 Compose 将会利用它自动构建这个镜像，然后使用这个镜像。

• 可以使用 context指令指定 Dockerfile 所在文件夹的路径。
• 可以使用 dockerfile 指令指定 Dockerfile 文件名。
• 可以使用 arg 指令指定构建镜像时的变量。

例子：

version: '3'
services:
  webapp:
    build: ./dir

version: '3'
services:
  webapp:
    build:
      context: ./dir
      dockerfile: Dockerfile-alternate
      args:
        buildno: 1

1.2.2 image

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

version: '3'
services:
  webapp:
    image: ubuntu
  ...
    image: centos:centos7
  ...
    image: a4bc65fd

1.2.3 depends_on

容器的依赖、在指定容器启动后再启动。以下例子会先启动 redis db 再启动 web

version: '3'
services:
  web:
    ...
    depends_on:
      - db
      - redis

  redis:
    ...

  db:
    ...

1.2.4 environment

设置环境变量，支持数组或字典两种格式。

version: '3'
services:
  web:
    environment:
      RACK_ENV: development
      SESSION_SECRET: 123456

  db:
    environment:
      - RACK_ENV=development
      - SESSION_SECRET=123456

1.2.5 volumes

数据卷所挂载路径设置

• HOST-DIR:CONTAINER-DIR[:权限]格式

version: '3'
services:
  web:
    volumes:
      - /var/lib/mysql
      - cache/:/tmp/cache
      - ~/configs:/etc/configs/:ro

• volume名字:CONTAINER-DIR[:权限]格式，还需要在Compose文件中配置数据卷

version: '3'
services:
  web:
    volumes:
      - mysql_data:/var/lib/mysql

volumes:
  mysql_data:

1.2.6 ports

暴露端口信息，[宿主机IP:]宿主机端口:容器端口格式，或者仅指定容器的端口，宿主机将使用随机端口。

version: '3'
services:
  web:
    ports:
      - "3000"
      - "8000:8000"
      - "49100:22"
      - "127.0.0.1:8001:8001"

1.2.7 command

覆盖容器启动后默认执行的命令，如果容器运行时使用entrypoint，则command为entrypoint命令后续的参数。

version: '3'
services:
  web:
    command: echo "hello world"

1.2.8 restart

指定容器退出后的重启策略

version: '3'
services:
  web:
    restart: always

1.2.9 network_mode

设置网络模式，使用和 docker run 的 --network 参数一样的值。

version: '3'
services:
  web:
    network_mode: "bridge"
    network_mode: "host"
    network_mode: "none"
    network_mode: "service:[service name]"
    network_mode: "container:[container name/id]"

1.2.10 cap_add, cap_drop

指定容器的内核能力（capacity）分配
例子：让容器拥有所有能力

version: '2.3'
services:
  log:
    cap_add:
      - ALL

例子：让容器去掉某些能力

version: '2.3'
services:
  log:
    cap_drop:
      - CHOWN
      - DAC_OVERRIDE
      - SETGID
      - SETUID

1.2.11 container_name

指定容器名称。默认将会使用 项目目录名称_服务名称_序号 这样的格式。

version: '2.3'
services:
  log:
    container_name: harbor-log

1.2.12 logging

配置日志选项

version: '2.3'
services:
  log:
    logging:
      driver: "syslog"
      options:
        syslog-address: "tcp://localhost:1514"
        tag: "registry"

driver代表日志驱动类型，目前支持3种：

• "json-file"
• "syslog"
• "none"

options配置日志的相关参数

1.3 Compose 命令

1.3.1 up

docker-compose up [options] [SERVICE...]在项目目录下运行，自动完成包括构建镜像，（重新）创建服务，启动服务，并关联服务相关容器
默认情况，docker-compose up 启动的容器都在前台，控制台将会同时打印所有容器的输出信息。如果使用 docker-compose up -d，将会在后台启动并运行所有的容器。
使用docker-compose启动的容器名字为docker-compose.yml所在目录名_service名

选项：

-d                      在后台运行服务容器。
--no-color              不使用颜色来区分不同的服务的控制台输出。
--no-deps               不启动服务所链接的容器。
--force-recreate        强制重新创建容器，不能与 --no-recreate 同时使用。
--no-recreate           如果容器已经存在了，则不重新创建，不能与 --force-recreate 同时使用。
--no-build              不自动构建缺失的服务镜像。
--scale SERVICE=NUM     设置指定服务运行的容器个数
-t, --timeout TIMEOUT   停止容器时候的超时（默认为 10 秒）。

1.3.2 stop

docker-compose stop [options] [SERVICE...]在项目目录下运行，停止已经处于运行状态的容器

1.3.3 start

docker-compose start [SERVICE...]在项目目录下运行，启动已经存在的服务容器

1.3.4 rm

docker-compose rm [options] [SERVICE...]在项目目录下运行，删除所有（停止状态的）服务容器，推荐先执行 docker-compose stop 命令来停止容器

1.3.5 restart

docker-compose restart [options] [SERVICE...]在项目目录下运行，重启项目中的服务。

1.3.6 部署ssh+nginx容器例子

准备项目目录

mkdir ~/ssh_nginx

准备docker-compose.yaml、dockerfile、health_check.sh、init.sh文件

# dockerfile
FROM centos:centos7
RUN mkdir /etc/yum.repos.d/backup \
   && mv /etc/yum.repos.d/*.repo /etc/yum.repos.d/backup \
   && curl -o /etc/yum.repos.d/CentOS-Base.repo http://mirrors.aliyun.com/repo/Centos-7.repo \
   && curl -o /etc/yum.repos.d/epel.repo http://mirrors.aliyun.com/repo/epel-7.repo \
   && yum -y install openssh-server initscripts nginx \
   && /usr/sbin/sshd-keygen
WORKDIR /script
ENV SSH_PWD="123456"
ADD init.sh health_check.sh ./
EXPOSE 22 80
ENTRYPOINT ["/bin/bash", "init.sh"]
HEALTHCHECK --interval=5s --timeout=3s CMD bash health_check.sh

# init.sh
#! /bin/bash
echo $SSH_PWD | passwd --stdin root
/usr/sbin/sshd && /usr/sbin/nginx -g "daemon off;"

# health_check.sh
#! /bin/bash
if curl 127.0.0.1:80 &> /dev/null && ps -ef | grep "/usr/sbin/ssh[d]" > /dev/null ;then
    exit 0
else
    exit 1
fi

# docker-compose.yaml
version: "3.9"
services:
  server1:
    build: ./
    ports:
      - "822:22"
      - "880:80"
    environment:
      SSH_PWD: "centos"

部署容器

cd ~/ssh_nginx && docker-compose up -d

1.3.7 部署wordpress容器例子

准备项目目录

mkdir ~/wordpress

准备docker-compose.yaml

由于项目专用的bridge网络能够提供service名称的DNS解析，所以在参数中可以直接使用service名称，例如WORDPRESS_DB_HOST: db:3306

version: "3.9"
    
services:
  db:
    image: mysql:5.7
    volumes:
      - db_data:/var/lib/mysql
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: somewordpress
      MYSQL_DATABASE: wordpress
      MYSQL_USER: wordpress
      MYSQL_PASSWORD: wordpress
    
  wordpress:
    depends_on:
      - db
    image: wordpress:latest
    volumes:
      - wordpress_data:/var/www/html
    ports:
      - "8000:80"
    restart: always
    environment:
      WORDPRESS_DB_HOST: db:3306
      WORDPRESS_DB_USER: wordpress
      WORDPRESS_DB_PASSWORD: wordpress
      WORDPRESS_DB_NAME: wordpress
volumes:
  db_data: {}
  wordpress_data: {}