本文将介绍如何在 Docker 项目中配置 GitHub Actions,用于搭建基础的 CI/CD 工作流。在正式创建流程之前,建议先明确自己的构建、测试与发布策略,以便后续配置更高效。
本指南主要包括以下内容:
- 以一个示例 Docker 项目为基础配置 GitHub Actions
- 创建并设置 GitHub Actions 工作流
- 优化工作流,减少拉取请求次数并缩短整体构建时间
- 仅在满足特定版本条件时将镜像推送到 Docker Hub
准备一个 Docker 项目
下面以一个简单的 Docker 示例项目为例进行说明。该示例仓库基于 Alpine 镜像并运行 Nginx。你可以直接克隆示例仓库,也可以使用自己的 Docker 项目完成相同配置。

配置访问凭据
在开始之前,需要确保 GitHub Actions 工作流能够访问 Docker Hub。为此,需要先在 GitHub 仓库中配置相应的机密信息。
操作步骤如下:
- 将你的 Docker ID 添加为 GitHub Secret。进入 GitHub 仓库后,依次点击 Settings > Secrets > New secret。
- 创建一个新的机密,名称设置为 DOCKER_HUB_USERNAME,值填写你的 Docker ID。
- 接着创建一个新的个人访问令牌(PAT)。进入 Docker Hub 的设置页面后,选择创建新的访问令牌。
- 可以将这个令牌命名为 simpleWhaleCI,便于后续识别和管理。

- 创建完成后,将该个人访问令牌作为第二个 GitHub Secret 添加到仓库中,名称设置为 DOCKER_HUB_ACCESS_TOKEN。

完成以上配置后,GitHub Actions 工作流就具备了访问 Docker Hub 的基础权限,可以继续进行后续的自动构建与镜像推送设置。
