目录

一:compose

1.1compose工具的由来

1.2compose概述

二:YAML

2.1YAML简介

2.2YAML支持的数据结构

2.3docker-compose.yml文件的常用字段

2.4Docker compose常用命令

2.5命令使用说明

2.6compose 模板文件指令

三:安装compose

3.1安装docker环境

3.2下载docker-compose安装包

3.3部署docker-compose

3.3.1首先创建一个总目录,再根据下图配置相关内容

3.3.2添加Nginx目录中的配置文件

3.3.3添加docker-compose.yml

3.3.4添加网页

3.3.5tree查看相关配置以完成

3.4验证

3.5使用compose编排 安装运行tomcat容器

四:总结

前言:

现有 docker 进行项目部署存在的问题:

1、为了完成一个完整项目势必用到N多个容器(一个容器只运行一个进程)配合完成项目中业务开发,一旦引入N多个容器,容器之间就会形成某种依赖,也就意味某个容器或某些容器的运行需要其他容器优先启动之后才能正常运行。容器的编排显得至关重要,容器的运行一定要有先后顺序。
2、现在这种方式使用容器,没有办法站在项目的角度将一个项目用到的一组容器划分到一起,日后难点在于项目的多服务器部署。比如项目在当前服务器上运行成功,需要将项目再部署到另一台服务器上,但我们不清楚哪组容器是项目引用的,哪组容器是别的引用的。

一:compose

1.1compose工具的由来

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

使用前面介绍的Dockerfile文件可以很容易定义一个单独的应用容器。然而在日常开发工作中,经常会碰到需要多个容器相互配合来完成某项任务的情况。

例如要实现一个 Web 项目,除了 Web 服务容器本身,往往还需要再加上后端的数据库服务容器;再比如在分布式应用一般包含若干个服务,每个服务一般都会部署多个实例。
如果每个服务都要手动启停,那么效率之低、维护量之大可想而知。这时候就需要一个工具能够管理一组相关联的的应用容器,这就是Docker Compose。

Compose有2个重要的概念:

  • 项目(Project):由一组关联的应用容器组成的一个完整业务单元,在 docker-compose.yml 文件中定义。
  • 服务(Service):一个应用的容器,实际上可以包括若干运行相同镜像的容器实例。

1.2compose概述

  • compose前身是Fig,是一个用于定义及允许多个Docker容器的工具,主要是通过一个YAML文件进行服务配置

  • 使用Docker Compose不再需要使用Shell脚本来启动容器

  • Docker Compose非常适合组合使用多个容器进行开发的场景

使用Compose 基本上分为三步:

1. Dockerfile      定义应用的运行环境
2. docker-compose.yml 定义组成应用的各服务
3. docker-compose up 启动整个应用


二:YAML

2.1YAML简介

YAML(语言)的设计目标,就是方便人类读写,它实质上是一种通用的数据串行化格式

它的基本语法规则如下:

  • 大小写敏感
  • 使用缩进表示层级关系
  • 缩进时不允许使用Tab键,只允许使用空格
  • 缩进的空格数目不重要,只要相同层级的元素左侧对齐即可

#表示注释

2.2YAML支持的数据结构

  • 对象,键值对的集合
  • 数组,一组按次序排列的值,又称序列
  • 纯量,单个的,不可再分的值

2.3docker-compose.yml文件的常用字段

具体使用会在下面的docker-compose部署中展示:

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

2.4Docker compose常用命令

docker-compose -h                           # 查看帮助
docker-compose up                           # 创建并运行所有容器
docker-compose up -d                        # 创建并后台运行所有容器
docker-compose ps                           # 显示所用容器信息
docker-compose -f docker-compose.yml up -d  # 指定模板
docker-compose down                         # 停止并删除容器、网络、卷、镜像。
docker-compose rm                           # 删除容器
docker-compose logs                         # 查看容器输出日志
docker-compose pull                         # 拉取依赖镜像
dokcer-compose config                       # 检查配置
dokcer-compose config -q                    # 验证yaml配置文件是否正确,有问题才有输出
docker-compose pause                        # 暂停容器
docker-compose unpause                      # 恢复暂停
docker-compose restart                      # 重启服务
docker-compose start                        # 启动服务
docker-compose stop                         # 停止服务
docker-compose [options] [COMMAND] [ARG...]

//docker-compose选项:
  --verbose输出更多调试信息
  --version打印版本并退出
  -f, -file FILE使用特定的compose模板文件,默认为docker-compose.yml
  -p, --project-name NAME指定项目名称,默认使用目录名称
//举例:
docker-compose -f docker-compose.yml up -d
字段描述
build重新构建服务
ps列出容器
up创建和启动
exec在容器里执行命令
scale指定一个一定服务容器启动数量
top显示容器进程
logs查看容器输出
down删除容器、网络、数据卷和镜像
stop/start/restart停止/启动/重启服务

2.5命令使用说明

up

命令格式为 :
docker-compose up [options] [SERVICE...]

选项说明:
-d 在后台运行服务容器。
--no-color 不使用颜色来区分不同的服务的控制台输出。
--no-deps 不启动服务所链接的容器。
--force-recreate 强制重新创建容器,不能与 --no-recreate 同时使用。
--no-recreate 如果容器已经存在了,则不重新创建,不能与 --force-recreate 同时使用。
--no-build 不自动构建缺失的服务镜像。
-t, --timeout TIMEOUT 停止容器时候的超时(默认为 10 秒)。

该命令十分强大,它将尝试自动完成包括构建镜像,(重新)创建服务,启动服务,并关联服务相关容器的一系列操作。

链接的服务都将会被自动启动,除非已经处于运行状态。
可以说,大部分时候都可以直接通过该命令来启动一个项目。

默认情况,docker-compose up 启动的容器都在前台,控制台将会同时打印所有容器的输出信息,可以很方便进行调试。

当通过 Ctrl-C 停止命令时,所有容器将会停止。

如果使用 docker-compose up -d,将会在后台启动并运行所有的容器。一般推荐生产环境下使用该选项。

如果服务容器已经存在,docker-compose up 将会尝试停止容器,然后重新创建(保持使用 volumes-from 挂载的卷),以保证新启动的服务匹配 docker-compose.yml 文件的最新内容。

当使用 docker-compose up 服务id,就是对当前项目中的容器服务进行操作

down

docker-compose down:
此命令将会停止up命令所启动的容器,并移除网络,但不会移除数据卷。

docker-compose down 服务id:
停止某个服务。
exec

进入指定的容器。
docker-compose exec 服务id /bin/bash
ps

列出项目中目前的所有容器。
docker-compose ps [options] [SERVICE...]

选项说明:
-q 只打印容器的 ID 信息。
restart

重新启动所有已停止并正在运行的服务。
docker-compose restart [options] [SERVICE...]

选项:
-t, --timeout TIMEOUT 指定重启前停止容器的超时(默认为 10 秒)。
rm

删除所有(停止状态的)服务容器。推荐先执行 docker-compose stop 命令来停止容器。
docker-compose rm [options] [SERVICE...]

选项:
-f, --force 强制直接删除,包括非停止状态的容器。一般尽量不要使用该选项。
-v    删除容器所挂载的数据卷。
top

查看项目中各个服务容器内运行的进程。
如果加上服务id,就是查看项目中指定服务容器的进程
logs

查看服务容器的输出。默认情况下,docker-compose 将对不同的服务输出使用不同的颜色来区分。可以通过 --no-color 来关闭颜色。

查看项目中指定服务的日志:
docker-compose logs 服务id

注:上面的 服务id 代表 docker-compose.yml 文件中的服务名
unpause 和 pause

pause:暂停一个服务容器。
docker-compose pause [SERVICE...]

unpause :恢复处于暂停状态中的服务。
docker-compose unpause [SERVICE...]

2.6compose 模板文件指令

模板文件是使用 Docker Compose 的核心,涉及到的指令关键字也比较多。默认的模板文件名称为 docker-compose.yml ,格式为YAML 格式。一个 docker-compose.yml 文件可以分为三层:

#第一层 版本号
version: "3"  #代表使用docker-compose项目的版本号
#第二层:services 服务配置
services:
  web:
    build: .
    ports:  #宿主机和容器的端口映射
      - "5000:5000"
    volumes:
      - .:/code
  redis:
     image: "redis:alpine"
# 第三层 其他配置 网络、卷、全局规划

build 指令

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

version: "3.8" 
services:
  web:
    build: .  #指定Dockerfile的上下文目录为当前目录

你也可以使用 context 指令指定 Dockerfile 所在文件夹的路径。

使用 dockerfile 指令指定 Dockerfile 文件名。

使用 arg 指令指定构建镜像时的变量。

version: '3'
services:
 
  webapp:
    build:
      context: ./dir #定Dockerfile的上下文目录为当前目录的dir目录下
      dockerfile: Dockerfile-alternate
      args: 
        buildno: 1

command 指令

覆盖容器启动后默认执行的命令,类似于docker run image 命令

以下面的Dockerfile文件为例,容器启动后执行的是 java -jar apps.jar

FROM openjdk:8-jre
EXPOSE 8081
ENV APP_PATH=/apps
WORKDIR $APP_PATH
COPY apps.jar $APP_PATH
ENTRYPOINT ["java","-jar"]
CMD ["apps.jar"]

如果我们想要容器启动后执行的是 java -jar test.jar,在docker-compose.yml文件中使用指令 command: [“test.jar”]

version: '3'
services:
  webapp:
    build:
      context: ./dir #定Dockerfile的上下文目录为当前目录的dir目录下
      dockerfile: Dockerfile-alternate
      args: 
        buildno: 1
    command: ["test.jar"]

container   name 指令(不推荐使用)

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

注意: 指定容器名称后,该服务将无法进行扩展(scale),因为 Docker 不允许多个容器具有相同的名称。

depends_on 指令

解决容器的依赖、启动先后的问题。以下例子中会先启动 redis 、db 再启动 web

version: '3'
services:
  web:
    build: .
    depends_on: # web服务依赖于db和web服务
      - db
      - redis
  redis:
    image: redis
  db:
    image: postgres

注意:在启动web服务时,并不会等待 redis 、db 服务进入ready状态,而只是等到它们被启动状态(running状态)了。

environment 指令

设置环境变量,相当于 docker run -e。你可以使用数组或字典两种格式。

只给定名称的变量会自动获取运行 Compose 主机上对应变量的值,可以用来防止泄露不必要的数据。

version: '3'
services:
  mysql:
    image: mysql:5.7
    ports:
      - "3306:3306"
    environment:
      MYSQL_ROOT_PASSWORD: root  #字典格式 
#====================================================
    environment:
      - "MYSQL_ROOT_PASSWORD=root"  #数组格式
      - "SESSION_SECRET"

image 指令

指定为镜像名称或镜像 ID。如果镜像在本地不存在,Compose 将会尝试拉取这个镜像,相当于 docker run image(镜像名)。

networks 指令

指定启动容器时使用的网络,相当于 docker run --network

version: "3"
services:
  some-service:
    networks:
     - some-network  #指定使用的网络
     - other-network
networks:   #创建网络
  some-network:
  other-network:

ports 指令

指定宿主机和容器端口映射,或者仅仅指定容器的端口(宿主将会随机选择端口)都可以。

注意:当使用 HOST:CONTAINER 格式来映射端口时,如果你使用的容器端口小于 60 并且没放到引号里,可能会得到错误结果,因为YAML会自动解析 xx:yy 这种数字格式为 60 进制。为避免出现这种问题,建议数字串都采用引号包括起来的字符串格式

volumes 指令

用来指定宿主机目录和容器目录映射或挂载宿主机路径或命令卷

version: "3"
 
services:
  my_src:
    image: mysql:8.0
    volumes:  #数据卷名称挂载
      - mysql_data:/var/lib/mysql
         宿主机目录:容器目录
volumes:  #定义数据卷名称
  mysql_data:

restart 指令

指定容器退出后的重启策略为始终重启。该命令对保持服务始终运行十分有效。

restart: always

三:安装compose

链接:docker-compose
提取码:y7c6

3.1安装docker环境

docker 部署在这里不做介绍,有需要的可以看我这篇博客:docker安装部署及优化详解

3.2下载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

3.3部署docker-compose

//可以在任何目录下使用compose命令
cp -p docker-compose /usr/local/bin
chmod +x docker-compose
[root@localhost ~]# docker-compose -v
docker-compose version 1.21.1, build 5a3f1a3

3.3.1首先创建一个总目录,再根据下图配置相关内容

mkdir /root/compose_nginx
cd /root/compose_nginx
yum install -t tree
tree
.
├── docker-compose.yml
├── nginx
│   ├── Dockerfile
│   ├── nginx-1.12.2.tar.gz
│   └── run.sh
└── wwwroot
    └── index.html

3.3.2添加Nginx目录中的配置文件

mkdir nginx
mkdir wwwroot
cd nginx/

cat Dockerfile 
FROM centos:7
MAINTAINER this is nginx
RUN yum -y update
RUN yum install -y gcc gcc-c++ make pcre-devel zlib-devel
RUN useradd -M -s /sbin/nologin nginx
ADD nginx-1.12.2.tar.gz /opt/
WORKDIR /opt/nginx-1.12.2/
RUN ./configure --prefix=/usr/local/nginx --user=nginx --group=nginx --with-http_stub_status_module && make && make install
ENV PATH /usr/local/nginx/sbin:$PATH
EXPOSE 443
EXPOSE 80
RUN echo "daemon off;" >> /usr/local/nginx/conf/nginx.conf
ADD run.sh /run.sh
RUN chmod 775 /run.sh
CMD ["/run.sh"]

3.3.3添加docker-compose.yml

vim docker-compose.yml 
version: '3'
services:
  nginx:
    hostname: nginx
    build:
      context: ./nginx
      dockerfile: Dockerfile
    ports:
      - 1233:80
      - 1255:443
    networks:
      - abc
    volumes:
      - ./wwwroot:/usr/local/nginx/html
networks:
  abc:

[root@localhost~/compose_nginx] # cd nginx
[root@localhost~/compose_nginx/nginx] # vim run.sh
[root@localhost~/compose_nginx/nginx] # cat run.sh
#!/bin/bash
/usr/local/nginx/sbin/nginx

3.3.4添加网页

[root@localhost wwwroot]# touch index.html
[root@localhost wwwroot]# echo "ming zhen tan ke nan" > index.html
[root@localhost wwwroot]# cat index.html
ming zhen tan ke nan

3.3.5tree查看相关配置以完成

3.4验证

使用compose编排,安装运行nginx容器

docker-compose -f docker-compose.yml up -d

查看镜像和容器显示创建成功,我们可以访问服务

3.5使用compose编排 安装运行tomcat容器

软件包:apache-tomcat-9.0.16.tar.gz、jdk-8u91-linux-x64.tar.gz
提取码:a9p6

例:

cd /opt
mkdir compose-tomcat
cd compose-tomcat
mkdir tomcat
cd tomcat
==拖入安装包apache-tomcat-9.0.16.tar.gz 、jdk-8u91-linux-x64.tar.gz==

vim Dockerfile
FROM centos:7
MAINTAINER LIC:<935704787@qq.com>

ADD apache-tomcat-9.0.16.tar.gz /usr/local
ADD jdk-8u91-linux-x64.tar.gz /usr/local

WORKDIR /usr/local

RUN mv apache-tomcat-9.0.16 tomcat
RUN mv jdk1.8.0_91 java

ENV JAVA_HOME /usr/local/java
ENV CLASSPATH $JAVA_HOME/lib/tools.jar:$JAVA_HOME/lib/dt.jar
ENV PATH $JAVA_HOME/bin:$PATH

EXPOSE 8080
CMD ["/usr/local/tomcat/bin/catalina.sh","run"]

====>:wq

cd ..
vim tomcat-compose.yml

version: '3'
services:
 tomcat:
  hostname: tomcat
  build :
   context: ./tomcat
   dockerfile: Dockerfile
  ports:
   - 7788:8080
  networks:
   - cluster
networks:
 cluster:

====>:wq

docker-compose -f tomcat-compose.yml up -d

==真机访问http://IP:7788==


四:总结

docker-compose默认的模板文件是 docker-compose.yml,其中定义的每个服务都必须通过 image 指令指定镜像或 build 指令(需要 Dockerfile)来自动构建。

其它大部分指令都跟 docker run 中的类似。

如果使用 build 指令,在 Dockerfile 中设置的选项(例如:CMD, EXPOSE, VOLUME, ENV 等) 将会自动被获取,无需在 docker-compose.yml 中再次设置。

docker-compose分三层:project,service,container

project:代表多个service组成的项目,默认是用工作目录的名称作为project的工程名称
service:一个 service 可以包含一个或多个容器,在里面可以定义网络模式端口镜像数据卷等参数
container:可以直接由一个已存在的镜像运行实现,也可以通过dockerfile构建镜像实现

Logo

权威|前沿|技术|干货|国内首个API全生命周期开发者社区

更多推荐