Docker-compose

一、docker-compose 简介
我们知道使用一个Dockerfile模板文件可以定义一个单独的应用容器，如果需要定义多个容器就需要服务编排。服务编排有很多种技术方案，今天给大家介绍 Docker 官方产品 Docker Compose 。
docker swarm（管理跨节点）

Dockerfile可以让用户管理一个单独的应用容器；而Compose则允许用户在一个模板（YAML格式）中定义一组相关联的应用容器（被称为一个 project，即项目），例如一个 Web 服务容器再加上后端的数据库服务容器等。

------------------------------------ Docker-compose 简介 ------------------------------------
Docker-Compose项目是Docker官方的开源项目，负责实现对Docker容器集群的快速编排。

Docker-Compose将所管理的容器分为三层，分别是工程（project），服务（service）以及容器（container）。Docker-Compose运行目录下的所有文件（docker-compose.yml，extends文件或环境变量文件等）组成一个工程，若无特殊指定工程名即为当前目录名。一个工程当中可包含多个服务，每个服务中定义了容器运行的镜像、参数、依赖。一个服务当中可包括多个容器实例，Docker-Compose并没有解决负载均衡的问题，因此需要借助其它工具实现服务发现及负载均衡，比如 Consul。

Docker-Compose的工程配置文件默认为docker-compose.yml，可通过环境变量COMPOSE_FILE或-f参数自定义配置文件，其定义了多个有依赖关系的服务及每个服务运行的容器。

使用一个Dockerfile模板文件，可以让用户很方便的定义一个单独的应用容器。在工作中，经常会碰到需要多个容器相互配合来完成某项任务的情况。例如要实现一个Web项目，除了Web服务容器本身，往往还需要再加上后端的数据库服务容器，甚至还包括负载均衡容器等。

Compose允许用户通过一个单独的docker-compose.yml模板文件（YAML 格式）来定义一组相关联的应用容器为一个项目（project）。

Docker-Compose项目由Python编写，调用Docker服务提供的API来对容器进行管理。因此，只要所操作的平台支持Docker API， 就可以在其上利用Compose来进行编排管理。

------------------------------------ compose 部署 ------------------------------------
1. Docker Compose 环境安装
Docker Compose 是 Docker 的独立产品，因此需要安装 Docker 之后在单独安装 Docker Compose

#下载
curl -L https://github.com/docker/compose/releases/download/1.21.1/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
#安装
chmod +x /usr/local/bin/docker-compose
#查看版本
docker-compose --version

2. YAML 文件格式及编写注意事项   * * * *
YAML 是一种标记语言，它可以很直观的展示数据序列化格式，可读性高。类似于 XML数据描述语言，语法比 XML 简单的很多。YAML 数据结构通过缩进来表示，连续的项目通过减号来表示，键值对用冒号分隔，数组用中括号 [] 括起来， hash 用花括号 {} 括起来。

使用 YAML 时需要注意下面事项：
●大小写敏感
●通过缩进表示层级关系
●不支持制表符 tab 键缩进，只能使用空格缩进
●缩进的空格数目不重要，只要相同层级左对齐，通常开头缩进2个空格
●用 # 号注释
●符号字符后缩进1个空格，如冒号 :  、逗号 ,  、横杠 -    
●如果包含特殊字符用单引号('')引起来会作为普通字符串处理，双引号(""): 特殊字符作为本身想表示的意思
name: "Hi,\nTom"

数据结构：
●对象映射: 键值对的字典
animal: pets

●序列数组: 一组按次序排列的列表
- Cat
- Dog
- Goldfish

["Cat", "Dog", "Goldfish"]

●布尔值
debug: true
debug: false

示例：
# yaml 格式
languages:       #序列的映射
  - Java
  - Golang
  - Python
websites:        #映射的映射
  cpu: 2
  memory: 1024M
  swap: 2048M
  disk: 60G 

键：{值}

# Json 格式
{
  languages: [
    'Java',
    'Golang',
    'Python'    
  ],
  resources: {
    cpu: '2',
    memory: '1024M',
    swap: '2048M',
    disk: '60G'
  }
}

Baidu:
  www.baidu.com
wangyi: www.163.com
tengxun: www.qq.com

键 值

school: bei da
  kgc:          (两个空格)
    yunjisuan:
      - dingding
      - benet
      - wanglei
      - zhoubo
      - dalao
    dashuju:
      - lijia
      - chenming
    
    

3. Docker Compose配置常用字段
字段                                       描述
build                                      指定 Dockerfile 文件名，
                                        要指定Dockerfile文件需要在build标签的子级标签中使用dockerfile标签指定
dockerfile                                 构建镜像上下文路径
context                                    可以是 dockerfile 的路径，或者是指向 git 仓库的 url 地址
image                                      指定镜像
command:                                  执行命令，覆盖容器启动后默认执行的命令
container_name                             指定容器名称，由于容器名称是唯一的，如果指定自定义名称，则无法scale指定容器数量
deploy                                     指定部署和运行服务相关配置，只能在 Swarm 模式使用
environment                                添加环境变量
networks                                   加入网络，引用顶级networks下条目
network_mode                            设置容器的网络模式，如 host，bridge，...
ports                                      暴露容器端口，与 -p 相同，但端口不能低于 60
volumes                                    挂载一个宿主机目录或命令卷到容器，命名卷要在顶级 volumes 定义卷名称
volumes_from                            从另一个服务或容器挂载卷，可选参数 :ro 和 :rw，仅版本 '2' 支持
hostname                                   容器主机名
sysctls                                    在容器内设置内核参数
links                                    连接到另外一个容器，- 服务名称[:服务别名]
privileged                                用来给容器root权限，注意是不安全的，true | false
restart                                    设置重启策略，no，always，nounless-st-failure，oped
                                        no，默认策略，在容器退出时不重启容器。
                                        on-failure，在容器非正常退出时（退出状态非0），才会重启容器。
                                        on-failure:3，在容器非正常退出时重启容器，最多重启3次。
                                        always，在容器退出时总是重启容器。
                                        unless-stopped，在容器退出的容器时总是重启容器，但是不考虑在 Docker 守护进程启动时就已经停止了。
depends_on                                                                                                在使用Compose时，最大的好处就是少打启动命令，但一般项目容器启动的顺序是有要求的，如果直接从上到下启动容器，可能会因为容器依赖问题而启动失败。例如在没启动数据库容器的时候启动应用容器，应用容器会因为找不到数据库而退出。depends_on标签用于解决容器的依赖、启动先后的问题。
php:
  depends_on:
    - apache
    - mysql

4. Docker Compose 常用命令
字段                                        描述
build                                       重新构建服务
ps                                          列出容器
up                                          创建和启动容器    
exec                                        在容器里面执行命令
scale                                       指定一个服务容器启动数量
top                                         显示容器进程
logs                                        查看容器输出
down                                        删除容器、网络、数据卷和镜像
stop/start/restart                          停止/启动/重启服务

5. Docker Compose 文件结构
yum install -y tree
tree /opt/compose_nginx
/opt/compose_nginx/
├── docker-compose.yml                #创建模板脚本
├── nginx
│?? ├── Dockerfile                    #创建容器脚本
│?? ├── nginx-1.12.0.tar.gz            #复制源码包
│?? └── run.sh                        #启动服务脚本
└── wwwroot
    └── index.html                    #站点网页