docker compose

Docker Compose 项目

compose 项目简介

compose 项目来源于之前的 Fig 项目，使用 python 代码编写。compose 项目主要用于编排部署基于 docker 的应用。本身与 docker／swarm 配合度很高。

DockerCompose 是 Docker 编排服务的一部分，可以让用户在其它平台快速安装 Docker，Swarm 可以让 Docker 容器在集群中高效运转，而 Compose 可以让用户在集群中部署分布式应用。简单的说，Docker Compose 属于一个“应用层”的服务，用户可以定义哪个容器组运行哪个应用，它支持动态改变应用，并在需要时扩展。

相对于 kubernetes 来说功能比较简单，相当于 kubernetes 的一个子集。

dockerfile  可以让用户管理一个单独的应用容器,而 而 Compose 则允许用户在一个模板(yaml 格式)中定义一组相关联的应用容器(被称为一个 Project,即项目),例如一个调度器，两个 web 服务容器再加上后端的 数据库服务容器等。

安装 Compose 之前,要先安装 docker,这里就不说了，

安装 Docker-compose

先安装 pip

注：pip 类似 RedHat 里面的 yum，安装 Python 包非常方便

#wgethttps://bootstrap.pypa.io/get-pip.py

#python get-pip.py

再安装 compose

安装成功后，可以查看 docker-compose 的版本和 命令的用法。

#docker-compose -v

#docker-compose -h

首先介绍几个术语。

服务（service）：一个应用容器，实际上可以运行多个相同镜像的实例。

项目(project)：由一组关联的应用容器组成的一个完整业务单元。

可见，一个项目可以由多个服务（容器）关联而成，Compose 面向项目进行管理。

docker-compose命令说明

大多数 Compose 命令都是运行于一个或多个服务的，如果服务没有指定，该命令将会应用

到所有服务，如果要获得所有可用信息，使用命令： docker-compose [COMMAND] --help ，

下面是命令（COMMAND）的说明：

 

build

创建或者再建服务

服务被创建后会标记为 project_service(比如 composetest_db)，如果改变了一个服务的Dockerfile或者构建目录的内容，可以使用 docker-compose build 来重建它

 

help

显示命令的帮助和使用信息

 

kill

通过发送 SIGKILL 的信号强制停止运行的容器，这个信号可以选择性的通过，比如：

docker-composekill -s SIGKINT

 

logs

显示服务的日志输出

 

port

为端口绑定输出公共信息

 

ps

显示容器

 

pull

拉取服务镜像

 

rm

删除停止的容器

 

run

在服务上运行一个一次性命令，比如：

docker-composerun web Python manage.py shell

scale

设置为一个服务启动的容器数量，数量是以这样的参数形式指定的：service=num，比如：

docker-composescale web=2 worker=3

 

start

启动已经存在的容器作为一个服务

 

stop

停止运行的容器而不删除它们，它们可以使用命令 docker-compose start 重新启动起来

 

up

为一个服务构建、创建、启动、附加到容器

连接的服务会被启动，除非它们已经在运行了

 

运行 docker-compose up -d 会在后台启动容器并使它们运行

 

–verbose

显示更多输出

 

–version

显示版本号并退出

 

-f,–fileFILE

指定一个可选的 Compose yaml 文件（默认：docker-compose.yml）

 

-p,–project-nameNAME

指定可选的项目名称（默认：当前目录名称）

 

docker-compose.yml命令说明

每一个定义在 docker-compose.yml 中的服务必须明确指定一个 image 或者 build 选项，这与docker run 命令行中输入的是对应相同的，对于 docker run，在 Dockerfile 文件中指定的选项（比如 CMD、EXPOSE、VOLUME、ENV）是默认的，因此不必在 docker-compose.yml 中再指定一次

 

image

标明 image 的 ID，这个 image ID 可以是本地也可以是远程的，如果本地不存在，Compose会尝试去 pull 下来

image:ubuntu

image:orchardup/postgresql

image:a4bc65fd

 

build

该参数指定 Dockerfile 文件的路径，该目录也是发送到守护进程的构建环境（这句有点），

Compose 将会以一个已存在的名称进行构建并标记，并随后使用这个 image

build:/path/to/build/dir

 

command

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

command: 要执行的命令

 

links

连接到其他服务中的容器，可以指定服务名称和这个链接的别名，或者只指定服务名称

 

links:

- db

-db:database

- redis

此时，在容器内部，会在/etc/hosts 文件中用别名创建一个条目，就像这样：

172.17.2.186db

172.17.2.186database

172.17.2.186redis

 

环境变量也会被创建，关于环境变量的参数，会在后面讲到

 

external_links

连接到在这个 docker-compose.yml 文件或者 Compose 外部启动的容器，特别是对于提供共享和公共服务的容器。在指定容器名称和别名时，external_links 遵循着和 links 相同的语义用法

external_links:

- redis_1

-project_db_1:mysql

-project_db_1:postgresql

 

ports

暴露端口，指定两者的端口（主机：容器），或者只是容器的端口（主机会被随机分配一个端口）

注：当以 主机:容器 的形式来映射端口时，如果使容器的端口小于 60，那可能会出现错误，因为 YAML 会将 xx:yy 这样格式的数据解析为六十进制的数据，基于这个原因，时刻记得要将端口映射明确指定为字符串

ports:

-"3000"

-"8000:8000"

-"49100:22"

-"127.0.0.1:8001:8001

 

expose

暴露端口而不必向主机发布它们，而只是会向链接的服务（linked service）提供，只有内部端口可以被指定

 expose:

-"3000"

-"8000"

 

volumes

挂载路径最为卷，可以选择性的指定一个主机上的路径（主机：容器），或是一种可使用的模式（主机：容器：ro）

volumes:

-/var/lib/mysql

-cache/:/tmp/cache

-~/configs:/etc/configs/:ro

 

volumes_from:

从另一个服务或容器挂载它的所有卷。

volumes_from:

-service_name

-container_name

 

environment

加入环境变量，可以使用数组或者字典，只有一个 key 的环境变量可以在运行 Compose 的机器上找到对应的值，这有助于加密的或者特殊主机的值

environment:

RACK_ENV:development

SESSION_SECRET:

environments:

-RACK_ENV=development

-SESSION_SECRET

 

env_file

从一个文件中加入环境变量

如果通过 docker-compose -f FILE 指定了模板文件，则 env_file 中路径会基于模板文件路径。如果有变量名称与 environment 指令冲突，则以后者为准。

env_file:.env

env_file:

-./common.env

-./apps/web.env

-/opt/secrets.env

环境变量文件中每一行必须符合格式，支持 # 开头的注释行。

#common.env: Set Rails/Rack environment

RACK_ENV=development

 

net

网络模式，可以在 docker 客户端的--net 参数中指定这些值

net:"bridge"

net:"none"

net:"container:[name or id]"

net:"host"

 

dns

自定义 DNS 服务，可以是一个单独的值或者一张列表

dns:8.8.8.8

dns:

- 8.8.8.8

- 9.9.9.9

 

dns_search

自定义 DNS 搜索范围，可以是单独的值或者一张列表

dns_search:example.com

dns_search:

-dc1.example.com

-dc2.example.com

使用 Compose 只需要简单的三个步骤：

首先，使用 Dockerfile 或 docker commit 来定义你的应用环境

第二步，用一个 docker-compose.yml 来定义你的应用，他们可以在下个互隔离的容器中组成你的应用。

第三步，执行 docker-compose up -d 来启动你的应用，它会根据 docker-compose.yml 的

设置来 pull/run 相关的容器。

测试案例

下面，我们创建一个经典的 Web 项目：一个 Haproxy，挂载三个 Web 容器。

docker-haproxy目录，作为项目工作目录，并在其中分别创建两个子目录： haproxy 和web。

#mkdir -p/root/docker-haproxy/{haproxy,web}

在/root/docker-haproxy/目录下创建 docker-compose.yml 文件

在/root/docker-haproxy/haproxy 目录下创建 haproxy 的主配置文件 haproxy.cfg

在/root/docker-haproxy/web 目录下存放 web 站点网页文件

目录结构如下图所示：

haproxy 目录:

在其中生成一个 haproxy.cfg 文件

global
  log 127.0.0.1 local0
  log 127.0.0.1 local1 notice

defaults
  log global
  mode http
  option httplog
  option dontlognull
  timeout connect 5000ms
  timeout client 50000ms
  timeout server 50000ms

listen stats
    bind 0.0.0.0:70
    stats enable
    stats uri /

frontend balancer
    bind 0.0.0.0:80
    mode http
    default_backend web_backends

backend web_backends
    mode http
    option forwardfor
    balance roundrobin
    server weba weba:80 check
    server webb webb:80 check
    server webc webc:80 check
    option httpchk GET /
    http-check expect status 200

docker-compose.yml

编写 docker-compose.yml 文件，这个是 Compose 使用的主模板文件。内容十分简单，指定 3 个 web 容器，以及 1 个 haproxy 容器。

weba:
  image: 7e3b9e1dad39
  volumes:
    - /root/docker-haproxy/web/:/var/www/html/
  expose:
    - 80

webb:
  image: 7e3b9e1dad39
  volumes:
    - /root/docker-haproxy/web/:/var/www/html/
  expose:
    - 80

webc:
  image: 7e3b9e1dad39
  volumes:
    - /root/docker-haproxy/web/:/var/www/html/
  expose:
    - 80

haproxy:
  image: 047d39960eb2
  volumes:
    - /root/docker-haproxy/haproxy/:/etc/haproxy/:ro
  command: /usr/local/haproxy/sbin/haproxy -f /etc/haproxy/haproxy.cfg
  links:
    - weba
    - webb
    - webc
  ports:
    - "80:80"
    - "70:70"

运行 compose 项目:

在docker-haproxy目录下执行docker-compose up -d 来启动你的应用

#cd docker-haproxy

查看容器启动情况

或

打开浏览器本机本机 IP：http://192.168.157.128

打开浏览器本机本机 IP：http://192.168.157.128：70