2025-09-10 16:08:00

GitHub代码仓库自动化构建与镜像上传运维文档

1. 文档概述

本文档指导如何通过GitHub Actions实现以下目标：

自动构建Docker镜像
将镜像推送至指定的Docker仓库（如Docker Hub、私有仓库等）
触发条件：代码推送至指定分支（如 main ）时自动执行。

适用对象：运维工程师、DevOps团队成员。

2. 环境准备

2.1 前提条件

GitHub代码仓库（已包含Dockerfile和项目代码）
目标Docker仓库的账号权限（需用户名、密码或访问令牌）
GitHub仓库的Secrets配置权限

2.2 配置步骤

在GitHub仓库中设置Secrets：

进入仓库 → Settings → Secrets and variables → Actions

添加以下Secrets：

DOCKER_USERNAME：Docker仓库用户名
DOCKER_PASSWORD：Docker仓库密码或访问令牌
DOCKER_REPO：目标仓库地址（如 docker.io/your-username/repo-name ）

3. 自动化流程实现

3.1 创建GitHub Actions工作流文件

在仓库根目录下创建文件： .github/workflows/docker-build-push.yml ，内容如下：

name: Build and Push Docker Image

on:
  push:
    branches: [ "main" ]  # 触发分支

jobs:
  build-and-push:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Login to Docker Hub
        uses: docker/login-action@v2
        with:
          username: {{ secrets.DOCKER_USERNAME }}
          password: {{ secrets.DOCKER_PASSWORD }}

      - name: Build Docker image
        run: docker build -t {{ secrets.DOCKER_REPO }}:latest .

      - name: Push Docker image
        run: docker push {{ secrets.DOCKER_REPO }}:latest

YAML