制作Go镜像

本文介绍如何在本地制作Docker镜像，并以镜像方式将Go应用部署到Serverless 应用引擎 SAE（Serverless App Engine）。

前提条件

安装Docker。
开通阿里云SAE服务。
开通阿里云容器镜像ACR服务并创建实例，个人版实例和企业版实例皆可。

步骤一：准备项目

下载Demo。

Demo内的Dockerfile内容如下：

# Golang版本；Alpine镜像的体积较小。
FROM golang:1.16.6-alpine3.14 as builder

# 替换Alpine镜像，方便安装构建包。
RUN sed -i 's/dl-cdn.alpinelinux.org/mirrors.aliyun.com/g' /etc/apk/repositories

# 安装构建阶段的依赖。
RUN apk --update add gcc libc-dev upx ca-certificates && update-ca-certificates

# 将代码复制到构建镜像中。
# 注意地址不要在GOPATH中。
ADD . /workspace

WORKDIR /workspace

# 挂载构建缓存。
# GOPROXY防止下载失败。
RUN --mount=type=cache,target=/go \
  env GOPROXY=https://goproxy.cn,direct \
  go build -buildmode=pie -ldflags "-linkmode external -extldflags -static -w" \
  -o /workspace/gin-hello-world

# 运行时镜像。
# Alpine兼顾了镜像大小和运维性。
FROM alpine:3.14

EXPOSE 8080

# 方便运维人员安装需要的包。
RUN sed -i 's/dl-cdn.alpinelinux.org/mirrors.aliyun.com/g' /etc/apk/repositories

# 创建日志目录等。
# RUN mkdir /var/log/onepilot -p && chmod 777 /var/log/onepilot && touch /var/log/onepilot/.keep

# 复制构建产物。
COPY --from=builder /workspace/gin-hello-world /app/

# 指定默认的启动命令。
CMD ["/app/gin-hello-world"]

在Demo所在目录，执行以下命令，构建镜像。
```
docker build . -t gin-example
```
本地验证。
1. 指定端口映射，格式为主机端口:容器端口，运行镜像。
```
docker run -p 127.0.0.1:8080:8080/tcp gin-example
```
2. 执行以下命令，查看请求是否返回正常。
```
curl http://127.0.0.1:8080/
```
  输出如下：

步骤二：制作镜像

在容器镜像服务控制台创建镜像仓库。
个人版和企业版实例均适用本文的操作，本文以个人版实例为例。具体操作，请参见以下文档：
- 个人版实例：构建仓库与镜像
- 企业版实例：使用企业版实例构建镜像
构建并推送镜像。
您可以在目标镜像仓库的基本信息页面的镜像指南页签查询具体命令。更多信息，请参见以下文档：
- 个人版实例：使用个人版实例推送拉取镜像
- 企业版实例：使用企业版实例推送和拉取镜像
1. 执行以下命令，构建镜像。
```
docker build --tag go-demo:v1 .
```
2. 执行以下命令，登录远端镜像仓库。
```
docker login --username=<镜像仓库登录名> registry.<regionId>.aliyuncs.com
```
  示例如下：
```
docker login --username=****@188077086902**** registry.cn-hangzhou.aliyuncs.com
```
  在返回结果中输入密码，如果显示login succeeded，则表示登录成功。如何设置密码，请参见设置镜像仓库登录密码。
3. 执行以下命令，给镜像打标签。
```
docker tag <ImageId> registry.<regionId>.aliyuncs.com/****/go-demo:<镜像版本号>
```
  - ImageId：镜像ID。
  - registry.<regionId>.aliyuncs.com/****/go-demo：镜像仓库地址。
  示例如下：
```
docker tag go-demo:v1 registry.cn-hangzhou.aliyuncs.com/****/go-demo:v1
```
4. 执行以下命令，推送镜像至个人版实例。
```
docker push registry.<regionId>.aliyuncs.com/****/go-demo:<镜像版本号>
```
  示例如下：
```
docker push registry.cn-hangzhou.aliyuncs.com/****/go-demo:v1
```
成功推送后，您可以登录容器镜像服务控制台，在目标镜像仓库的镜像版本页面查看推送的版本。