Dockerfile文件参数配置和使用
天行健，君子以自强不息；地势坤，君子以厚德载物。
每个人都有惰性，但不断学习是好好生活的根本，共勉！
文章均为学习整理笔记，分享记录为主，如有错误请指正，共同学习进步。
文章目录
- 一、Dockerfile介绍
- 二、Dockerfile常用参数
- 三、配置Dockerfile
- 四、使用Dockerfile
- 1. 构建镜像命令语法
- 2. 举例
K8S自动化部署JAVA项目（Gitlab CI/CD）请参考文章：K8S部署Java项目（Gitlab CI/CD自动化部署）
一、Dockerfile介绍
官网参考文档
https://docs.docker.com/engine/reference/builder/
参数截图
二、Dockerfile常用参数
Dockerfile文件中的关键字不区分大小写，大写小写都可以
以下为常用参数（关键字）
| 关键字 | 描述 |
|---|---|
| FROM | 指定基础镜像 如FROM docker:latest |
| MAINTAINER | 指定文件作者 如李白 |
| ENV | 配置环境变量 如ENV JAVA_HOME=/root/local/java/jdk1.8-.0.121 |
| ARG | 用于定义变量后面引用 如JAR_FILE=target/*.jar 后面可用${JAR_FILE}方式引用 |
| WORKDIR | 工作目录，即后续RUN、ADD等命令执行位置的路径 |
| COPY | 拷贝本地文件到指定目录 如COPY ./tomcat-8.0 /root/tomcat，不支持压缩文件自动解压，文件只会被复制为普通文件 |
| ADD | 与COPY相似，但除了复制本地文件和目录外，还有几点高级功能，1会在将压缩文件复制到目标目录前自动解压，2还支持使用url作为源路径从网络下载文件并复制到容器中，3在构建上下文中添加的文件可以是一个url，他会自动下载并复制到容器中，tips：建议用COPY，更简单直接 |
| RUN | 执行linux的shell命令 如RUN mkdir -p /root/project |
| EXPOSE | 指定容器运行时坚挺的端口，镜像使用者可看到 如EXPOSE 8800 |
| ENTRYPOINT | 镜像中应用的启动命令，容器运行时调用 如ENTRYPOINT java -jar app.jar |
三、配置Dockerfile
配置举例
以java项目为例使用Dockerfile文件打包并构建镜像
#关键字和值之间可以是空格" "也可以是等号"="
#指定基础镜像，以此镜像为基础构建
FROM openjdk:8-jdk-alpine#作者
MAINTAINER hs#设置环境变量
#JAVA_HOME环境变量定义，即配置jdk安装目录路径，需是jdk文件全路径名
ENV JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.392.b08-4.0.3.al8.x86_64
#MAVEN环境变量定义，即maven安装的位置，需是maven全路径名
ENV MAVEN_HOME=/usr/share/maven
#配置环境变量
ENV PATH=$PATH:$JAVA_HOME/bin:$MAVEN_HOME/bin
#指定容器的时区
ENV TZ=Asia/Shanghai
#应用参数
#ENV ARGS=""
#target是jar包默认的位置，但是我们在CICD打包阶段已经将jar复制到了/root/jar/k8s-project目录中
#ARG JAR_FILE=target/*.jar#创建工作目录，此目录在CICD打包阶段已经创建
#RUN mkdir -p /root/jar/k8s-project#设置工作目录，后续命令默认执行位置为该路径，不设置的话后续会默认当前路径为工作路径
WORKDIR /root/jar/k8s-project#复制文件到镜像中，将本地文件或目录复制到镜像指定位置
#COPY app.jar /root/jar/k8s-project/app.jar
#COPY ${JAR_FILE} /root/jar/k8s-project/app.jar#将app.jar添加到指定文件夹中，并自动解压缩（与COPY类似，二选一即可）
#同时因为我们已经在.gitlab-ci.yml文件中的打包阶段执行了将jar复制到/root/jar/k8s-project目录的操作，故本文件中省略复制COPY或ADD命令
#ADD target/app.jar /root/jar/k8s-project/app.jar
#ADD ${JAR_FILE} /root/jar/k8s-project/app.jar#时区配置，可省略
#RUN ln -snf /usr/share/zonginfo/$TZ /etc/localtime && echo $TZ > /etc/timezone#容器入口，该命令应该是将每个字符串组合起来，nohub java -jar app.jar
ENTRYPOINT ["nohup","java","-jar","app.jar"]#声明要监听的端口（暴露端口，容器内部的端口，这里暂时不用）
#EXPOSE 8080
四、使用Dockerfile
在docker中可直接构建镜像，操作如下
准备一个项目和一个Dockerfile文件
1. 构建镜像命令语法
打标签，注意最后一个.表示在当前位置执行，如果Dockerfile文件不在当前目录中，需要使用-f指定Dockerfile文件位置
docker build -t 镜像名:镜像标签 .
或指定Dockerfile位置构建
docker build -t 镜像名:镜像标签 . -f /root/Dockerfile
推送镜像
docker push 镜像名:镜像标签
2. 举例
镜像名为springboot
镜像标签为v20240204
docker build -t springboot:v20240204 .
docker push springboot:v20240204
执行后即可生成镜像
后续可通过该镜像部署项目，如docker run命令部署或者k8s的yaml文件部署
当配合gitlab ci/cd的.gitlab-ci.yml文件进行项目自动化部署时，Dockerfile文件最好与.gitlab-ci.yml一样存放在项目根目录
详情可参考：.gitlab-ci.yml文件参数配置和使用
感谢阅读，祝君暴富！