如何在GitHub Actions中统一管理多环境变量并复用至Docker镜像

针对多工作流文件重复定义环境变量的问题，以下是几个高效的复用方案：

1. 仓库级全局变量/密钥管理 #

直接在GitHub仓库的设置中定义全局变量和敏感密钥，所有工作流均可直接引用，无需在每个文件中重复声明：

• 操作步骤：进入仓库 → Settings → Secrets and variables → Actions
  • 在Variables中添加非敏感全局变量（如REGISTRY、IMAGE_NAME）
  • 在Secrets中添加敏感信息（如数据库账号密码、Docker Hub令牌）
• 工作流中用法：

  # 无需在工作流的env块中重复定义，直接引用
  - name: Execute Gradle build
    run: ./gradlew build --scan
    env:
      DO_POSTGRESQL_URL: ${{ secrets.DO_POSTGRESQL_URL }}
      DO_POSTGRESQL_USER: ${{ secrets.DO_POSTGRESQL_USER }}
  
  - name: Build and push Docker images
    uses: docker/build-push-action@v4.0.0
    with:
      tags: ${{ vars.REGISTRY }}/${{ vars.IMAGE_NAME }}:latest
  

• 优势：统一管理，一次修改全工作流生效，敏感信息存储在Secrets中更安全。

2. 复用工作流模板（Reusable Workflows） #

将通用的环境变量、前置步骤（如Java配置、测试、Docker登录）封装成独立的复用工作流，其他工作流直接调用即可：

• 创建复用模板（比如.github/workflows/reusable-base.yml）：

  name: Reusable Base Workflow
  on:
    workflow_call:
  
  env:
    REGISTRY: "abc"
    IMAGE_NAME: "defg"
  
  jobs:
    base-setup:
      runs-on: ubuntu-latest
      environment: test
      steps:
        - uses: actions/checkout@v3
        - name: Setup Java
          uses: actions/setup-java@v3
          with:
            java-version: 18
            distribution: temurin
            cache: gradle
        - name: Setup Gradle
          uses: gradle/gradle-build-action@v2
        - name: Execute Gradle build
          run: ./gradlew build --scan
          env:
            DO_POSTGRESQL_URL: ${{ secrets.DO_POSTGRESQL_URL }}
            DO_POSTGRESQL_USER: ${{ secrets.DO_POSTGRESQL_USER }}
            DO_POSTGRESQL_PASS: ${{ secrets.DO_POSTGRESQL_PASS }}
        - name: Login to Docker Hub
          uses: docker/login-action@v2.1.0
          with:
            username: ${{ secrets.DOCKER_HUB_USERNAME }}
            password: ${{ secrets.DOCKER_HUB_ACCESS_TOKEN }}
  

• 在其他工作流中调用：

  name: Deploy to Linode k8s Cluster Workflow
  on:
    push:
      branches: [ "master" ]
    pull_request:
      branches: [ "master" ]
    workflow_dispatch:
  
  jobs:
    setup:
      uses: ./.github/workflows/reusable-base.yml
    deploy:
      needs: setup
      runs-on: ubuntu-latest
      steps:
        - uses: actions/checkout@v3
        - name: Build and push Docker images
          uses: docker/build-push-action@v4.0.0
          with:
            context: .
            build-args: |
              JAR_FILE=build/libs/*SNAPSHOT.jar
              DO_POSTGRESQL_URL=${{ secrets.DO_POSTGRESQL_URL }}
            push: true
            tags: ${{ vars.REGISTRY }}/${{ vars.IMAGE_NAME }}:latest
        # Linode部署步骤
  

• 优势：不仅复用环境变量，还能复用重复的前置步骤，大幅减少代码冗余，维护成本更低。

3. 环境文件加载（适合非敏感变量） #

在仓库根目录创建一个存储非敏感变量的文件（如.env.common），在工作流中加载该文件到环境变量：

• 创建.env.common文件：

  REGISTRY=abc
  IMAGE_NAME=defg
  

• 工作流中加载：

  - name: Load common environment variables
    run: cat .env.common >> $GITHUB_ENV
  

• 注意：敏感信息绝对不能存放在此文件中，必须使用仓库Secrets单独管理。

内容的提问来源于stack exchange，提问作者Just A Question