使用docker-compose实现一个简单应用(基于官方文档)

前言

之前使用创建docker container都是一点一点输入命令,麻烦并且容易忘了设置了什么,docker compose可以实现write once,run anywhere,值得学习,特此做下总结

简介

compose是定义和运行多容器docker应用的工具,使用compose,通过YAML文件配置你的服务.然后通过单个命令就能启动所有容器.(一般一组容器一起组成一个完成的应用)

使用流程

1. 在Dockerfile中编写自定义容器的依赖处理和启动流程
2. 在docker-compose.yml中定义所有的服务,之后它们一起运行组成一个应用
3. docker-compose up

官方示例与解释

官方示例真的是足够简单了,不再赘述,我这里遇到一点问题 http://0.0.0.0:5000不能访问,改成127.0.0.1:5000就可以了

1. Dockerfile

编写Dockerfile,根据自己的需要构建docker image
Dockerfile中的指令会被解释运行,所有指令一起完成自定义docker image的构建

FROM python:3.4-alpine #1
ADD . /code #2
WORKDIR /code #3
RUN pip install -r requirements.txt #4
CMD ["python", "app.py"] #5

下面分条讲解

1. FROM <image>[:<tag>]
   指定基础镜像,后续的命令都是在这个基础镜像上进行修改
2. ADD src dest
   ADD指令将src指向的文件/目录/url执行的文件复制到镜像内的dest目录下
3. WORKDIR /path/to/workdir
   WORKDIR指令设置工作目录,后续的指令如RUN CMD ENTRYPOINT 会以此为工作目录,这条指令一直作用到被修改或Dockerfile结束(PS.工作目录可以这样理解,有些指令需要知道它是在那个目录里运行的,如果你没有指定,工作目录就作为默认值传递给这些指令)
4. RUN <command> 或 RUN ["executable","param1","param2"]
   RUN指令执行给定的command,它的作用类似于转义,如在linux中执行下面命令ls,写在Dockerfile里就会是RUN ls. 如果要运行多个命令,不需要使用多个RUN,使用

RUN command1; \
command2;

或

RUN command1; command2;

请注意,使用上面这种格式时,使用的shell为/bin/bash,如果要使用不同的shell,请使用 RUN ["executable","param1","param2"],这种格式的RUN会被解析为JSON array,因此需要用双引号包裹

5. CMD ["executable","param1","param2"] 或CMD ["param1","param2"]或CMD command param1 param2
   和RUN基本相同,但是CMD在Dockerfile中只能出现一次,如果有多个只有最后一个会生效,一般用作最后的启动命令

RUN和CMD有execform和shellform,execform并没有调用shell,因此很多shell相关的东西是用不了的,比如RUN ["echo","$HOME"] ,这里的HOME是未定义的

docker-compose.yml

这个文件定义了应用运行需要的所有service

version: '3' #1
services: #2
  web: #3
    build: . #4
    ports: #5
     - "5000:5000"
    volumes: #6
     - .:/code
  redis:
    image: "redis:alpine" #7

1. version: '<version>'
   指定docker-compose.yml的版本,现在有1,2,3三个版本

2. services:
   service定义的入口,固定写死的.

3. <serivceName>:
   服务名称,随意命名

4. build /path/to/build/context
   根据给定的构建上下文目录构建镜像,当镜像是自己构建的时候会使用这个指令

5. ports: -"HOST:CONTAINER"
   将容器内的端口映射到宿主机,格式很多.如下

ports:
 - "3000"
 - "3000-3005"
 - "8000:8000"
 - "9090-9091:8080-8081"
 - "49100:22"
 - "127.0.0.1:8001:8001"
 - "127.0.0.1:5000-5010:5000-5010"
 - "6060:6060/udp"

6. volumes: - src:dest
   将宿主机目录src映射到容器内目录dest
7. image:"image:tag"

指定服务使用的image,当我们使用通用容器如redis,mysql等服务时,一般就用这个.

docker-compose 的常用命令

docker-compose up

启动应用

docker-compose down

关闭并移除应用

docker-compose stop

停止应用但不移除

docker-compose restart

重启应用

docker-compose logs [service]

打印服务日志,注意这里的service是docker-compose.yml中定义的名称

λ docker-compose logs -f web
Attaching to composetest_web_1
web_1    |  * Serving Flask app "app" (lazy loading)
web_1    |  * Environment: production
web_1    |    WARNING: Do not use the development server in a production environment.
web_1    |    Use a production WSGI server instead.
web_1    |  * Debug mode: on
web_1    |  * Running on http://0.0.0.0:5000/ (Press CTRL+C to quit)
web_1    |  * Restarting with stat
web_1    |  * Debugger is active!
web_1    |  * Debugger PIN: 175-839-223

docker-compose ps

显示服务运行状态

λ docker-compose ps
系统找不到指定的路径。
       Name                      Command               State           Ports
-------------------------------------------------------------------------------------
composetest_redis_1   docker-entrypoint.sh redis ...   Up      6379/tcp
composetest_web_1     python app.py                    Up      0.0.0.0:5000->5000/tcp

具体参见docker compose cli

---

Dockerfile官方文档