Dockerfile配置说明写法

本文详细解析Dockerfile中的关键指令,包括FROM、MAINTAINER、RUN、CMD、EXPOSE等,介绍了每个指令的作用及用法,帮助读者理解并掌握Docker镜像构建的核心过程。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

1 FROM

指明构建的新镜像是来自于哪个基础镜像,例如:

FROM centos:6

2 MAINTAINER

指明镜像维护着及其联系方式(一般是邮箱地址),例如:

MAINTAINER Edison Zhou

不过,MAINTAINER并不推荐使用,更推荐使用LABEL来指定镜像作者,例如:

LABEL maintainer="edisonzhou.cn"

3 RUN

构建镜像时运行的Shell命令,例如:

RUN ["yum", "install", "httpd"]
RUN yum install httpd

又如,我们在使用微软官方ASP.NET Core Runtime镜像时往往会加上以下RUN命令,弥补无法在默认镜像下使用Drawing相关接口的缺憾:

FROM microsoft/dotnet:2.2.1-aspnetcore-runtime
RUN apt-get update
RUN apt-get install -y libgdiplus
RUN apt-get install -y libc6-dev
RUN ln -s /usr/lib/libgdiplus.so /lib/x86_64-linux-gnu/libgdiplus.so

4 CMD

启动容器时执行的Shell命令,例如:

CMD ["-C", "/start.sh"] 
CMD ["/usr/sbin/sshd", "-D"] 
CMD /usr/sbin/sshd -D

5 EXPOSE

声明容器运行的服务端口,例如:

EXPOSE 80 443

6 ENV

设置环境内环境变量,例如:

ENV MYSQL_ROOT_PASSWORD 123456
ENV JAVA_HOME /usr/local/jdk1.8.0_45

7 ADD

拷贝文件或目录到镜像中,例如:

ADD <src>...<dest>
ADD html.tar.gz /var/www/html
ADD https://xxx.com/html.tar.gz /var/www/html

PS:如果是URL或压缩包,会自动下载或自动解压。

8 COPY

拷贝文件或目录到镜像中,用法同ADD,只是不支持自动下载和解压,例如:

COPY ./start.sh /start.sh

9 ENTRYPOINT

启动容器时执行的Shell命令,同CMD类似,只是由ENTRYPOINT启动的程序不会被docker run命令行指定的参数所覆盖,而且,这些命令行参数会被当作参数传递给ENTRYPOINT指定指定的程序,例如:

ENTRYPOINT ["/bin/bash", "-C", "/start.sh"]
ENTRYPOINT /bin/bash -C '/start.sh'

PS:Dockerfile文件中也可以存在多个ENTRYPOINT指令,但仅有最后一个会生效。

10 VOLUME

指定容器挂载点到宿主机自动生成的目录或其他容器,例如:

VOLUME ["/var/lib/mysql"]

PS:一般不会在Dockerfile中用到,更常见的还是在docker run的时候指定-v数据卷。

11 USER

为RUN、CMD和ENTRYPOINT执行Shell命令指定运行用户,例如:

USER <user>[:<usergroup>]
USER <UID>[:<UID>]
USER edisonzhou

12 WORKDIR

为RUN、CMD、ENTRYPOINT以及COPY和AND设置工作目录,例如:

WORKDIR /data

13 HEALTHCHECK

告诉Docker如何测试容器以检查它是否仍在工作,即健康检查,例如:

HEALTHCHECK --interval=5m --timeout=3s --retries=3 \
CMD curl -f http:/localhost/ || exit 1

其中,一些选项的说明:

 --interval=DURATION (default: 30s):每隔多长时间探测一次,默认30秒
 -- timeout= DURATION (default: 30s):服务响应超时时长,默认30秒
 --start-period= DURATION (default: 0s):服务启动多久后开始探测,默认0秒
 --retries=N (default: 3):认为检测失败几次为宕机,默认3次

一些返回值的说明:

0:容器成功是健康的,随时可以使用
1:不健康的容器无法正常工作
2:保留不使用此退出代码

14 ARG

在构建镜像时,指定一些参数,例如:

FROM centos:6
ARG user # ARG user=root
USER $user

这时,我们在docker build时可以带上自定义参数user了,如下所示:

docker build --build-arg user=edisonzhou Dockerfile .

本文资料来自这里

一下是我个人的用法,写本文是为了自己忘记的时候能够看一下

FROM openjdk:8
ADD target/docker-spring-boot.jar docker-spring-boot.jar
EXPOSE 8085
ENTRYPOINT ["java","-jar","docker-spring-boot.jar"]

打包命令

 docker build -f Dockerfile -t docker-spring-boot .
### Dockerfile 详细说明及最佳实践 #### 什么是 DockerfileDockerfile 是一种用于定义 Docker 容器镜像的脚本文件。它包含了创建镜像所需的一系列指令和参数,允许用户自动化构建过程并确保一致性[^1]。 --- #### Dockerfile 基础结构 Dockerfile 的核心是由一系列指令组成,每条指令对应于镜像的一个层。以下是常见的指令及其功能: 1. **FROM**: 指定基础镜像。 ```dockerfile FROM ubuntu:20.04 ``` 这一指令表示使用 Ubuntu 20.04 作为基础操作系统[^5]。 2. **LABEL**: 添加元数据到镜像中。 ```dockerfile LABEL maintainer="example@example.com" ``` 3. **RUN**: 执行命令以安装依赖项或配置环境。 ```dockerfile RUN apt-get update && apt-get install -y curl ``` 此处 `&&` 符号用于链接多个命令,减少分层数量[^2]。 4. **COPY/ADD**: 将文件复制到容器中。 ```dockerfile COPY . /app/ ADD requirements.txt /app/ ``` 5. **CMD/ENTRYPOINT**: 设置默认运行命令。 ```dockerfile CMD ["python", "/app/app.py"] ENTRYPOINT ["sh", "-c"] ``` `CMD` 提供默认参数,而 `ENTRYPOINT` 则指定不可变入口点[^4]。 6. **EXPOSE**: 声明容器监听的端口。 ```dockerfile EXPOSE 8080 ``` 7. **ENV**: 设置环境变量。 ```dockerfile ENV APP_ENV=production ``` 8. **WORKDIR**: 设定工作目录。 ```dockerfile WORKDIR /app ``` 9. **VOLUME**: 创建挂载点。 ```dockerfile VOLUME /data ``` 10. **ARG**: 定义构建时传递的参数。 ```dockerfile ARG version=latest ``` --- #### Dockerfile 最佳实践 1. **最小化镜像层数** 合理组合命令可以有效降低镜像大小。例如: ```dockerfile RUN apt-get update && \ apt-get install -y curl && \ rm -rf /var/lib/apt/lists/* ``` 上述写法将更新、安装以及清理操作合并为单个层[^2]。 2. **利用构建缓存** 构建过程中会逐行验证是否存在匹配缓存。因此应优先处理不常变动的部分(如基础镜像),再引入频繁修改的内容(如源代码)。 3. **分离应用程序逻辑** 应用程序与其依赖应当分开管理,便于维护升级。推荐采用多阶段构建技术: ```dockerfile FROM golang:alpine AS builder WORKDIR /go/src/app COPY main.go . RUN go build -o bin . FROM alpine:latest COPY --from=builder /go/src/app/bin /usr/local/bin/app CMD ["app"] ``` 多阶段构建显著减少了最终镜像体积[^3]。 4. **避免无意义的日志残留** 删除不必要的日志文件有助于保持清洁状态: ```dockerfile RUN apk add --no-cache git && \ mkdir -p ~/.ssh && \ chmod 600 ~/.ssh/config && \ ssh-keyscan github.com >> ~/.ssh/known_hosts ``` 5. **合理设置 `.dockerignore` 文件** 类似于 Git 中的忽略规则,`.dockerignore` 能够阻止特定路径被发送至守护进程上下文中。 --- #### 调试技巧 如果在构建期间遇到错误,可以通过启动中间镜像来定位问题所在: ```bash docker run -it <image_id> /bin/sh ``` 此方法提供了交互式的 shell 访问权限以便排查异常情况。 ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值