Dockerfile详解

Dockerfile详解

一、Dockerfile

Dockerfile 是一个用来构建镜像的文本文件，文本内容包含了一条条构建镜像所需的指令和说明。

• 可以使用#号指定注释信息
• 文件名一般为Dockerfile
• 可以使用Dockerfile文件来自定义镜像
• 指定base image，基本镜像
• FROM一般为第一行，FROM基本镜像名称:tag版本编号
• 如果本地没有，会自动从docker hub 远程仓库下载，否则直接使用本地仓库提供的

二、基本参数说明

1、FROM

• FROM一般为第一行，FROM基本镜像名称:tag版本编号

FROM python:alpine

2、LABEL

• 使用LABEL指定镜像的元数据信息（提示说明作用）
• LABEL key=value
• 如果value中有空格，需要使用引号括起来或者使用\进行转义

3、COPY

• 用于将宿主机中的资源复制粘贴至容器中
• COPY 宿主机路径 容器中的路径
• 如果容器中指定的路径不存在，会自动创建
• 如果将一个文件复制到容器中，指定的容器路径，建议添加/

COPY . /app

4、ADD

• ADD与COPY类似，用于将宿主机中的资源复制到容器中
• ADD 可以将远程文件下载之后，复制到容器中：ADD 远程文件链接 容器目录
• 也可以将本地的压缩文件解压之后，复制到容器中：ADD 本地压缩文件 容器目录

ADD <https://github.com/docker-library/python/raw/master/update.sh> .

5、WORKDIR

• 相当于cd命令，用于容器进入到某个目录中
• 如果指定的路径不存在，会自动创建

WORKDIR /app

6、RUN

• 用于在容器中执行linux命令
• 每一个RUN指令会独自占一层
• 为了优化镜像的大小，如果有多条命令，可以使用一个RUN指令，多条命令之间&&或者;使用\进行换行

RUN pip install -r requirements.txt

7、ENV

ENV username=Desire\\
    password=123456

8、VOLUME

• 指定容器中哪些目录可以与宿主机进行共享

LABEL maintaier="Desire <desireyang.qq.com>"
LABEL description="define Dockerfile Demo"

9、EXPOSE

• 指定容器中可以暴露的端口

EXPOSE 8000

10、CMD

• 指定容器运行（docker run ）时，默认会执行的命令
• 如果在运行容器时，指定了其他命令，那么CMD命令会被覆盖
• 如果有多个CMD命令，只有最后一个会被执行
• 有两种格式，shell格式、exec格式
• exec格式(常用)：[“命令的绝对路径”,“参数1”,“参数2”]
• shell格式：命令的绝对路径 参数1 参数2

CMD ["python", "fun.py"]
# CMD ["/bin/ls","/","/etc"]
# CMD python fun.py

11、ENTRYPOINT

• 与CMD类似，当运行容器时，如果指定了其他命令，那么ENTRYPOINT不会被覆盖
• 如果有多个ENTRYPOINT，那么只有最后一个ENTRYPOINT会被执行
• 可以与CMD一起用，放在ENTRYPOINT后面，作为ENTRYPOINT默认参数

ENTRYPOINT ["python", "fun.py"]
ENTRYPOINT ["cat", "fun.py"]
CMD ["etc/passwd"]
# 可以指定shell脚本
ENTRYPOINT ["/bin/sh","docker-entrypoint.sh"]

12、ARG

• 构建参数
• 和ENV的效果一样，都是设置环境变量
• ARG所设置的构建环境的环境变量，在将来容器运行时是不会存在这些环境变量的
• 不要因此使用ARG保存密码之类的信息，docker history是可以看到所有值的
• 定义的值可以在docker build中用-build-arg <参数名>=<值>进行覆盖
• 生效范围
  • 如果是在FROM指令之前指定，那么只能用于FROM指令中

# 只在 FROM 中生效
ARG DOCKER_USERNAME=library

FROM ${DOCKER_USERNAME}/alpine

# 要想在 FROM 之后使用，必须再次指定
ARG DOCKER_USERNAME=library

RUN set -x ; echo ${DOCKER_USERNAME}

13、USER

• 指定当前用户
• USER只是帮助切换到指定用户，并不会创建用户

USER root

三、通过Dockerfile文件构建镜像

docker build -t 镜像名:tag -f 指定Dockerfile文件路径 .

• -t 指定构建的镜像名称和tag，如果不指定tag，默认使用latest，镜像名一般为用户名/镜像名称
• -f 指定Dockerfile文件路径，如果命名为Dockerfile，且在当前路径下，那么可以不用指定，否则必须指定
• . 代表将当前路径作为构建上下文

四、完整的Dockerfile文件

FROM python:alpine

LABEL maintaier="Desire <desireyang.qq.com>"
LABEL description="define Dockerfile Demo"

COPY . /app

# ADD <https://github.com/docker-library/python/raw/master/update.sh> .

WORKDIR /app

RUN pip install -r requirements.txt

ENV username=Desire\\
    password=123456

VOLUME /app

# EXPOSE 8000

CMD ["python", "fun.py"]
# CMD ["/bin/ls","/","/etc"]
# CMD python fun.py

# ENTRYPOINT ["python", "fun.py"]
# ENTRYPOINT ["cat", "fun.py"]
# CMD ["etc/passwd"]
# 可以指定shell脚本
# ENTRYPOINT ["/bin/sh","docker-entrypoint.sh"]