docker-compose的安装卸载以及如何使用

一、安装

查看github上的docker-compose发行版本的地址：
https://github.com/docker/compose/tags
当前最新的版本是1.26.2。
安装的命令如下：

# 1.拉取
curl -L "https://github.com/docker/compose/releases/download/1.26.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

# 2.设置文件具备执行权限
chmod +x /usr/local/bin/docker-compose

# 3.查看版本信息
docker-compose -version

实例：

[root@localhost ~]# curl -L "https://github.com/docker/compose/releases/download/1.26.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   638  100   638    0     0   1714      0 --:--:-- --:--:-- --:--:--  1719
100 11.6M  100 11.6M    0     0  22827      0  0:08:56  0:08:56 --:--:-- 24434
[root@localhost ~]# chmod +x /usr/local/bin/docker-compose
[root@localhost ~]# docker-compose -version
docker-compose version 1.26.2, build eefe0d31

二、卸载

# 二进制包方式安装的，删除二进制文件即可
rm /usr/local/bin/docker-compose

三、基本使用

查看命令的基本用法
可以使用docker-compose [命令] --help|-h来实现。
```
docker-compose build -h
```
命令选项如下

-f，–file FILE指定使用的Compose模板文件，默认为docker-compose.yml，可以多次指定。
-p，–project-name NAME指定项目名称，默认将使用所在目录名称作为项目名。
-x-network-driver 使用Docker的可拔插网络后端特性（需要Docker 1.9 及以后版本）
-x-network-driver DRIVER指定网络后端的驱动，默认为bridge（需要Docker 1.9 及以后版本）
-verbose输出更多调试信息
-v，–version打印版本并退出

docker-compose常用命令列表

命令	说明
build	构建项目中的服务容器
help	获得一个命令的帮助
kill	通过发送SIGKILL信号来强制停止服务容器
conﬁg	验证和查看compose文件配置
create	为服务创建容器。只是单纯的create，还需要使用start启动compose
down	停止并删除容器，网络，镜像和数据卷
exec	在运行的容器中执行一个命令
logs	查看服务容器的输出
pause	暂停一个服务容器
port	打印某个容器端口所映射的公共端口
ps	列出项目中目前的所有容器
pull	拉取服务依赖的镜像
push	推送服务镜像
restart	重启项目中的服务
rm	删除所有（停止状态的）服务容器
run	在指定服务上执行一个命令
scale	设置指定服务运行的容器个数
start	启动已经存在的服务容器
stop	停止已经处于运行状态的容器，但不删除它
top	显示运行的进程
unpause	恢复处于暂停状态中的服务
up	自动完成包括构建镜像、创建服务、启动服务并关闭关联服务相关容器的一些列操作
version	打印版本信息

四、常用命令使用

up
格式为：
```
docker-compose up [options] [--scale SERVICE=NUM...] [SERVICE...]
```
up命令十分强大，它尝试自动完成包括构建镜像，（重新）创建服务，启动服务，并关联服务相关容器的一些列操作。链接的服务都将会被自动启动，除非已经处于运行状态。
多数情况下我们可以直接通过该命令来启动一个项目。
选项包括：

-d 在后台运行服务容器
–no-color 不使用颜色来区分不同的服务的控制输出
–no-deps 不启动服务所链接的容器
–force-recreate 强制重新创建容器，不能与–no-recreate同时使用
–no-recreate 如果容器已经存在，则不重新创建，不能与–force-recreate同时使用
–no-build 不自动构建缺失的服务镜像
–build 在启动容器前构建服务镜像
–abort-on-container-exit 停止所有容器，如果任何一个容器被停止，不能与-d同时使用
-t, --timeout TIMEOUT 停止容器时候的超时（默认为10秒）
–remove-orphans 删除服务中没有在compose文件中定义的容器
–scale SERVICE=NUM 设置服务运行容器的个数，将覆盖在compose中通过scale指定的参数
ps
格式为：
```
docker-compose ps [options] [SERVICE...]
```
列出项目中目前的所有容器。
选项包括：

-q 只打印容器的ID信息
stop
格式为：
```
docker-compose stop [options] [SERVICE...]
```
停止已经处于运行状态的容器，但不删除它。
选项包括：

-t, --timeout TIMEOUT 停止容器时候的超时（默认为10秒）
down
格式为：
```
docker-compose down [options]
```
停止和删除容器、网络、卷、镜像，这些内容是通过docker-compose up命令创建的. 默认值删除容器网络，可以通过指定 rmi 、volumes参数删除镜像和卷。
选项包括：

–rmi type 删除镜像，类型必须是: ‘all’: 删除compose文件中定义的所以镜像；‘local’: 删除镜像名为空的
镜像
-v, --volumes 删除已经在compose文件中定义的和匿名的附在容器上的数据卷
–remove-orphans 删除服务中没有在compose中定义的容器

在root目录下，移除root的实例：
```
[root@localhost ~]# docker-compose down
Stopping root_mysql_1 ... done
Stopping root_php_1   ... done
Removing root_mysql_1 ... done
Removing root_php_1   ... done
Removing root_nginx_1 ... done
Removing network root_web-net
```
restart
格式为：
```
docker-compose restart [options] [SERVICE...]
```
重启项目中的服务。
选项包括：

-t, --timeout TIMEOUT 指定重启前停止容器的超时（默认为10秒）
rm
格式为：
```
docker-compose rm [options] [SERVICE...]
```
删除所有（停止状态的）服务容器。
选项包括：

–f, --force 强制直接删除，包括非停止状态的容器
-v 删除容器所挂载的数据卷
start
格式为：
```
docker-compose start [SERVICE...]
```
启动已经存在的服务容器。
run
格式为：
```
docker-compose run [options] [-v VOLUME...] [-p PORT...] [-e KEY=VAL...] SERVICE [COMMAND] [ARGS...]
```
在指定服务上执行一个命令。
例如：
```
docker-compose run ubuntu ping www.baidu.com
```
将会执行一个ubuntu容器，并执行ping www.baidu.com命令。
将会执行一个ubuntu容器，并执行ping www.baidu.com命令。
默认情况下，如果存在关联，则所有关联的服务将会自动被启动，除非这些服务已经在运行中。该命令类似于启动容器后运行指定的命令，相关卷、链接等都会按照配置自动创建。有两个不同点：
1. 给定命令将会覆盖原有的自动运行命令
2. 不会自动创建端口，以避免冲突
  如果不希望自动启动关联的容器，可以使用–no-deps选项，例如：
```
docker-compose run --no-deps web
```
将不会启动web容器关联的其他容器。
选项包括：

-d 在后台运行服务容器
–name NAME 为容器指定一个名字
–entrypoint CMD 覆盖默认的容器启动指令
-e KEY=VAL 设置环境变量值，可多次使用选项来设置多个环境变量
-u, --user="" 指定运行容器的用户名或者uid
–no-deps 不自动启动管理的服务容器
–rm 运行命令后自动删除容器，d模式下将忽略
-p, --publish=[] 映射容器端口到本地主机
–service-ports 配置服务端口并映射到本地主机
-v, --volume=[] 绑定一个数据卷，默认为空
-T 不分配伪tty，意味着依赖tty的指令将无法运行
-w, --workdir="" 为容器指定默认工作目录
conﬁg
格式为：
```
docker-compose config [options]
```
验证并查看compose文件配置。
选项包括：

–resolve-image-digests 将镜像标签标记为摘要
-q, --quiet 只验证配置，不输出。当配置正确时，不输出任何内容，当文件配置错误，输出错误信息
–services 打印服务名，一行一个
–volumes 打印数据卷名，一行一个
kill
格式为：
```
docker-compose kill [options] [SERVICE...]
```
通过发送SIGKILL信号来强制停止服务容器。支持通过-s参数来指定发送的信号，例如：通过如下指令发送SIGINT信号：
```
docker-compose kill -s SIGINT
```
create
格式为：
```
docker-compose create [options] [SERVICE...]
```
为服务创建容器.只是单纯的create，还需要使用start启动compose。
选项包括：

–force-recreate 重新创建容器，即使它的配置和镜像没有改变，不兼容–no-recreate参数
–no-recreate 如果容器已经存在，不需要重新创建. 不兼容–force-recreate参数
–no-build 不创建镜像，即使缺失
–build 创建容器前，生成镜像
exec
格式为：
```
docker-compose exec [options] SERVICE COMMAND [ARGS...]
```
与docker exec 命令功能相同，可以通过service name登陆到容器中。
选项包括：

-d 分离模式，后台运行命令.
–privileged 获取特权.
–user USER 指定运行的用户.
-T 禁用分配TTY. By default docker-compose exec分配 a TTY.
–index=index 当一个服务拥有多个容器时，可通过该参数登陆到该服务下的任何服务，例如：docker-compose exec --index=1 web /bin/bash ，web服务中包含多个容器

五、docker-compose模版文件使用

模板文件是docker-compose的核心。在文件中，可以根据自己的定义，管理多个容器的操作，包括他们的运行，通信等。模板文件的模式名称是docker-compose.yml，格式是YAML合适。
一个模板文件的格式如下

version: "2"
services:

volumes:

networks:

services：
定义应用需要的服务的项目，包括定义服务的名字，镜像，数据卷，所属网络，依赖的其他服务等。
volumes：
这里定义数据卷的名称，供不同服务下的应用使用。
networks：
这里定义网路的名称，供不同的服务下的应用使用。

Docker Compose常用模板文件主要命令：

指令	功能
build	指定服务镜像Dockerﬁle所在路径
cap_add，cap_drop	指定容器的内核能力（capacity）分配
command	覆盖容器启动后默认执行的命令
cgroup_parent	指定父cgroup组，意味着将基础该组的资源限制
container_name	指定容器名称。默认将会使用项目名称服务名称序号这样的格式
devices	指定设置映射关系
dns	自定义DNS服务器。可以是一个值，也可以是一个列表
dns_search	配置DNS搜索域。可以是一个值，也可以是一个列表
dockerﬁle	指定额外编译镜像的Dockerﬁle文件，可以通过该指令来指定
env_ﬁle	从文件中获取环境变量，可以为单独的文件路径或列表
environment	设置环境变量，可以使用数组或字典两种格式
expose	暴露端口
external_links	链接到docker-compose.yml外部的容器，甚至可以是非Compose管理的外部容器
extra_hosts	指定额外的host名称映射信息
image	指定为镜像名称或镜像ID。如果镜像在本地不存在，Compose将会尝试拉取这个镜像
labels	指定服务镜像Dockerﬁle所在路径
links	链接到其他服务中的容器
log_driver	指定日志驱动类型，类似于Docker中的–log-driver参数。目前支持三种日志驱动类型：log_driver:“json-ﬁle”、 log_driver:“syslog”、log_driver:“none”
log_opt	日志驱动的相关参数
net	设置网络模式。参数类似于docker clinet的–net参数一样
pid	跟主机系统共享进程命名空间。打开该选项的容器之间，以及容器和宿主机系统之间可以通过进程ID来相互访问和操作
ports	暴露端口信息
security_opt	指定容器模板标签（label）机制的默认属性（如用户、角色、类型、级别等）
ulimits	指定容器的ulimits限制值
volumes	数据卷所挂载路径设置。可以设置宿主机路径（HOST:CONTAINER）或加上访问模式（HOST:CONTAINER:ro）卷-官方文档

这里展示了一个使用模板文件的实例：

version: '1'
services:
  redis:
    image: redis
    ports:
      - "6379:6379"
    container_name: "redis"
    networks: 
      - dev
  mysql:
    image: centos/mysql-57-centos7
    environment:
      MYSQL_ROOT_PASSWORD: "root"
    ports: 
      - "3306:3306"
    container_name: "mysql"
    networks: 
      - dev
  web:
    image: tomcat
    ports: 
      - "9090:8080"
    container_name: "web"
    networks: 
      - dev
      - pro
networks:
  dev:
    driver: bridge
  pro:
    driver: bridge