Dockerfile超详细解释

最新推荐文章于 2025-11-01 14:01:24 发布
原创 最新推荐文章于 2025-11-01 14:01:24 发布 · 1.6k 阅读 · 22 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#golang #makefile #make #dockerfile

文章目录

Dockerfile 超详细解析

一、基础概念

1. Dockerfile 是什么？

Dockerfile 是一个文本文件，包含了一系列指令，用于告诉 Docker 如何自动构建一个镜像。镜像可以理解为应用程序运行所需的环境和代码的打包。

2. 多阶段构建

这个 Dockerfile 使用了"多阶段构建"技术，意味着构建过程分为多个阶段：

  • 构建阶段：使用较大的基础镜像（包含完整的 Go 工具链）来编译代码
  • 运行阶段：使用较小的基础镜像，只包含运行应用程序所需的最小环境

这种做法的好处是可以减少最终镜像的大小，提高安全性（因为不包含构建工具）。

二、参数定义部分

ARG BUILD_IMAGE
ARG RUNTIME_IMAGE
ARG ENABLE_LICENSE
ARG LDFLAGS
ARG BUILD_MODE

ARG 用于定义构建时的变量，可以在构建时通过 --build-arg 参数覆盖。

三、构建阶段（Builder Stage）

FROM ${BUILD_IMAGE} AS builder

1. FROM 指令

开始一个新的构建阶段，使用 ${BUILD_IMAGE} 作为基础镜像，并命名为 builder。

ARG TARGETARCH
ARG LDFLAGS
ARG BUILD_MODE
ARG ENABLE_LICENSE

2. 阶段内参数

这些参数只在这个构建阶段有效：

  • TARGETARCH：目标架构（如 amd64 或 arm64）
  • LDFLAGS：链接器标志
  • BUILD_MODE：构建模式
  • ENABLE_LICENSE：许可证控制标志

3. WORKDIR 指令

WORKDIR /build

设置工作目录为 /build，后续的命令都会在这个目录下执行。

4. COPY 指令

COPY . .

将当前目录（Dockerfile 所在目录）的所有文件复制到容器的 /build 目录。

5. ENV 指令

ENV GOPROXY ****
ENV GONOPROXY ****
ENV GOPRIVATE ****
ENV GONOSUMDB ****
ENV PATH=/root/go/bin:${PATH}

设置环境变量：

  • GOPROXY：Go 模块代理设置
  • GONOPROXY/GOPRIVATE/GONOSUMDB：控制私有模块的下载和校验
  • PATH：添加 /root/go/bin 到可执行文件搜索路径

6. RUN 指令

RUN echo "enable license control: "${ENABLE_LICENSE}

执行 shell 命令，这里只是打印许可证控制的状态（用于调试）。

RUN CGO_ENABLED=0 GOARCH=${TARGETARCH} GOOS=linux go build --mod=${BUILD_MODE} -ldflags="${LDFLAGS} -X '****/pkg/license.Enable=${ENABLE_LICENSE}'" -o ** cmd/main.go

7. 核心构建命令

这是最重要的部分，编译 Go 程序：

参数说明
CGO_ENABLED=0禁用 CGO（纯 Go 代码，不依赖 C 库）
GOARCH=${TARGETARCH}设置目标架构
GOOS=linux设置目标操作系统为 Linux
--mod=${BUILD_MODE}设置 Go 模块构建模式
-ldflags="..."链接器标志，注入版本信息和许可证控制
-o ****输出文件名
cmd/main.go主程序入口文件

四、运行阶段（Runtime Stage）

1. 新的构建阶段

FROM ${RUNTIME_IMAGE}

使用 ${RUNTIME_IMAGE} 作为基础镜像，开始运行阶段。

2. 设置时区

ENV TZ Asia/Shanghai

将容器时区设置为 Asia/Shanghai。

3. 安装依赖

RUN if command -v apk; then apk update && apk add tzdata curl; fi
  • 检查是否有 apk 命令（Alpine Linux 的包管理器）
  • 如果有，则更新包索引并安装 tzdata（时区数据）和 curl

4. 配置时区

RUN cp -af /usr/share/zoneinfo/${TZ} /etc/localtime && echo ${TZ} > /etc/timezone
  • 将时区文件复制到系统位置
  • 设置时区配置文件

5. 复制构建结果

COPY --from=builder /build/**** /

从 builder 阶段复制编译好的 **** 二进制文件到当前阶段的根目录。

6. 设置入口点

ENTRYPOINT ["/****"]

指定容器启动时执行的命令（运行我们的程序）。

五、构建流程总结

  1. 构建阶段：

    • 使用 Go 镜像作为基础
    • 设置 Go 环境
    • 编译代码生成二进制文件

  2. 运行阶段：

    • 使用轻量级的 OpenEuler 镜像
    • 配置运行时环境
    • 从构建阶段复制二进制文件
    • 设置启动命令

六、与 Makefile 的关系

Makefile 负责：

  1. 设置各种构建参数（如版本号、Git 信息等）
  2. 调用 docker build 命令并传递参数
  3. 处理多平台构建逻辑

Dockerfile 负责：

  1. 定义具体的构建步骤
  2. 使用 Makefile 传递的参数
  3. 生成最终的容器镜像

七、常见问题解答

Q1: 为什么要用多阶段构建？

A: 可以减少最终镜像大小，提高安全性（运行环境不包含构建工具）。

Q2: ENABLE_LICENSE 是怎么起作用的？

A: 通过 -X 链接器标志将值注入到 Go 程序的变量中，代码中可以通过该变量判断是否启用许可证控制。

Q3: 为什么要禁用 CGO？

A: 禁用 CGO 可以生成静态链接的二进制文件，不依赖系统的 C 库，更容易跨平台部署。

Q4: GOPROXY 等环境变量的作用？

A: 用于控制 Go 模块的下载行为，特别是私有模块的处理方式。

Docker（七）：Docker基础总结篇--超详细
✨ 欢迎来到【Seal ^_^ 的优快云博客】！✨
09-07 5万+
🟢 Docker（七）：Docker基础总结篇[docker3要素、docker安装配置、容器使用、镜像管理发布]
超详细介绍如何使用神经网络进行特征匹配的简介
DT程序员的博客
07-24 501
本文超详细介绍如何使用神经网络进行特征匹配的简介
Docker高级——DockerFile详解
康小庄的博客
07-20 432
VOLUME ["", ""...]或者VOLUME 对于数据库类需要保存动态数据的应用，其数据库文件应该保存于卷(volume)中，后面的章节我们会进一步介绍 Docker 卷的概念。为了防止运行时用户忘记将动态文件所保存目录挂载为卷，在Dockerfile中，我们可以事先指定某些目录挂载为匿名卷，这样在运行时如果用户不指定挂载，其应用也可以正常运行，不会向容器存储层写入大量数据。这里的/data目录就会在容器运行时自动挂载为匿名卷，任何向/data。
07-DockerFile
xixihaha_coder的博客
12-12 826
文章目录DockerFileDockerFile构建过程DockerFile的指令实战:构建自己的centosCMD 和 ENTRYPOINT 的区别实战：DockerFile制作tomcat镜像发布镜像发布镜像到阿里云镜像容器服务Docker所有流程小结 DockerFile dockerfile是用来构建dokcer镜像的文件! 命令参数脚本 ! 构建步骤: 1、编写一个dockerfile 文件 2、docker build构建成为一个镜像 3、docker run运行镜像 4、docker pus
【Docker】第6章 ----DockerFile解析
朱朱博客，分享技术
11-01 791
从应用软件的角度来看，Dockerfile、Docker镜像与Docker容器分别代表软件的三个不同阶段，Dockerfile是软件的原材料Docker镜像是软件的交付品Docker容器则可以认为是软件的运行态。Dockerfile面向开发，Docker镜像成为交付标准，Docker容器则涉及部署与运维，三者缺一不可，合力充当Docker体系的基石。1 Dockerfile，需要定义一个Dockerfile，Dockerfile定义了进程需要的一切东西。
Docker DockerFile详解
mengxianglong123的博客
10-27 304
概念 Dockerfile是用来构建Docker镜像的构建文件，是由一系列命令和参数构成的脚本。 构建三步骤 编写Dockerfile文件---->docker build----->docker run docker build命令详解：https://www.runoob.com/docker/docker-build-command.html Doc...
DockerFile详解
m0_52884709的博客
11-01 767
CMD和RUN的区别：CMD是在 docker run 时运行，RUN是在 docker build 时运行。
Dockerfile常用指令
m0_56342013的博客
07-08 4170
docerfile及、dockerfile常用指令。
Dockerfile制作镜像
兰枫
09-03 667
Dockerfile制作镜像 文章目录Dockerfile制作镜像Dockerfile的指令 镜像生成的途径 Dockerfile制作 基于容器制作(直接在容器中制作) Dockerfile只是构建Docker映像的源代码 Docker可以通过读取Dockerfile中的指令来自动构建图像 Dockerfile是一个文本文档，包含用户可以在命令行上调用的所有命令来组装一个图像 使用...
Docker 13 Dockerfile
天河有尽后为涯，星海无边前作岸。
12-26 545
Dockerfile 是用来构建 Docker 镜像的文件，可以理解为命令参数脚本。Dockerfile 是面向开发的，想要打包项目，就要编写 Dockerfile 文件。由于 Docker 的流行，Docker 镜像逐渐替代jar或者war成为企业的交付标准。编写 Dockerfile其中的readme.txt一般作为镜像说明文件，可以在里面编写镜像的信息。构建镜像Installed:Complete!查看镜像启动镜像启动时将 tomcat 的webapps和logs目录都挂载到了本机。
dockerfile 详解
隔壁老猪
04-26 348
Dockerfile RUN：shell 格式：RUN <命令>，就像直接在命令行中输入的命令一样 exec 格式：RUN ["可执行文件", "参数1", "参数2"]，这更像是函数调用中的格式。 RUN echo '<h1>Hello, Docker!</h1>' > /usr/share/nginx/html/index.html COPY: COPY [--chown=<user>:<group>] <源...
dockerfile详解
hanguofei的博客
11-11 1377
我们可以把对容器的所有操作命令都记录到一个文件里，就像写脚本程序。 之后用 docker build 命令以此文件为基础制作一个镜像，并会自动提交到本地仓库。 这样的话镜像的构建会变的透明化，对镜像的维护起来也更加简单，只修改这个文件即可。 同时分享也更加简单快捷，因为只要分享这个文件即可。 Dokcerfile 是一个普通的文本文件，文件名一般叫 Dockerfile 其中包含了一系列的指令(I...
Docker 之Dockerfile详解
Romanticn_chu的博客
07-20 1000
一、Dockerfile的用法 Dockerfile是用来创建镜像的文件，该文件中包含构建镜像的命令。 二、一个例子 （创建tomcat镜像） FROM ccc7a11d65b1 （这串数字是我已经创建好一个ubuntu镜像的镜像id，在这里作为tomcat的基础镜像 MAINTAINER hmk ENV REFRESHED_AT 2018-03-10 （这个环境变量用来表名该镜像模板的最后更新时间） #切换镜像目录，进入/usr目录 WORKDIR /usr #在/usr/下创建jdk
容器技术-Dockerfile详解
qq_22648091的博客
01-13 2480
我们可以把对容器的所有操作命令都记录到一个文件里，就像是写脚本程序。 之后用 docker build 命令以此文件为基础制作一个镜像，并会自动提交到本地仓库。 这样的话镜像的构建会变的透明化，对镜像的维护起来也更加简单，只修改这个文件即可。 同时分享也更加简单快捷，因为只要分享这个文件即可。 Dokcerfile 是一个普通的文本文件，文件名一般叫 Dockerfile 其中包含了一系列的指令(Instruction)， 每一条指令都会构建一层，就是描述该层是如何创建的。 小试牛刀 示例： 编辑 Doc
Docker容器 - DockerFile详解
Trollz的博客
07-30 6366
Docker container - dockerfile details
Docker（11）-- DockerFile详解
weixin_42195311的博客
06-15 959
DockerFile详解
docker系列—Dockerfile详解
花满楼的博客
03-11 423
文章目录介绍格式指令集FROM语法RUN语法CMD语法LABEL语法 介绍 镜像的制作方式有两种 基于容器制作，但这样的镜像不利于维护，不适合线上使用。 另一种就是就是本文要介绍的Dockerfile，Dockerfile就是我们构建镜像的源代码，当然这不是所谓的编程源码，而是一些命令的组合，只要理解它的逻辑和语法格式，就可以编写Dockerfile，来生成我们镜像。 简要概括Dockerfi...
ollama 部署qwen2.5-7b教程 超详细
最新发布
11-12
<think> 嗯，用户需要超详细的Ollama部署Qwen2.5-7B教程。根据引用内容，用户已经看过一些相关文章，但需要更详尽的步骤说明。 用户可能正在Windows 11环境下尝试本地部署，对显存/内存计算和性能优化也有潜在需求。从引用[1][2]看，用户特别关注Ollama的简化操作和Qwen2.5-7B的量化版本。 需要重点覆盖几个方面： 1. 环境准备部分要强调Windows 11特定要求 2. 模型下载步骤需包含量化选项说明 3. 内存计算部分要给出具体公式 4. 性能优化要包含量化参数调整 5. 应用测试需展示完整对话示例 特别注意引用[3]提到的模型特性，在测试环节要设计对应的问题来验证知识、编程和数学能力。内存计算公式要具体化，比如$模型参数量\times量化位数÷8+上下文保留空间$这样的表达。 考虑到用户要"超详细"，每个步骤都要拆解到可操作层级，比如创建Modelfile就包含三种不同量化方案的选择说明。测试环节的curl命令也要给出完整模板，方便用户复制使用。 </think> 以下是在 Windows 11 系统上部署 Qwen2.5-7B-Instruct 模型的超详细教程，结合性能优化和显存计算： ### 一、环境准备 1. **安装 Ollama 0.11+** ```powershell winget install Ollama.Ollama ``` - 安装后终端输入 `ollama --version` 验证 - 开启 NVIDIA GPU 加速（需 CUDA 12+）： ```powershell setx OLLAMA_GPU_LAYERS 40 ``` 2. **硬件要求** | 量化级别 | 最低显存 | 最低内存 | |---------|---------|---------| | Q4_0 | 6GB | 16GB | | Q5_K_M | 8GB | 24GB | | F16 | 14GB | 32GB | ### 二、模型部署 1. **创建 Modelfile** ```dockerfile FROM qwen2:7b-instruct PARAMETER num_gpu 40 # 启用全部GPU层 PARAMETER num_ctx 4096 # 上下文长度 ``` 保存为 `qwen2.5-7b-instruct-ollama.txt` 2. **量化模型（可选但推荐）** ```powershell ollama create qwen2.5-7b-instruct -f qwen2.5-7b-instruct-ollama.txt --quantize q4_0 ``` **量化选项**： - `q4_0`（最小资源） - `q5_k_m`（平衡精度） - `f16`（最高精度） 3. **启动模型** ```powershell ollama run qwen2.5-7b-instruct ``` ▸ 首次运行自动下载约 4.5GB 模型文件 ### 三、性能优化 1. **GPU 层数计算** $$ \text{GPU层数} = \min\left(\text{GPU显存} \div 0.2, \text{总层数}\right) $$ - 例如 8GB 显存：`8 / 0.2 ≈ 40层` 2. **内存优化参数** ```powershell setx OLLAMA_NUM_PARALLEL 2 # CPU并行数 setx OLLAMA_KEEP_ALIVE 5 # 模型驻留时间(min) ``` ### 四、应用测试 1. **命令行交互** ```powershell >>> 用Python实现快速排序 ``` ▸ 模型将返回完整代码 2. **API 调用** ```powershell curl http://localhost:11434/api/generate -d '{ "model": "qwen2.5-7b-instruct", "prompt": "解释量子纠缠现象", "stream": false }' ``` ### 五、常见问题解决 1. **显存不足** ```powershell # 降低量化级别 ollama rm qwen2.5-7b-instruct ollama create qwen2.5-7b-instruct --quantize q4_0 ``` 2. **内存溢出** ```powershell # 修改分页文件 ollama serve --verbose 2>&1 | Out-File -FilePath ollama.log ``` > **部署验证**：运行 `ollama ps` 应显示： > ``` > NAME ID STATUS GPU > qwen2.5-7b-instruct a1b2 running 78% > ``` ### 六、进阶配置 1. **Docker 集成** ```docker docker run -d -p 11434:11434 -v ollama:/root/.ollama --gpus all ollama/ollama ``` 2. **OpenResty 代理** ```nginx location /api/ { proxy_pass http://localhost:11434; proxy_set_header Connection ""; } ``` [^1]: Ollama 的极简设计使本地部署效率提升 60% 以上 [^2]: Qwen2.5-7B 在 MMLU 基准测试达到 85+ 的准确率 [^3]: 量化技术可降低 70% 显存占用
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值