利用 GitHub Action 自动发布 Docker

前言

最近公司内部项目的发布流程接入了 GitHub Actions，整个体验过程仍是比较美好的；本文主要目的是对于没有还接触过 GitHub Actions的新手，可以利用它快速构建自动测试及打包推送 Docker 镜像等自动化流程。

建立项目

本文主要以 Go 语言为例，固然其余语言也是相似的，与语言自己关系不大。

这里咱们首先在 GitHub 上建立一个项目，编写了几段简单的代码 main.go：

var version = "0.0.1"

func GetVersion() string {
	return version
}

func main() {
	fmt.Println(GetVersion())
}
复制代码

内容很是简单，只是打印了了版本号；同时配套了一个单元测试 main_test.go：

func TestGetVersion1(t *testing.T) {
	tests := []struct {
		name string
		want string
	}{
		{name: "test1", want: "0.0.1"},
	}
	for _, tt := range tests {
		t.Run(tt.name, func(t *testing.T) {
			if got := GetVersion(); got != tt.want {
				t.Errorf("GetVersion() = %v, want %v", got, tt.want)
			}
		})
	}
}
复制代码

咱们能够执行 go test 运行该单元测试。

$ go test                          
PASS
ok      github.com/crossoverJie/go-docker       1.729s
复制代码

自动测试

固然以上流程彻底能够利用 Actions 自动化搞定。

首选咱们须要在项目根路径建立一个 .github/workflows/*.yml 的配置文件，新增以下内容：

name: go-docker
on: push
jobs:
  test:
    runs-on: ubuntu-latest
    if: github.ref == 'refs/heads/main' || startsWith(github.ref, 'refs/tags')
    steps:
      - uses: actions/checkout@v2
      - name: Run Unit Tests
        run: go test
复制代码

简单解释下：

• name 没必要多说，是为当前工做流建立一个名词。
• on 指在什么事件下触发，这里指代码发生 push 时触发，更多事件定义能够参考官方文档：

Events that trigger workflows

• jobs 则是定义任务，这里只有一个名为 test 的任务。

该任务是运行在 ubuntu-latest 的环境下，只有在 main 分支有推送或是有 tag 推送时运行。

运行时会使用 actions/checkout@v2 这个由他人封装好的 Action，固然这里使用的是由官方提供的拉取代码 Action。

• 基于这个逻辑，咱们能够灵活的分享和使用他人的 Action 来简化流程，这点也是 GitHub Action扩展性很是强的地方。

最后的 run 则是运行本身命令，这里天然就是触发单元测试了。

• 若是是 Java 即可改成 mvn test.

以后一旦咱们在 main 分支上推送代码，或者有其余分支的代码合并过来时都会自动运行单元测试，很是方便。

与咱们本地运行效果一致。

自动发布

接下来考虑自动打包 Docker 镜像，同时上传到 Docker Hub；为此首先建立 Dockerfile ：

FROM golang:1.15 AS builder
ARG VERSION=0.0.10
WORKDIR /go/src/app
COPY main.go .
RUN go build -o main -ldflags="-X 'main.version=${VERSION}'" main.go

FROM debian:stable-slim
COPY --from=builder /go/src/app/main /go/bin/main
ENV PATH="/go/bin:${PATH}"
CMD ["main"]
复制代码

这里利用 ldflags 可在编译期间将一些参数传递进打包程序中，好比打包时间、go 版本、git 版本等。

这里只是将 VERSION 传入了 main.version 变量中，这样在运行时就便能取到了。

docker build -t go-docker:last .
docker run --rm go-docker:0.0.10
0.0.10
复制代码

接着继续编写 docker.yml 新增自动打包 Docker 以及推送到 docker hub 中。

deploy:
    runs-on: ubuntu-latest
    needs: test
    if: startsWith(github.ref, 'refs/tags')
    steps:
      - name: Extract Version
        id: version_step
        run: | echo "##[set-output name=version;]VERSION=${GITHUB_REF#$"refs/tags/v"}" echo "##[set-output name=version_tag;]$GITHUB_REPOSITORY:${GITHUB_REF#$"refs/tags/v"}" echo "##[set-output name=latest_tag;]$GITHUB_REPOSITORY:latest" 
      - name: Set up QEMU
        uses: docker/setup-qemu-action@v1

      - name: Set up Docker Buildx
        uses: docker/setup-buildx-action@v1

      - name: Login to DockerHub
        uses: docker/login-action@v1
        with:
          username: ${{ secrets.DOCKER_USER_NAME }}
          password: ${{ secrets.DOCKER_ACCESS_TOKEN }}

      - name: PrepareReg Names
        id: read-docker-image-identifiers
        run: | echo VERSION_TAG=$(echo ${{ steps.version_step.outputs.version_tag }} | tr '[:upper:]' '[:lower:]') >> $GITHUB_ENV echo LASTEST_TAG=$(echo ${{ steps.version_step.outputs.latest_tag }} | tr '[:upper:]' '[:lower:]') >> $GITHUB_ENV 
      - name: Build and push Docker images
        id: docker_build
        uses: docker/build-push-action@v2.3.0
        with:
          push: true
          tags: | ${{env.VERSION_TAG}} ${{env.LASTEST_TAG}}           build-args: | ${{steps.version_step.outputs.version}} 复制代码

新增了一个 deploy 的 job。

needs: test
    if: startsWith(github.ref, 'refs/tags')
复制代码

运行的条件是上一步的单测流程跑通，同时有新的 tag 生成时才会触发后续的 steps。

name: Login to DockerHub

在这一步中咱们须要登陆到 DockerHub，因此首先须要在 GitHub 项目中配置 hub 的 user_name 以及 access_token.

配置好后便能在 action 中使用该变量了。

这里使用的是由 docker 官方提供的登陆 action(docker/login-action)。

有一点要很是注意，咱们须要将镜像名称改成小写，否则会上传失败，好比个人名称中 J 字母是大写的，直接上传时就会报错。

因此在上传以前先要执行该步骤转换为小写。

最后再用这两个变量上传到 Docker Hub。

从此只要咱们打上 tag 时，Action 就会自动执行单测、构建、上传的流程。

总结

GitHub Actions 很是灵活，你所须要的大部分功能都能在 marketplace 找到现成的直接使用，

好比能够利用 ssh 登陆本身的服务器，执行一些命令或脚本，这样想象空间就很大了。

使用起来就像是搭积木同样，能够很灵活的完成本身的需求。

参考连接：

How to Build a CI/CD Pipeline with Go, GitHub Actions and Docker