Docker入门：构建支持多系统架构的Docker镜像

KenTalk

发布于 2023-05-13 15:28:29

1.6K0

发布于 2023-05-13 15:28:29

文章被收录于专栏：Ken的杂谈

一、前言

1、本文主要内容

使用Docker Buildx构建支持AMD64、ARM、ARM64等架构的镜像并传到到Docker Hub

2、本文环境信息

环境	说明
Docker	Docker CE 23.0.5
Docker Desktop	4.19
Docker Buildx	0.10.4
Docker Golang镜像	1.20
Golang	1.20
Windows	Windows 11
curl for Windows	7.87

3、前置知识

Docker入门：使用Dockerfile构建Docker镜像

https://cloud.tencent.com/developer/article/2259804

二、镜像制作准备

创建镜像制作根目录，例如：d:\docker\helloworld（Windows），~/docker/helloworld（macOS），后续所有文件都放在该目录中

1、准备应用代码

用golang写的一个简单http server，监听8000端口，默认输出helloworld，并返回操作系统、HostName以及IP地址信息

新建helloworld.go保存以下代码

package main

import (
    "fmt"
    "log"
    "net"
    "net/http"
    "os"
    "runtime"
    "strings"
)

func getHostName() string {
    hostname, err := os.Hostname()
    if err != nil {
        log.Fatalf("Failed to open log file: %v", err)
    }
    return hostname
}

func getIpAddresses() string {
    addrs, err := net.InterfaceAddrs()
    if err != nil {
        log.Fatal(err)
        return ""
    }
    var ips []string
    for _, address := range addrs {
        if ipnet, ok := address.(*net.IPNet); ok && !ipnet.IP.IsLoopback() {
            if ipnet.IP.To4() != nil {
                ips = append(ips, ipnet.IP.String())
            }
        }
    }
    return strings.Join(ips, ",")
}

func handler(w http.ResponseWriter, r *http.Request) {
    log.Println("received request from", r.RemoteAddr, r.URL.Path[1:])
    var welcome = r.URL.Path[1:]
    if len(welcome) == 0 {
        welcome = "World"
    }
    fmt.Fprintf(w, "Hello, %s!  ---ken.io \r\n", welcome)
    fmt.Fprintf(w, "OS：%s/%s，Host：%s，IP：%s\r\n", runtime.GOOS, runtime.GOARCH, getHostName(), getIpAddresses())
}

func main() {
    http.HandleFunc("/", handler)
    log.Println("starting server on port 8000")
    log.Fatal(http.ListenAndServe(":8000", nil))
}

2、编写Dockerfile文件

Dockerfile 是用于Docker镜像的文本文件（默认无后缀名），包含所有我们需要用于创建Docker镜像的命令，例如：指定基础镜像、安装依赖的软件、配置环境变量、添加文件和目录、定义容器启动时运行的命令等

新建helloworld.build并保存以下内容

# 使用官方提供的 Go 镜像作为基础镜像
FROM golang:1.20

# 将工作目录设置为 /app
WORKDIR /app

# 将helloworld.go复制到 /app 下
COPY helloworld.go /app

# 设置go mod 镜像
RUN go env -w GO111MODULE=on
RUN go env -w  GOPROXY=https://goproxy.cn,direct

# 导入依赖的Redis go module
RUN go mod init helloworld

# 允许宿主机访问容器的 8000 端口
EXPOSE 8000

# 设置容器进程为：go run helloworld.go
CMD go run helloworld.go

三、镜像制作

1、确认BaseImage支持架构

以Golang的官方镜像镜像为例，我们可以在找到指定版本，查看支持的系统架构

2、登录账号

访问 https://hub.docker.com/signup 注册账号，然后在Docker Desktop登录账号，或者通过命令登录

# 登录命令
docker login

# 根据命令号交互输入注册时的账号密码即可成功登录
Login with your Docker ID to push and pull images from Docker Hub. If you don't have a Docker ID, head over to https://hub.docker.com to create one.
Username: kentalk
Password:
Login Succeeded

Logging in with your password grants your terminal complete access to your account.
For better security, log in with a limited-privilege personal access token. Learn more at https://docs.docker.com/go/access-tokens/

3、构建镜像

Docker从19.03版本提供了构建工具Buildx，可以通过—platform参数指定构建的目标平台，例如：linux/amd64、linux/arm64或、darwin/amd64等等，通过Buildx可以连接面向不同架构的Docker节点分别构建，也可以直接将构建信息推送到Docker Hub，这里选择后者，毕竟不需要准备面向不同架构的Docker节点，更省事儿

# 进入目录
d: && cd d:\docker\helloworld

# 查看Buildx版本（确认buildx已启用，如未启用，使用docker buildx install安装）
docker buildx version

# 构建镜像（默认为latest）（注意结尾一定要加.）
# 这里选择构建常见的linux/amd64,linux/arm64 架构，如需其他的可以自行追加
docker buildx build \
--platform linux/amd64,linux/arm64 \
-f helloworld.build   \
-t kentalk/helloworld --push .

4、查看构建结果

访问 https://hub.docker.com/r/kentalk/helloworld/tags 查看构建的结果

5、镜像测试

# 拉取镜像
docker pull kentalk/helloworld

# 启动容器
docker run --name myhello -p 8000:8000 -d kentalk/helloworld

# 访问测试
curl localhost:8000

# 输出示例
Hello, World!  ---ken.io 
OS：linux/arm64，Host：3426a278c72e，IP：172.17.0.3

6、查看镜像信息

docker buildx imagetools inspect kentalk/helloworld

# 输出示例

*****************省略部分内容******************
Manifests:
  Name:        docker.io/kentalk/helloworld:latest@sha256:e84a3c9b0ebfa61af984594dedfbaaba092fa592e0e881f62fe7999f17e44b53
  MediaType:   application/vnd.oci.image.manifest.v1+json
  Platform:    linux/amd64

  Name:        docker.io/kentalk/helloworld:latest@sha256:df49a99b6f5ddbcd5e79826c5cd1086cb5edff4601be35c8f4358616f0e2d749
  MediaType:   application/vnd.oci.image.manifest.v1+json
  Platform:    linux/arm64
*****************省略部分内容******************