Docker Compose

Posted 2020-10-03

compose项目简介

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

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

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

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

安装Docker-compose

先安装pip

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

[[email protected] ~]# wget  https://bootstrap.pypa.io/get-pip.py

--2017-08-18 17:38:58--  https://bootstrap.pypa.io/get-pip.py

Resolving bootstrap.pypa.io (bootstrap.pypa.io)... 151.101.72.175

Connecting to bootstrap.pypa.io (bootstrap.pypa.io)|151.101.72.175|:443... connected.

HTTP request sent, awaiting response... 200 OK

Length: 1595408 (1.5M) [text/x-python]

Saving to: ‘get-pip.py’

 

100%[===============================================================================================>] 1,595,408    177KB/s   in 7.5s   

 

2017-08-18 17:39:13 (207 KB/s) - ‘get-pip.py’ saved [1595408/1595408]

 
[[email protected] ~]# python get-pip.py

Collecting pip

  Downloading pip-9.0.1-py2.py3-none-any.whl (1.3MB)

    100% |████████████████████████████████| 1.3MB 65kB/s

Collecting wheel

  Downloading wheel-0.29.0-py2.py3-none-any.whl (66kB)

    100% |████████████████████████████████| 71kB 86kB/s

Installing collected packages: pip, wheel

Successfully installed pip-9.0.1 wheel-0.29.0

 再安装compose

[[email protected] ~]# pip  install docker-compose
[[email protected] ~]# ln -s /usr/bin/docker-compose   /usr/local/bin/

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

[[email protected] ~]# docker-compose  -v

docker-compose version 1.15.0, build e12f3b9

 
[[email protected] ~]# docker-compose  -h

Define and run multi-container applications with Docker.

Usage:

  docker-compose [-f <arg>...] [options] [COMMAND] [ARGS...]

  docker-compose -h|--help

 

Options:

 

术语介绍

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

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

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

 

docker-compose 命令说明

大多数Compose命令都是运行于一个或多个服务的，如果服务没有指定，该命令将会应用到所有服务，如果要获得所有可用信息，使用命令：docker-compose [COMMAND] --help，下面是命令（COMMAND）的说明：

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

 help 

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

 kill 

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

 logs 

显示服务的日志输出

 port 

为端口绑定输出公共信息

 ps 

显示容器

 pull 

拉取服务镜像

 rm 

删除停止的容器

 run 

在服务上运行一个一次性命令，比如： 
docker-compose run web Python manage.py shell

 scale 

设置为一个服务启动的容器数量，数量是以这样的参数形式指定的：service=num，比如： 
docker-compose scale web=2 worker=3

 start 

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

 stop 

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

 up 

为一个服务构建、创建、启动、附加到容器 
连接的服务会被启动，除非它们已经在运行了 

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

 –verbose 

显示更多输出

 –version 

显示版本号并退出

 -f,–file FILE 

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

 -p,–project-name NAME 

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

 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.186  db    

172.17.2.186  database    

172.17.2.186  redis    

 

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

 

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 容器。

上传 Haproxy镜像

[[email protected] src]# docker  load  < centos_haproxy.tar
[[email protected] ~]# docker images

REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE

centos              supervisord         2b911825efb0        32 minutes ago      358.4 MB

centos              haprxoy             047d39960eb2        12 months ago       492.9 MB

docker.io/centos    latest              50dae1ee8677        13 months ago       196.7 MB

 

 

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

[[email protected] ~]# mkdir  -p  /root/docker-haproxy/{haproxy,web}

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

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

 

[[email protected] ~]# cd /root/docker-haproxy/
[[email protected] docker-haproxy]# vim docker-compose.yml

weba:

  image: 2b911825efb0

  volumes:

    - /root/docker-haproxy/web/:/var/www/html/

  expose:

    - 80

webb:

  image: 2b911825efb0

  volumes:

    - /root/docker-haproxy/web/:/var/www/html/

  expose:

    - 80

webc:

  image: 2b911825efb0

  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"

 

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

[[email protected] docker-haproxy]# cd haproxy/
[[email protected] haproxy]# vim  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

 

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

[[email protected] haproxy]# cd .. 
[[email protected] docker-haproxy]# vim web/index.html

duyuheng

~       

目录结构如下图所示：

[[email protected] haproxy]# yum -y install tree
[[email protected] docker-haproxy]# tree .

.
├── docker-compose.yml
├── haproxy
│?? └── haproxy.cfg
└── web
    └── index.html

2 directories, 3 files

运行 compose 项目:

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

[[email protected] docker-haproxy]# docker-compose up  -d

Creating dockerhaproxy_weba_1 ...

Creating dockerhaproxy_webc_1 ...

Creating dockerhaproxy_webb_1 ...

Creating dockerhaproxy_webc_1

Creating dockerhaproxy_webb_1

Creating dockerhaproxy_weba_1 ... done

Creating dockerhaproxy_haproxy_1 ...

Creating dockerhaproxy_haproxy_1 ... done

 查看容器启动情况

[[email protected] docker-haproxy]# docker ps

CONTAINER ID        IMAGE               COMMAND                  CREATED             STATUS              PORTS                                    NAMES

2f4fb3358af8        047d39960eb2        "/usr/local/haproxy/s"   2 minutes ago       Up 2 minutes        0.0.0.0:70->70/tcp, 0.0.0.0:80->80/tcp   dockerhaproxy_haproxy_1

6afd51dafd4f        2b911825efb0        "/usr/bin/supervisord"   2 minutes ago       Up 2 minutes        22/tcp, 80/tcp                           dockerhaproxy_weba_1

aca8d6d7ff81        2b911825efb0        "/usr/bin/supervisord"   2 minutes ago       Up 2 minutes        22/tcp, 80/tcp                           dockerhaproxy_webb_1

879bba0bde32        2b911825efb0        "/usr/bin/supervisord"   2 minutes ago       Up 2 minutes        22/tcp, 80/tcp                           dockerhaproxy_webc_1

或

[[email protected] docker-haproxy]# docker-compose  ps

       Name                    Command            Stat                Ports               

                                                   e                                      

-----------------------------------------------------------------------------------------

dockerhaproxy_hapro   /usr/local/haproxy/sbin/h   Up     0.0.0.0:70->70/tcp,              

xy_1                  a ...                              0.0.0.0:80->80/tcp               

dockerhaproxy_weba_   /usr/bin/supervisord        Up     22/tcp, 80/tcp                   

1                                                                                         

dockerhaproxy_webb_   /usr/bin/supervisord        Up     22/tcp, 80/tcp                   

1                                                                                         

dockerhaproxy_webc_   /usr/bin/supervisord        Up     22/tcp, 80/tcp                   

1                                                                         

 

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

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

本文出自 “duyuheng” 博客，谢绝转载！