iron/go

Iron.io Go 语言 Docker 镜像介绍

概述

本仓库（[iron-io/dockers/go] ）提供了基于 Go 语言的 Docker 基础镜像，适用于快速开发、构建和部署 Go 应用，尤其适合与 Iron.io 服务（如 IronWorker、IronMQ）集成的场景。镜像设计注重轻量性和实用性，可直接作为基础环境或定制扩展。

镜像信息

基础环境

• 底层系统：默认基于 Alpine Linux（轻量级，适合生产环境），部分版本可能提供 Debian 变体（如需更多系统工具）。
• Go 版本：通过标签区分不同 Go 版本（如 1.21、1.22），具体支持版本可查看仓库标签列表。
• 包含工具：基础 Go 开发环境（go 命令、标准库），部分标签可能包含 git、make 等构建工具（具体以标签说明为准）。

使用步骤

1. 拉取镜像

根据项目所需的 Go 版本，拉取对应标签的镜像：

bash
# 示例：拉取 Go 1.21 的 alpine 基础镜像
docker pull docker.xuanyuan.run/iron/go:1.21

2. 编写 Dockerfile

以该镜像为基础，编写应用的 Dockerfile。以下是标准构建流程示例：

dockerfile
# 阶段 1：构建应用（使用完整 Go 环境）
FROM docker.xuanyuan.run/iron/go:1.21 AS builder
WORKDIR /app
# 复制代码并构建
COPY . .
RUN go build -o myapp main.go  # 假设入口文件为 main.go

# 阶段 2：生产镜像（仅保留运行时依赖，减小体积）
FROM docker.xuanyuan.run/alpine:3.18
WORKDIR /app
# 从构建阶段复制编译好的二进制文件
COPY --from=builder /app/myapp .
# 运行应用
CMD ["./myapp"]

3. 构建应用镜像

在 Dockerfile 所在目录执行构建命令：

bash
docker build -t my-go-app .

4. 运行容器

启动构建好的应用容器：

bash
docker run --rm docker.xuanyuan.run/my-go-app

示例：Hello World 应用

1. 创建基础代码

新建 main.go：

go
package main

import "fmt"

func main() {
    fmt.Println("Hello from Iron.io Go Docker Image!")
}

2. 使用上述 Dockerfile 构建并运行

执行步骤 2-4 的命令，即可看到输出：

Hello from Iron.io Go Docker Image!

注意事项

• 标签选择：生产环境建议指定具体版本标签（如 1.21），避免使用 latest（可能随仓库更新变化）。
• 镜像体积：Alpine 基础镜像体积较小（通常 <200MB），如需系统工具（如 glibc），可选择 Debian 变体标签（如 1.21-debian，体积较大）。
• Iron.io 集成：如需部署到 IronWorker，可参考仓库内的 worker 示例标签（如有），或在 Dockerfile 中添加 IronWorker 运行时配置（如 ENTRYPOINT ["/worker"]）。

总结

此镜像简化了 Go 应用的容器化流程，适合快速迭代开发和生产部署。通过标签灵活选择 Go 版本，结合多阶段构建可进一步优化镜像体积。详细配置和更多示例可参考仓库文档。