如何在GitHub Actions中用同一Job适配多环境？

一、避免重复部署Job，动态关联环境 #

你不需要为每个环境写重复的Job，也不用靠bash脚本判断环境名。GitHub Actions可以直接通过github.ref_name获取当前分支的短名称（比如master、release、dev），动态绑定环境，同时用条件判断确保只触发对应分支的部署逻辑。

修改后的工作流示例：

name: Build & Deploy

on:
  push:
    branches: [master, release, dev]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      # 你的构建步骤
      - name: Execute build
        run: echo "Building application..."

  deploy:
    needs: build
    runs-on: ubuntu-latest
    # 直接用当前分支名关联对应环境
    environment: ${{ github.ref_name }}
    # 可选：限制仅指定分支触发部署
    if: contains(fromJSON('["master", "release", "dev"]'), github.ref_name)
    steps:
      - name: Deploy to target environment
        run: |
          echo "Deploying to ${{ github.ref_name }} environment"
          echo "Cluster URL: ${{ vars.CLUSTER_URL }}"

如果分支名和环境名不完全对应（比如master对应prod），可以用映射逻辑动态转换：

environment: ${{ 
  github.ref_name == 'master' && 'prod' || 
  github.ref_name == 'release' && 'staging' || 
  'dev' 
}}

另外你之前用的::set-env是已废弃的语法，现在推荐用echo "ENVIRONMENT=xxx" >> $GITHUB_ENV，但上面的动态环境写法更简洁，无需额外步骤。

二、优雅提取分支名作为Docker标签 #

不用放弃官方的docker/build-push-action，GitHub Actions提供了内置上下文变量和字符串处理函数解决这个问题：

方法1：直接使用github.ref_name #

github.ref_name本身就是分支的短名称（比如dev、release），直接用来打标签即可：

- name: Build Docker image
  uses: docker/build-push-action@v5
  with:
    context: .
    push: true
    tags: your-registry/your-image:${{ github.ref_name }}

方法2：用字符串函数处理github.ref #

如果需要兼容旧版上下文，也可以通过split+last函数提取分支名：

tags: your-registry/your-image:${{ last(split(github.ref, '/')) }}

该逻辑会把refs/heads/dev分割为['refs', 'heads', 'dev']，取最后一个元素就是dev。

关于矩阵方案的说明 #

矩阵的设计目标是并行执行多组参数的Job（比如同时部署到多个环境），所以它会触发多个部署任务，这和你“根据当前分支部署到对应单个环境”的需求不匹配，因此确实不适合这个场景。你需要的是基于分支的条件单环境部署，也就是上面第一种方案的写法。

内容的提问来源于stack exchange，提问作者amro4934