Go 语言特定指南

Go 语言特定指南

本指南将向您展示如何使用 Docker 创建、测试和部署容器化的 Go 应用程序。

感谢

Docker 感谢 Oliver Frolovs 对本指南的贡献。

您将学到什么？

在本指南中，您将学习如何：

• 创建一个包含构建 Go 程序的容器镜像指令的 Dockerfile。
• 在本地 Docker 实例中运行镜像作为容器，并管理容器的生命周期。
• 使用多阶段构建高效构建小镜像，同时保持 Dockerfile 易于阅读和维护。
• 使用 Docker Compose 在开发环境中编排运行多个相关容器。
• 使用 GitHub Actions 配置应用程序的 CI/CD 流水线。
• 部署您的容器化 Go 应用程序。

前提条件

• 了解一些 Go 语言及其工具链的基本知识。
• 了解一些基本的 Docker 概念，并对 Dockerfile 格式有一定了解。
• 确保您的 Docker 设置已启用 BuildKit。对于 Docker Desktop 用户，BuildKit 默认已启用。如果您在 Linux 上运行 Docker，请查看 BuildKit 入门页面。
• 对命令行有一定的熟悉度。

步骤指南

1. 准备 Go 应用程序

确保您的 Go 应用程序目录结构如下：

my-go-app/
├── main.go
├── go.mod
└── go.sum
1
2
3
4

2. 创建 Dockerfile

在项目根目录下创建一个名为 Dockerfile 的文件，并添加以下内容：

# 第一阶段：构建
FROM golang:1.18-alpine AS builder
WORKDIR /app
COPY . .
RUN go mod tidy
RUN go build -o myapp

# 第二阶段：运行
FROM alpine:latest
WORKDIR /root/
COPY --from=builder /app/myapp .
EXPOSE 8080
CMD ["./myapp"]
1
2
3
4
5
6
7
8
9
10
11
12
13

3. 构建 Docker 镜像

在项目根目录下运行以下命令以构建 Docker 镜像：

docker build -t my-go-app .
1

4. 运行容器

使用以下命令运行容器：

docker run -d -p 8080:8080 my-go-app
1

现在，您可以通过浏览器访问 http://localhost:8080 来查看您的应用程序。

5. 使用 Docker Compose

创建 docker-compose.yml 文件

在项目根目录下创建一个名为 docker-compose.yml 的文件，并添加以下内容：

version: '3.8'
services:
  app:
    image: my-go-app
    ports:
      - "8080:8080"
    volumes:
      - .:/app
    command: sh -c "go run main.go"
1
2
3
4
5
6
7
8
9

运行 Docker Compose

在项目根目录下运行以下命令启动开发环境：

docker-compose up
1

6. 配置 CI/CD 流水线

使用 GitHub Actions 配置 CI/CD 流水线以自动化测试和部署过程。

创建 GitHub Actions 工作流文件

在项目根目录下创建 .github/workflows/ci.yml 并添加以下内容：

name: CI/CD Pipeline

on:
  push:
    branches:
      - main
  pull_request:
    branches:
      - main

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
    - name: Checkout code
      uses: actions/checkout@v2

    - name: Set up Go
      uses: actions/setup-go@v2
      with:
        go-version: '1.18'

    - name: Build with Go
      run: go build -v ./...

    - name: Build Docker image
      run: docker build -t my-go-app .

    - name: Push Docker image
      env:
        DOCKER_USERNAME: ${{ secrets.DOCKER_USERNAME }}
        DOCKER_PASSWORD: ${{ secrets.DOCKER_PASSWORD }}
      run: |
        echo $DOCKER_PASSWORD | docker login -u $DOCKER_USERNAME --password-stdin
        docker tag my-go-app $DOCKER_USERNAME/my-go-app:latest
        docker push $DOCKER_USERNAME/my-go-app:latest
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

确保在 GitHub 仓库中添加 Docker Hub 凭据作为秘密（secrets）。

7. 部署到 Kubernetes

使用 Kubernetes 部署和管理容器化的 Go 应用程序。

创建 Kubernetes 部署文件

在项目根目录下创建 k8s/deployment.yml 并添加以下内容：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-go-app
spec:
  replicas: 3
  selector:
    matchLabels:
      app: my-go-app
  template:
    metadata:
      labels:
        app: my-go-app
    spec:
      containers:
      - name: my-go-app
        image: <DOCKER_USERNAME>/my-go-app:latest
        ports:
        - containerPort: 8080
---
apiVersion: v1
kind: Service
metadata:
  name: my-go-app-service
spec:
  type: NodePort
  selector:
    app: my-go-app
  ports:
    - port: 8080
      targetPort: 8080
      nodePort: 30008
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

部署到 Kubernetes

使用 kubectl 命令将应用程序部署到 Kubernetes 集群：

kubectl apply -f k8s/deployment.yml
1

您可以通过访问 http://<NODE_IP>:30008 查看应用程序。

通过上述步骤，您已经学会了如何容器化并运行一个 Go 应用程序，设置本地开发环境，使用容器运行测试，配置 CI/CD 流水线，并将应用程序部署到 Kubernetes。