使用GitHub Actions可重用工作流安装软件的环境共享问题

问题根源 #

GitHub Actions中**每个Job都是运行在完全独立的Runner实例（虚拟机/容器）**中的，哪怕是通过workflow_call调用的可重用工作流里的Job，和主工作流中的Job也属于隔离的运行环境。这意味着：

• 一个Job中安装的软件、配置的环境变量，不会自动传递到另一个Job
• 不同Job的文件系统、运行时状态完全独立

你遇到的情况就是如此：cm-job在自己的Runner里安装了Quarto，但setup-quarto是在另一个独立Runner中执行，自然找不到前者安装的命令。

解决方案 #

1. 将安装与业务步骤合并到同一个Job #

如果setup-quarto的逻辑依赖Quarto的安装环境，最简单的方式是把两者放到同一个Job中，避免跨Job的环境隔离问题。

示例（reuse.yml）：

jobs:
  setup-and-run:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Install Quarto
        uses: ./path/to/cm-job-install-step # 或者直接编写Quarto安装逻辑
      - name: Setup Quarto
        run: |
          quarto --version # 此时可直接调用，因为处于同一个Job环境

2. 用缓存机制共享已安装的软件 #

通过GitHub Actions的缓存功能，把Quarto的安装目录缓存起来，后续Job读取缓存恢复环境：

在cm-job.yml中配置缓存：

jobs:
  install-quarto:
    runs-on: ubuntu-latest
    outputs:
      quarto-path: ${{ steps.install.outputs.quarto-path }}
    steps:
      - name: Install Quarto
        id: install
        run: |
          QUARTO_VERSION="1.4.549"
          QUARTO_DIR="/opt/quarto"
          mkdir -p $QUARTO_DIR
          curl -L https://github.com/quarto-dev/quarto-cli/releases/download/v${QUARTO_VERSION}/quarto-${QUARTO_VERSION}-linux-amd64.tar.gz | tar -xz -C $QUARTO_DIR --strip-components=1
          echo "quarto-path=$QUARTO_DIR/bin" >> $GITHUB_OUTPUT
      - name: Cache Quarto
        uses: actions/cache@v3
        with:
          path: /opt/quarto
          key: quarto-${{ runner.os }}-${{ env.QUARTO_VERSION }}

在reuse.yml中恢复缓存并配置环境：

jobs:
  install-quarto:
    uses: ./cm-job.yml
  setup-quarto:
    needs: install-quarto
    runs-on: ubuntu-latest
    steps:
      - name: Restore Quarto cache
        uses: actions/cache@v3
        with:
          path: /opt/quarto
          key: quarto-${{ runner.os }}-1.4.549
      - name: Add Quarto to PATH
        run: echo "${{ needs.install-quarto.outputs.quarto-path }}" >> $GITHUB_PATH
      - name: Verify Quarto
        run: quarto --version

3. 通过可重用工作流输出传递路径，手动配置环境 #

让可重用工作流输出Quarto的安装路径，主工作流接收后在后续Job中把路径添加到PATH环境变量：

cm-job.yml定义输出：

jobs:
  install-quarto:
    runs-on: ubuntu-latest
    outputs:
      quarto-bin-path: ${{ steps.install.outputs.path }}
    steps:
      - name: Install Quarto
        id: install
        run: |
          # 执行安装逻辑，获取Quarto的bin目录路径
          QUARTO_BIN=$(which quarto) || (echo "Quarto not found" && exit 1)
          QUARTO_BIN_PATH=$(dirname $QUARTO_BIN)
          echo "path=$QUARTO_BIN_PATH" >> $GITHUB_OUTPUT

reuse.yml中使用输出配置环境：

jobs:
  install-quarto:
    uses: ./cm-job.yml
  setup-quarto:
    needs: install-quarto
    runs-on: ubuntu-latest
    steps:
      - name: Add Quarto to PATH
        run: echo "${{ needs.install-quarto.outputs.quarto-bin-path }}" >> $GITHUB_PATH
      - name: Run Quarto command
        run: quarto check

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