Dockerfile(自建镜像)

![](/media/202206/2022-06-10_133432_832044.png)
Docker 镜像 外面看来就是一个整体，实际是分层构建的，这样有个好处就是对某层修改不需要整个重新构建，或是拉取新镜像时对于已经拥有的层可以略过
我们常看到的镜像大小是逻辑大小，因为镜像是由不同层组成的，而相同的镜像层本地只会存储一份，所以占用的物理存储空间大小可能会小于逻辑大小

在拉取镜像时会显示该镜像所拥有层级，对于本地已有的镜像可以使用 `docker inspect <镜像名称>` 来查看(Layers)
而 Dockerfile 文件就写明了如何去构造这个镜像，当然并不是所有的操作都会作为层出现，下方介绍中注明 `<层>` 的意味着这个操作会创建层

# 创建镜像
## Dockerfile 参数介绍
[Dockerfile 官方介绍](https://docs.docker.com/engine/reference/builder/)
```yml
# 注释以 # 开头，不可以放在指令后面，指令后面的#会被当做参数，这里加在后面是为了方便阅读
# 所有指令都是大写，不区分但约定是大写，以便更容易与参数区分
ARG <变量名>[=<默认值>]  # 定义构建时的参数，适合动态设置构建变量，需添加在FROM之前
FROM <基础镜像>  # <层> 指定父镜像
MAINTAINER <维护人员>  # 维护人员信息(🚫新的弃用了)
LABEL <键>=<值>  # 为镜像添加元数据，如描述信息、版本号、维护者等，多个使用空格隔开
ENV <变量名>=<变量内容>  # 环境变量，可用 ${变量名} 进行调用
ADD <源文件或URL> <目标路径>  # 和 COPY 类似，但可以从 URL 中获取文件或自动解压压缩文件
COPY <被复制文件或文件夹> <存放的内部路径>  # <层> 用于导入文件到镜像中，可以多条
WORKDIR <指定工作目录>  # 设置工作主目录
RUN <命令>  # <层> RUN 是在构建时运行的命令，就和正常使用是用的一样，可以多条
CMD <命令>  # CMD 是运行时执行的命令，一个镜像中不能有多条
ENTRYPOINT <命令>  # 指定容器入口点，可以设置容器启动时执行的命令，与 CMD 类似，但 CMD 可以被覆盖，而 ENTRYPOINT 不会
EXPOSE <内部端口1> <内部端口2/udp>  # 用于引导开放内部端口的，可以多参数，中间空格隔开，连续的可以这样写 <8000-8005>，默认是tcp，udp需要在端口后面加上/udp
VOLUME <内部挂载点1> <内部挂载点2>  # 用于引导创建挂载点，可以多参数，中间空格隔开，也可使用 VOLUME ["/data","/data1"] 这种方式
SHELL ["<shell>", "-c"]  # 指定 RUN, CMD, ENTRYPOINT, ADD 和 COPY 指令使用的 shell，默认是 ["/bin/sh", "-c"]
USER <用户>[:<组>]  # 设置运行容器时的用户名或用户ID，提升安全性，避免以 root 用户运行
STOPSIGNAL <信号>  # 设置容器停止时发送的信号，默认是 SIGTERM
HEALTHCHECK --interval=<间隔时间> --timeout=<超时时间> --retries=<重试次数> CMD <检查命令>  # 为容器添加健康检查，Docker 会定期执行指定命令，检查容器是否处于健康状态
ONBUILD <指令>  # 当前镜像被用作其他镜像的基础镜像时，自动执行的指令
```
> 因为每条具备新建层的命令都会创建一个层，而层越多意味着也就越臃肿，我们需要尽可能在保证能使用的条件下层级越少
> 比如在 RUN 中，可以使用 `&&` 来连接多个命令，或是使用 `\` 换行的方式尽可能把多条，命令包含在一条中
> 对于比较复杂的可以利用 `多阶段构建` 进行构建来缩小大小，这里就不展开了

### Dockerfile 案例
![](/media/202309/2023-09-05_084700_6407880.6260050879135428.png)

这里使用Blynk来举例
```yml
# 基础镜像 alpine
FROM alpine
# 安装 JAVA 环境
RUN apk add openjdk8-jre-base
# 复制 Blynk Jar 和 配置文件 到内部
COPY . /root
# 运行容器执行的命令
CMD java -jar /root/server-0.41.16-java8.jar -dataFolder /root/Blynk -serverConfig /root/server.properties
# 所需端口
EXPOSE 9443 8080
```
> dockerfile 文件要和需要放的文件 `在同一个文件夹`
> 主文件和配置文件会直接复制进容器，执行时直接调用

## 构建镜像
Linux 和 Windows 命令都一样，只有路径要区分一下
可以在构建时带着账户名称一起创建，这样随后就不需要再改了
`注意，构建标签中不能有大写字符！！！`

> 我们可以使用 `docker history <镜像名称:标签>` 来查看整个构建过程
> BY 对应执行的每个命令(顺序 自下而上)
> SIZE 非0的就是新建层的，0的是添加的元数据

### Docker BuildX 构建镜像(新)
[Docker BuildX 官方介绍](https://docs.docker.com/reference/cli/docker/buildx/)
```bash
docker buildx build [--pull(使用最新镜像)] -t <账户名称/镜像名称:标签> [--platform=linux/amd64,linux/arm64,linux/arm/v7(指定平台)] .  # buildx 构建镜像
  docker buildx build -t blynk:latest .  # 构建镜像

# 快速下载镜像中的文件,调试使用,执行后自动删除临时容器
docker create --name temp <镜像名称> && docker cp temp:<下载文件完整路径> . && docker rm temp
```
- `-t, --tag`：构建镜像的标签，注意：`标签只可小写不能有大写`
- `-f, --file`：指定构建时使用的Dockerfile(默认为当前路径下的 Dockerfile)
- `--pull`：始终尝试拉取所有引用的镜像
- `--build-arg`：设置构建时变量
- `--no-cache`：构建镜像时不使用缓存
- `--platform`：设置构建目标平台(默认当前平台,--platform=linux/amd64,linux/arm64,linux/arm/v7)
- `.`，最后的`.`，构造时使用当前目录作为构造上下文

### Docker Build 构建镜像(旧版构建器)
[Docker Build 官方介绍(旧版构建器)](https://docs.docker.com/reference/cli/docker/build-legacy/)
```bash
docker build [--pull(使用最新镜像)] -t <账户名称/镜像名称:标签> .  # build 是旧版构建器
  docker build -t blynk:latest .  # 构建镜像

# 快速下载镜像中的文件,调试使用,执行后自动删除临时容器
docker create --name temp <镜像名称> && docker cp temp:<下载文件完整路径> . && docker rm temp
```
- `-t, --tag`：构建镜像的标签，注意：`标签只可小写不能有大写`
- `-f, --file`：指定构建时使用的Dockerfile(默认为当前路径下的 Dockerfile)
- `--rm`：构建完成后自动删除中间容器
- `--build-arg`：设置构建时变量
- `--no-cache`：构建镜像时不使用缓存
- `.`，最后的`.`，构造时使用当前目录作为构造上下文

### 构建缓存
在多次构建时，如果遇到相同命令 Docker 会优先使用本地已构建缓存

**优化构建速度**
在编写 dockerfile 时，我们可以把 `常改动指令` 放在后面，这在构造时那些已经构造过的层就不需要再次构造了，节约时间

**强制忽略构造缓存**
对于常见的 `COPY` 指令来说， `COPY . /src` 复制整个文件夹
再次构造时，因为指令没变，即便文件夹下文件发生了改变，Docker 依然会认为已经构造过了，直接使用构造缓存
对于这种，我们就需要在构造时添加 `--nocache=true` 参数来强制要求全部重新构造

## 运行容器
运行一下镜像测试是否正常
```
# -it 是直接运行，可以查看到输出
# -p 映射出所需要的端口，Docker的优势是Blynk这种多开要改端口的，直接改外部映射即可
# -v 映射一下外部文件夹到内部，方便文件可以外部管理
# 最末尾为镜像生成的容器名称
docker run --name blynk -it -p 8080:8080 -p 9443:9443 -v $PWD/Blynk:/root/Blynk blynk:latest  # Linux
docker run --name blynk -it -p 8080:8080 -p 9443:9443 -v D:\Docker\Blynk:/root/Blynk blynk:latest  # Windows

# 映射本地文件覆盖镜像默认的
docker run --name blynk -it -p 8080:8080 -p 9443:9443 -v $PWD/Blynk:/root/Blynk -v $PWD/server.properties:/root/server.properties -v $PWD/mail.properties:/root/mail.properties blynk:lates  # Linux
```

# 上传镜像到仓库
Windows 使用 `Docker Desktop`，创建时候标签打的是对应帐号的，可以在 Docker Desktop 中一键上传

## 建立Docker Hub仓库
[Docker Hub官网](https://registry.hub.docker.com/)
注册并登陆帐号——Repositories(储存库)——新建库

## 上传镜像
控制台输入登录，而非网页登陆
```
# docker tag <需上传的镜像名> <你Hub的用户名>/<仓库名>:<版本>

docker tag blynk:latest 918178/blynk:latest  # 给镜像打上新标签，不会覆盖原有的，也可以在创建时就打上
docker login  # 根据提示登录你的 Hub 帐号
docker push 918178/blynk:latest  # 上传镜像
```
等待上传完成
可以在Docke Hub Web上查看是否上传成功
之后就和正常使用镜像一样操作了

**相关教程：**
[Dockerfile 构建各类环境示例](https://codefresh.io/docs/docs/learn-by-example/golang/golang-hello-world/)