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

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"]

3. 构建 Docker 镜像

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

docker build -t my-go-app .

4. 运行容器

使用以下命令运行容器：

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

现在，您可以通过浏览器访问 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"

运行 Docker Compose

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

docker-compose up

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

确保在 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