caddy 服务器的 Docker 镜像构建流程

caddy,docker · 浏览次数 : 3

小编点评

以下是构建包含最新版 Caddy Web 服务器的 Docker 镜像的 Dockerfile 模板摘要: ``` # 使用 Caddy 服务器的 Dockerfile 模板 FROM alpine:latest # 设置环境变量 ENV CADDY_VERSION v{{ .config.caddy_version }} ENV XDG_CONFIG_HOME /config ENV XDG_DATA_HOME /data # 创建目录并下载配置文件和欢迎页面 RUN set -eux; \ mkdir -p /config/caddy /data/caddy /etc/caddy /usr/share/caddy; \ wget -O /etc/caddy/Caddyfile "https://github.com/caddyserver/dist/raw/{{ .config.dist_commit }}/config/Caddyfile"; \ wget -O /usr/share/caddy/index.html "https://github.com/caddyserver/dist/raw/{{ .config.dist_commit }}/welcome/index.html"; \ wget -O /tmp/caddy.tar.gz "https://github.com/caddyserver/caddy/releases/download/v{{ .config.caddy_version }}/caddy_{{ .config.caddy_version }}_linux_{{ .config.binArch }}.tar.gz"; \ echo "$checksum /tmp/caddy.tar.gz" | sha512sum -c; \ tar x -z -f /tmp/caddy.tar.gz -C /usr/bin caddy; \ rm -f /tmp/caddy.tar.gz; \ setcap cap_net_bind_service=+ep /usr/bin/caddy; \ chmod +x /usr/bin/caddy; # 设置文件位置环境变量 ENV PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin" # 添加标签以描述镜像元数据 LABEL org.opencontainers.image.version=v{{ .config.caddy_version }} LABEL org.opencontainers.image.title=Caddy LABEL org.opencontainers.image.description="a powerful, enterprise-ready, open source web server with automatic HTTPS written in Go" LABEL org.opencontainers.image.url=https://caddyserver.com LABEL org.opencontainers.image.documentation=https://caddyserver.com/docs LABEL org.opencontainers.image.vendor="Light Code Labs" LABEL org.opencontainers.image.licenses=Apache-2.0 LABEL org.opencontainers.image.source="https://github.com/caddyserver/caddy-docker" # 暴露端口 EXPOSE 80 443 443/udp 2019 # 设置工作目录和默认命令 WORKDIR /srv CMD ["caddy", "run", "--config", "/etc/caddy/Caddyfile", "--adapter", "caddyfile"] ``` 该 Dockerfile 模板用于自动化构建一个包含最新版 Caddy Web 服务器的 Docker 镜像,支持自动 HTTPS,并配置了基本的文件结构和执行环境。它包括了从获取 Caddy 服务器的二进制文件、创建必要的目录结构、设置环境变量、添加标签以及暴露端口等步骤。

正文

 

构建一个包含 Caddy 服务器的 Docker 镜像,关键部分:

  https://github.com/caddyserver/caddy-docker/blob/master/Dockerfile.tmpl
这个 Dockerfile 精心设计,用于自动化构建一个包含最新版 Caddy Web 服务器的 Docker 镜像,支持自动 HTTPS,并配置了基本的文件结构和执行环境。

 

1. Trimming Whitespace:

{{ .base | strings.TrimSpace }}

这一行使用了某种模板引擎(如Go的text/template)来处理字符串,移除.base变量值开头和结尾的空白字符。

 

2. Installing Dependencies:

RUN apk add --no-cache \
    ca-certificates \
    libcap \
    mailcap    

添加必要的 Alpine Linux 包作为 Caddy 服务器的依赖,包括 CA证书、libcap 以及 mailcap。


3 Creating Directories & Downloading Configuration and Welcome Page:

RUN set -eux; \
    mkdir -p \
        /config/caddy \
        /data/caddy \
        /etc/caddy \
        /usr/share/caddy \
        ; \
    wget -O /etc/caddy/Caddyfile "https://github.com/caddyserver/dist/raw/{{ .config.dist_commit }}/config/Caddyfile"; \
    wget -O /usr/share/caddy/index.html "https://github.com/caddyserver/dist/raw/{{ .config.dist_commit }}/welcome/index.html"        

创建 Caddy 需要的多个目录结构,用于存放配置、数据、执行文件等。

使用 wget 命令从 GitHub 下载 Caddy 的默认配置文件 Caddyfile 和欢迎页面 index.html。


4. Setting Caddy Version Environment Variable:

ENV CADDY_VERSION v{{ .config.caddy_version }}

设置环境变量 CADDY_VERSION 为指定版本的 Caddy 服务器。


5. Downloading and Installing Caddy Binary

RUN set -eux; \
    apkArch="$(apk --print-arch)"; \
    case "$apkArch" in \
        x86_64)  binArch='amd64'; checksum='{{ .checksums.amd64 }}' ;; \
        armhf)   binArch='armv6'; checksum='{{ .checksums.arm32v6 }}' ;; \
        armv7)   binArch='armv7'; checksum='{{ .checksums.arm32v7 }}' ;; \
        aarch64) binArch='arm64'; checksum='{{ .checksums.arm64v8 }}' ;; \
        ppc64el|ppc64le) binArch='ppc64le'; checksum='{{ .checksums.ppc64le }}' ;; \
        riscv64) binArch='riscv64'; checksum='{{ .checksums.riscv64 }}' ;; \
        s390x)   binArch='s390x'; checksum='{{ .checksums.s390x }}' ;; \
        *) echo >&2 "error: unsupported architecture ($apkArch)"; exit 1 ;;\
    esac; \
    wget -O /tmp/caddy.tar.gz "https://github.com/caddyserver/caddy/releases/download/v{{ .config.caddy_version }}/caddy_{{ .config.caddy_version }}_linux_${binArch}.tar.gz"; \
    echo "$checksum  /tmp/caddy.tar.gz" | sha512sum -c; \
    tar x -z -f /tmp/caddy.tar.gz -C /usr/bin caddy; \
    rm -f /tmp/caddy.tar.gz; \
    setcap cap_net_bind_service=+ep /usr/bin/caddy; \
    chmod +x /usr/bin/caddy; \
    caddy version

根据当前系统的架构动态选择 Caddy 的二进制文件进行下载,并通过 SHA512 校验和确保文件完整性。然后,解压并安装到 /usr/bin,设置适当的权限和功能(如网络绑定服务的能力)。

 

6 Environment Variables for File Locations:

# See https://caddyserver.com/docs/conventions#file-locations for details
ENV XDG_CONFIG_HOME /config
ENV XDG_DATA_HOME /data

设置环境变量以指定 Caddy 的配置和数据存储位置。


7. Labels for Docker Image Metadata

LABEL org.opencontainers.image.version=v{{ .config.caddy_version }}
LABEL org.opencontainers.image.title=Caddy
LABEL org.opencontainers.image.description="a powerful, enterprise-ready, open source web server with automatic HTTPS written in Go"
LABEL org.opencontainers.image.url=https://caddyserver.com
LABEL org.opencontainers.image.documentation=https://caddyserver.com/docs
LABEL org.opencontainers.image.vendor="Light Code Labs"
LABEL org.opencontainers.image.licenses=Apache-2.0
LABEL org.opencontainers.image.source="https://github.com/caddyserver/caddy-docker"

添加一系列标签来描述镜像的版本、标题、描述等元数据。


8. Exposing Ports

EXPOSE 80 443 443/udp 2019

声明容器运行时需要暴露的端口,包括HTTP(80)、HTTPS(443)、UDP上的HTTPS(443/udp)以及Caddy的监控端口(2019)。


9. Working Directory and Default Command:

WORKDIR /srv
CMD ["caddy", "run", "--config", "/etc/caddy/Caddyfile", "--adapter", "caddyfile"]

设置工作目录为`/srv`,并定义容器启动时执行的默认命令,即运行Caddy服务器,使用Caddyfile配置文件。

 

Link:https://www.cnblogs.com/farwish/p/18248452

与caddy 服务器的 Docker 镜像构建流程相似的内容: