Unity Cloud Build Trigger
ActionsTags
(2)A reusable GitHub Action that triggers a Unity Cloud Build for a specified commit SHA or branch. It returns the build ID upon success.
| Input | Required | Description | Default |
|---|---|---|---|
unity_org_id |
Yes | The Unity Organization ID (used in the endpoint orgs/{unity_org_id}). |
— |
unity_project_id |
Yes | The Unity Cloud Build Project ID. | — |
build_target_id |
Yes | The Build Target ID within the Unity Cloud Build project. | — |
authorization_header |
Yes | Authorization header for the Unity Cloud Build API (e.g., Authorization: Basic ...). |
— |
branch |
No | The Git branch to build. If provided, the latest commit SHA from this branch will be fetched. | '' |
clean |
No | Whether to perform a clean build (true or false). |
false |
platform |
No | The build platform (e.g., standalonewindows64). |
standalonewindows64 |
machine_type_label |
No | Machine type label for the build machine (e.g., win_premium_v1). |
win_premium_v1 |
| Output | Description |
|---|---|
build_id |
The ID of the triggered Unity Cloud Build. |
platform |
The platform of the triggered build. |
Trigger a build when a /build comment is added to a pull request.
on:
issue_comment:
types: [created]
jobs:
build:
runs-on: ubuntu-latest
if: >
github.event.issue.pull_request != null &&
startsWith(github.event.comment.body, '/build')
steps:
- name: Trigger Unity Cloud Build
uses: Matuyuhi/unity-cloud-build-action@{version}
with:
unity_org_id: ${{ secrets.UNITY_ORG_ID }}
unity_project_id: ${{ secrets.UNITY_PROJECT_ID }}
build_target_id: ${{ secrets.UNITY_BUILD_TARGET_ID }}
authorization_header: ${{ secrets.UNITY_AUTH_HEADER }}
branch: main # Optional: override branch to buildTrigger a build manually from the Actions tab, optionally specifying commit_sha or branch.
on:
workflow_dispatch:
inputs:
branch:
description: 'Branch to build (optional)'
required: false
jobs:
manual-build:
runs-on: ubuntu-latest
steps:
- name: Trigger Unity Cloud Build manually
uses: Matuyuhi/unity-cloud-build-action@{version}
with:
unity_org_id: ${{ secrets.UNITY_ORG_ID }}
unity_project_id: ${{ secrets.UNITY_PROJECT_ID }}
build_target_id: ${{ secrets.UNITY_BUILD_TARGET_ID }}
authorization_header: ${{ secrets.UNITY_AUTH_HEADER }}
branch: ${{ github.event.inputs.branch }}MIT License
For implementation details, see action.yml.
Unity Cloud Build Trigger is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.