flownative/action-docker-build

Docker Image Build GitHub Action 镜像文档

镜像概述

本Docker镜像专为GitHub Action设计，提供在GitHub工作流环境中执行Docker镜像构建任务的能力。它集成了Docker构建工具链，可直接在GitHub Actions runners中运行，用于自动化CI/CD流程中的Docker镜像构建环节。

核心功能与特性

• GitHub Action集成：无缝对接GitHub Actions工作流，支持通过YAML配置文件定义构建流程
• 标准Docker构建：支持docker build命令的完整功能，包括自定义Dockerfile路径、构建上下文等
• 参数化配置：支持通过环境变量和工作流参数自定义构建行为
• 轻量级设计：基于精简基础镜像，减少工作流执行时间和资源占用
• 多平台支持：可选支持多架构镜像构建（需配合Docker Buildx）

使用场景与适用范围

• GitHub仓库的自动化CI/CD流程
• 代码提交或PR触发的Docker镜像构建
• 版本发布时的镜像构建与标记
• 需要在GitHub Actions环境中标准化Docker构建流程的场景

使用方法与配置说明

基本使用（GitHub Action工作流配置）

在GitHub仓库的.github/workflows/目录下创建工作流文件（如build-image.yml），示例配置如下：

yaml
name: Build Docker Image

on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
      
      - name: Build Docker image
        uses: docker://[镜像名称]  # 替换为实际镜像名称
        with:
          dockerfile: ./Dockerfile  # Dockerfile路径
          context: .                # 构建上下文
          tags: my-image:latest     # 镜像标签
        env:
          DOCKER_REGISTRY: https://index.docker.io/v1/  # 可选：容器仓库地址

核心配置参数

环境变量配置

高级使用示例（带推送功能）

yaml
- name: Build and push Docker image
  uses: docker://[镜像名称]
  with:
    dockerfile: ./Dockerfile
    context: .
    tags: my-registry.com/my-image:latest,my-registry.com/my-image:${{ github.sha }}
    push: true  # 启用推送
  env:
    DOCKER_REGISTRY: https://my-registry.com/v1/
    DOCKER_USERNAME: ${{ secrets.DOCKER_USERNAME }}
    DOCKER_PASSWORD: ${{ secrets.DOCKER_PASSWORD }}

注意事项

• 确保GitHub Actions runner环境已安装Docker（通常ubuntu-latest环境默认包含）
• 敏感信息（如仓库凭证）应使用GitHub Secrets存储，避免明文配置
• 多平台构建需确保基础镜像支持对应架构，或通过buildx配置交叉构建
• 构建大型镜像时建议配置适当的超时时间（通过timeout-minutes参数）