在Fedora CoreOS上配置Golang 详解不可变基础设施实践

答案：在Fedora CoreOS上部署Golang应用需通过容器化实现，利用Dockerfile多阶段构建精简镜像，使用Podman构建并生成systemd服务文件，最终通过Ignition配置实现开机自启和声明式管理，充分发挥FCOS不可变基础设施的优势。

在Fedora CoreOS上配置Golang，说实话，这和我们平时在Ubuntu或者CentOS上敲个

sudo apt install golang

解决方案

要让Golang应用在Fedora CoreOS上跑起来，核心策略就是容器化。这听起来可能有点反直觉，毕竟我们习惯了直接编译然后部署二进制文件，但在FCOS的世界里，你的二进制文件需要一个“家”，而这个家就是容器。

具体来说，你需要：

1. 编写一个Dockerfile：这个文件会指导如何构建一个包含你的Go应用及其所有依赖的容器镜像。关键在于使用多阶段构建，确保最终镜像尽可能小，只包含编译好的Go二进制文件。
2. 构建容器镜像：使用

   podman build

   命令（FCOS默认使用Podman，与Docker兼容）来构建你的Go应用镜像。
3. 运行容器：通过

   podman run

   命令测试你的镜像是否正常工作。
4. 持久化部署：这是最重要的一步。在Fedora CoreOS上，你不会手动去启动一个容器，而是通过

   systemd

   单元文件来声明式地管理它。你可以利用

   podman generate systemd

   命令来生成一个systemd服务文件，然后通过Ignition将其嵌入到FCOS的配置中，让你的Go应用容器在系统启动时自动运行。

我个人觉得，这种方式虽然初期学习曲线有点陡峭，但一旦你理解了它的逻辑，会发现维护和升级都变得异常简单。你的应用环境是完全隔离和可重现的，这在生产环境中简直是福音。

立即学习“go语言免费学习笔记（深入）”；

Fedora CoreOS的不可变特性，对Go语言开发者的真实意义是什么？

Fedora CoreOS的“不可变”设计，对我这个Go开发者来说，最初是有点冲击的。它不像传统的Linux发行版那样，你可以随意地

dnf install

apt-get update

这对我意味着什么？它强制我重新思考应用的部署方式。我的Go程序不再是“跑在一个服务器上”的某个进程，而是“运行在一个容器里”的独立单元。传统的SSH进去，拉代码，编译，然后启动服务的那一套，在FCOS上几乎是行不通的，或者说，是反模式的。

它带来的好处是显而易见的：环境一致性极高。你不用担心开发环境和生产环境因为某个库的版本不同而出现“在我机器上没问题”的尴尬局面。每次部署，都是部署一个已知、经过测试的容器镜像。对Go应用来说，由于Go本身编译后是静态链接的二进制文件，非常适合容器化，因为它几乎不依赖宿主机的动态库。这使得Go应用在FCOS上的部署体验异常顺滑，只要你的容器镜像构建得当，它就能在任何FCOS实例上以同样的方式运行。这种确定性，是传统部署模式很难达到的。

如何为Fedora CoreOS构建一个生产级的Golang应用容器镜像？

构建一个生产级的Golang应用容器镜像，尤其是在考虑到Fedora CoreOS这种极简环境时，需要一些技巧。关键在于“小”和“安全”。我的经验是，多阶段构建是必选项，它能让你在构建过程中利用一个包含Go编译器的大镜像，而最终的运行镜像则尽可能地精简。

这里有一个我常用的Dockerfile模板：

Subtxt

生成有意义的文本并编写完整的故事。

下载

# 第一阶段：编译Go应用
FROM golang:1.22-alpine AS builder

# 设置工作目录
WORKDIR /app

# 复制Go模块文件，并下载依赖
COPY go.mod go.sum ./
RUN go mod download

# 复制源代码
COPY . .

# 编译Go应用
# CGO_ENABLED=0 表示禁用CGO，生成纯静态链接的二进制文件，减少对libc的依赖
# -a 表示强制重新构建所有被引用的包
# -installsuffix cgo 表示如果CGO被禁用，则使用cgo作为安装后缀，避免与非cgo版本冲突
# -ldflags "-s -w" 移除调试信息和符号表，进一步减小二进制文件大小
RUN CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -ldflags "-s -w" -o my-go-app ./cmd/server/main.go

# 第二阶段：构建最终的运行镜像
# FROM scratch 是最轻量级的镜像，不包含任何操作系统文件
# 如果你的Go应用需要CA证书（例如HTTPS请求），你可能需要FROM alpine:latest
FROM alpine:latest
# 如果你的Go应用不需要任何系统依赖，且不进行HTTPS请求，可以使用FROM scratch
# FROM scratch

# 如果使用alpine，需要安装ca-certificates来处理HTTPS请求
RUN apk add --no-cache ca-certificates

# 设置时区（如果需要）
# ENV TZ=Asia/Shanghai
# RUN apk add --no-cache tzdata && cp /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone

# 复制编译好的二进制文件到最终镜像
COPY --from=builder /app/my-go-app /usr/local/bin/my-go-app

# 暴露应用端口（根据你的应用实际情况）
EXPOSE 8080

# 定义容器启动时执行的命令
CMD ["/usr/local/bin/my-go-app"]

几点说明：

• CGO_ENABLED=0

  : 这非常关键。它确保你的Go应用是纯静态编译的，不依赖任何C库。这样最终的二进制文件可以被放入

  scratch

  （一个完全空的镜像）或者像

  alpine

  这样极其精简的镜像中，而无需担心缺少运行时依赖。

• -ldflags "-s -w"

  : 进一步减小二进制文件的大小。

  s

  移除符号表，

  w

  移除调试信息。

• FROM scratch

  vs

  FROM alpine

  : 如果你的Go应用完全不依赖任何系统库（比如不进行HTTPS请求，不解析DNS等），

  scratch

  是最佳选择，镜像可以小到几MB。但如果需要CA证书（几乎所有Go应用都会进行HTTPS请求），或者需要一些基础工具（如

  ping

  、

  curl

  用于调试），那么

  alpine:latest

  是一个非常好的折中方案，它依然非常小，但包含了必要的系统组件。
• 暴露端口和CMD: 这是容器的基本配置，确保你的应用可以被访问并正确启动。

构建这个镜像后，你就可以通过

podman build -t my-go-app:latest .

在Fedora CoreOS上，如何让你的Go应用容器随系统启动并稳定运行？

让你的Go应用容器在Fedora CoreOS上随系统启动并稳定运行，这基本上就是玩转

systemd

Ignition

rc.local

/etc

我的做法通常是这样的：

1. 生成Podman的systemd单元文件： Podman有一个非常方便的命令，可以将一个运行中的容器或者容器的配置，转换成一个

   systemd

   服务文件。假设你的Go应用容器名叫

   my-go-app-container

   ，你可以这样生成：

   # 假设你已经用 podman run --name my-go-app-container ... 运行过一次
   podman generate systemd --name my-go-app-container --files --new

   这条命令会生成一个

   container-my-go-app-container.service

   文件。打开它，你会看到类似这样的内容：

   # /etc/systemd/system/container-my-go-app-container.service
   [Unit]
   Description=My Go Application Container
   Wants=network-online.target
   After=network-online.target
   
   [Service]
   Restart=always
   ExecStartPre=/bin/rm -f %t/%n.cid
   ExecStart=/usr/bin/podman run --cidfile=%t/%n.cid --cgroups=no-conmon --rm --sdnotify=conmon -d --replace \
     --name my-go-app-container \
     -p 8080:8080 \
     my-go-app:latest
   ExecStop=/usr/bin/podman stop --ignore --cidfile=%t/%n.cid -t 10
   ExecStopPost=/usr/bin/podman rm -f --ignore --cidfile=%t/%n.cid
   Type=notify
   NotifyAccess=all
   
   [Install]
   WantedBy=multi-user.target

   注意里面的

   Restart=always

   ，这确保了如果你的Go应用容器崩溃，systemd会自动尝试重启它，这对于生产环境的稳定性至关重要。你可能还需要根据实际情况添加一些

   Environment

   变量或者

   ExecStartPre

   来拉取最新镜像等操作。

2. 通过Ignition部署systemd单元文件： Ignition是Fedora CoreOS在首次启动时配置系统的方式。你需要将上面生成的

   systemd

   单元文件的内容，作为文件嵌入到Ignition配置文件中。当你用这个Ignition文件启动FCOS实例时，它会在

   /etc/systemd/system/

   目录下创建这个服务文件，并启用它。

   一个简化的Ignition配置片段可能看起来像这样（通常是JSON格式）：

   {
     "ignition": { "version": "3.x.x" },
     "storage": {
       "files": [
         {
           "path": "/etc/systemd/system/container-my-go-app-container.service",
           "mode": 420,
           "contents": {
             "source": "data:text/plain;charset=utf-8;base64,..." // 这里是systemd服务文件的Base64编码内容
           }
         }
       ]
     },
     "systemd": {
       "units": [
         {
           "name": "container-my-go-app-container.service",
           "enabled": true
         }
       ]
     }
   }

   你需要将

   container-my-go-app-container.service

   文件的内容进行Base64编码，然后替换

   source

   字段。

通过这种方式，你的Go应用容器就成了FCOS系统的一部分，它会随着系统启动而启动，并且由

systemd

systemd

Podman