Docker_Dockerfile

Dockerfile

Docker 可以通过读取 Dockerfile 中的指令自动构建镜像。Dockerfile 是一个文本文档,其中包含了用户创建镜像的所有命令和说明。

一、变量要点

  • 变量用 $variable_name 或者 ${variable_name} 表示。
    • ${variable:-word} 表示如果 variable 设置,则结果将是该值。如果 variable 未设置,word 则将是结果。
    • ${variable:+word} 表示如果 variable 设置则为 word 结果,否则为空字符串。

变量前加 \ 可以转义成普通字符串:\$foo 或者 \${foo},表示转换为 $foo 和 ${foo} 文字。

二、FROM 指令

初始化基础镜像(以哪个镜像为基础,继续构建新的镜像)

FROM [--platform=<platform>] <image> [AS <name>]
FROM [--platform=<platform>] <image>[:<tag>] [AS <name>]
FROM [--platform=<platform>] <image>[@<digest>] [AS <name>]
  • 单个 Dockfile 可以多次出现 FROM,以使用之前的构建阶段作为另一个构建阶段的依赖项

  • AS name 表示为构建阶段命名,在后续 FROM 和 COPY --from= 说明中可以使用这个名词,引用此阶段构建的映像

  • digest 其实就是就是根据镜像内容产生的一个 ID,只要镜像的内容不变 digest 也不会变

  • tag 或 digest 值是可选的。如果您省略其中任何一个,构建器默认使用一个 latest 标签。如果找不到该 tag 值,构建器将返回错误。

  • –platform 标志可用于在 FROM 引用多平台镜像的情况下指定平台。例如,linux/amd64、linux/arm64、 或 windows/amd64。

三、RUN指令

  • 在当前镜像之上的新层中执行命令,并创建新层
  • 在 docker build 时运行
RUN /bin/bash -c 'source $HOME/.bashrc; \
echo $HOME'
RUN 有两种语法形式:
  • RUN <command>(shell 形式),命令在 shell 中运行
    • 在 Linux (默认),通过bash执行(/bin/sh -c )
    • 在Windows 上,通过ODS执行(cmd /S /C )
  • RUN [“executable”, “param1”, “param2”](执行形式)
  • 可以使用 \(反斜杠)将单个 RUN 指令延续到下一行
  • RUN 在下一次构建期间,指令缓存不会自动失效。可以使用 --no-cache 标志使指令缓存无效
  • Dockerfile 的指令每执行一次都会在 Docker 上新建一层。所以过多无意义的层,会造成镜像膨胀过大,可以使用 && 符号连接命令,这样执行后,只会创建 1 层镜像

四、CMD 指令

  • 运行程序
  • 在 docker run 时运行

不同于RUN指令,RUN 是在 docker build 时运行。

FROM ubuntu
CMD ["/usr/bin/wc","--help"]
CMD 有三种语法形式:
  • CMD [“executable”,“param1”,“param2”] 使用 exec 执行,推荐方式;
  • CMD command param1 param2 在 /bin/sh 中执行,提供给需要交互的应用;
  • CMD [“param1”,“param2”] 提供给 ENTRYPOINT 的默认参数
  1. 指定启动容器时执行的命令,每个 Dockerfile 只能有一条 CMD 命令。
  2. 如果指定了多条命令,只有最后一条会被执行;
  3. 如果用户启动容器时候指定了运行的命令,则会覆盖掉 CMD 指定的命令。

五、LABEL 添加元数据

LABEL multi.label1="value1" \
      multi.label2="value2" \
      other="value3"

六、EXPOSE 侦听端口

EXPOSE <port> [<port>/<protocol>...]

Docker 容器在运行时侦听指定的网络端口。可以指定端口是监听TCP还是UDP,如果不指定协议,默认为TCP。

该 EXPOSE 指令实际上并未发布端口。要在运行容器时实际发布端口,docker run -P 来发布和映射一个或多个端口。

默认情况下,EXPOSE 假定 TCP。您还可以指定 UDP:

EXPOSE 80/udp

七、 ENV 环境变量

ENV <key>=<value> ...
  • 设置的环境变量将持续存在,不仅存在于后续指令中,甚至是创建的镜像中,也会存在于基于该镜像的容器中
  • 您可以使用 docker inspect 来查看
  • 使用 docker run --env = 来更改环境变量的值

如果环境变量只在构建期间需要,请考虑为单个命令设置一个值:

RUN DEBIAN_FRONTEND=noninteractive apt-get update && apt-get install -y ...

或者使用 ARG,它不会保留在最终镜像中:

ARG DEBIAN_FRONTEND=noninteractive
RUN apt-get update && apt-get install -y ...

八、 COPY 指令

  • 基本语法
COPY [--chown=<user>:<group>] <源路径>... <目标路径>

COPY [--chown=<user>:<group>] ["<源路径1>",... "<目标路径>"]
  • 解释

(1)COPY指令将从构建上下文目录<源路径> 的文件/目录复制到新的一层的镜像内的 <目标路径> 位置 。比如:

COPY package.json /usr/src/app/

如果源路径为文件夹,复制的时候不是直接复制该文件夹,而是将文件夹中的内容复制到目标路径。

(2)<源路径> 可以是多个,甚至可以是通配符,其通配符规则要满足 Go 的 filepath.Match 规则,如:

COPY hom* /mydir/
COPY hom?.txt /mydir/

(3)<目标路径> 可以是容器内的绝对路径,也可以是相对于工作目录的相对路径(工作目录可以用 WORKDIR 指令来指定)。目标路径不需要事先创建,如果目录不存在会在复制文件前先行创建缺失目录。

此外,还需要注意一点,使用 COPY 指令,源文件的各种元数据都会保留。比如读、写、执行权限、文件变更时间等。这个特性对于镜像定制很有用。特别是构建相关文件都在使用 Git 进行管理的时候。

在使用该指令的时候还可以加上--chown=<user>:<group>选项来改变文件的所属用户及所属组。

COPY --chown=55:mygroup files* /mydir/
COPY --chown=bin files* /mydir/
COPY --chown=1 files* /mydir/
COPY --chown=10:11 files* /mydir/

COPY 使用具体事项

  • 源路径可以有多个
  • 源路径是相对于执行build的相对路径
  • 源路径如果是本地路径,必须是build上下文中的路径
  • 源路径如果是一个目录,则该目录下的所有内容都将被加入到容器,但是该目录本身不会
  • 目标路径必须是绝对路径,或相对于WORKDIR的相对路径
  • 目标路径如果不存在,则会创建相应的完整路径
  • 目标路径如果不是一个文件,则必须使用/结束
  • 路径中可以使用通配符

九、ADD 指令

ADD 指令和 COPY 的格式和性质基本一致。

根据Docker 最佳实践的说明,除非需要解压缩功能,否则要尽可能的使用 COPY 指令,因为 COPY 的语义很明确,就是复制文件而已。

如果 <源路径> 为一个 tar 压缩文件的话,压缩格式为 gzip, bzip2 以及 xz 的情况下,ADD 指令将会自动解压缩这个压缩文件到 <目标路径> 去。

FROM scratch
ADD ubuntu-xenial-core-cloudimg-amd64-root.tar.gz /

使用示例:Dockerfile构建Hadoop镜像

FROM chegva.com/online/sre-centos7-base-v2:stable

MAINTAINER anzhihe <anzhihe@xx.com>

#ENV HADOOP_USER_NAME=chegva_arch \
#   HADOOP_USER_PASSWORD=xxx

RUN rm -f /var/lib/rpm/__db* && rpm --rebuilddb \
    && yum install -y --enablerepo=chegva_hadoop chegva-hive-nmg \
    && yum install -y --enablerepo=chegva_hadoop chegva-hadoop-nmg \
    && yum clean all && useradd -m chegva_arch

#添加ssh认证文件    
COPY ssh /home/chegva/.ssh/
COPY ssh /home/chegva_arch/.ssh/

RUN echo "export HADOOP_USER_NAME=chegva_arch" >> /etc/profile \
    && echo "export HADOOP_USER_PASSWORD=xxx" >> /etc/profile \  
    && chown -R chegva.chegva /home/chegva && chmod 700 /home/chegva/.ssh \
    && chmod 600 /home/chegva/.ssh/{id_rsa,authorized_keys} \
    && chown -R chegva_arch.chegva_arch /home/chegva_arch && chmod 700 /home/chegva_arch/.ssh \
    && chmod 600 /home/chegva_arch/.ssh/{id_rsa,authorized_keys}
    
# 文件目录
# ├── Dockerfile
# └── ssh
#     ├── authorized_keys
#     ├── id_rsa
#     └── id_rsa.pub

十、 ENTRYPOINT 指令

ENTRYPOINT 和 CMD 一样,都是在指定容器启动程序及参数,不过它不会被 docker run 的命令行参数指定的指令所覆盖

如果要覆盖的话,需要通过 docker run --entrypoint 来指定。

它有2种格式:

ENTRYPOINT ["executable", "param1", "param2"]
ENTRYPOINT command param1 param2

指定了 ENTRYPOINT 后, CMD 的内容作为参数传给 ENTRYPOINT 指令,实际执行时,将变为:

<ENTRYPOINT> <CMD>

十一、VOLUME 指令

创建一个具有指定名称的挂载数据卷。

VOLUME ["/var/log/"]
VOLUME /var/log

它的主要作用是:

  • 避免重要的数据,因容器重启而丢失

  • 避免容器不断变大

十二、ARG 指令

定义变量,与 ENV 作用相同,不过 ARG 变量不会像 ENV 变量那样持久化到构建好的镜像中,仅影响构建过程中,后续的指令。

ARG <name>[=<default value>]

Docker 有一组预定义的 ARG 变量,您可以在 Dockerfile 中没有相应指令的情况下使用这些变量。

  • HTTP_PROXY

  • http_proxy

  • HTTPS_PROXY

  • https_proxy

  • FTP_PROXY

  • ftp_proxy

  • NO_PROXY

  • no_proxy

要使用这些,请使用 --build-arg 标志在命令行上传递它们,例如:

docker build --build-arg HTTPS_PROXY=https://my-proxy.example.com .

十三、ONBUILD

将一个触发指令添加到镜像中,以便稍后在该镜像用作另一个构建的基础时执行。也就是另外一个 dockerfile FROM 了这个镜像的时候执行。

ONBUILD ADD . /app/src
ONBUILD RUN /usr/local/bin/python-build --dir /app/src

十四、SHELL

  • 覆盖用于命令的 shell 形式的默认 shell。
    • Linux 上的默认 shell 是 ["/bin/sh", “-c”],
    • Windows 上是 [“cmd”, “/S”, “/C”]。
SHELL ["executable", "parameters"]

该 SHELL 指令在 Windows 上特别有用,因为 Windows 有两种常用且截然不同的本机 SHELL:cmd 和 powershell,以及可用的备用 shell,包括 sh。该 SHELL 指令可以出现多次。每条 SHELL 指令都会覆盖所有先前的 SHELL 指令,并影响所有后续指令。

十五、WORKDIR

  • 工作目录,如果 WORKDIR 不存在,即使它没有在后续 Dockerfile 指令中使用,它也会被创建。

  • docker build 构建镜像过程中,每一个 RUN 命令都会新建一层。只有通过 WORKDIR 创建的目录才会一直存在。

  • 可以设置多个 WORKDIR,如果提供了相对路径,它将相对于前一条 WORKDIR 指令的路径。例如:

WORKDIR /a
WORKDIR b
WORKDIR c
RUN pwd
# 最终 pwd 命令的输出是 /a/b/c。

该 WORKDIR 指令可以解析先前使用 ENV,例如:

ENV DIRPATH=/path
WORKDIR $DIRPATH/$DIRNAME
RUN pwd

# 最终 pwd 命令的输出是 /path/$DIRNAME。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值