跳至主要内容

環境參數 Action

在 macOS CI/CD workflow 中一鍵設定 Macrunara 運行環境:品牌橫幅、輸入參數校驗、環境資訊匯出(環境變數 + Action outputs + Step Summary)。Macrunara 是基於 Apple Silicon M4 集群的高性能 macOS CI/CD Runner 託管平台。

輸入參數​

參數必填預設值說明
installation-id是—Macrunara Installation ID,必須為純數字
region否auto機房選擇,保持預設 auto 即可
timeout-minutes否30最大執行時長(分鐘),正整數;超過 30 會輸出 warning(與 Free 計劃上限對齊)

輸出參數​

參數說明
region生效的區域
timeout-minutes生效的超時時間

同時會將 MACRUNARA_REGION / MACRUNARA_INSTALLATION_ID / MACRUNARA_TIMEOUT_MINUTES 寫入環境變數,供同一 job 的後續 step 直接使用。

更多用法​

指定區域:

- uses: macrunara/setup-action@v1
with:
installation-id: ${{ secrets.MACRUNARA_INSTALLATION_ID }}
region: auto

讀取 outputs:

- uses: macrunara/setup-action@v1
id: macrunara
with:
installation-id: ${{ secrets.MACRUNARA_INSTALLATION_ID }}
- run: echo "region = ${{ steps.macrunara.outputs.region }}"

技術說明​

本 Action 是 Composite Action(複合動作),不含獨立執行時,所有步驟以 bash 直接在 Runner 上執行,輕量無依賴,與 macOS 自託管 Runner 環境完全相容。Runner 調度由 Macrunara 平台(GitHub App → 控制平面 → Mac mini M4 集群)完成,本 Action 只負責入口側的設定校驗與環境資訊匯出。