github-actions

Examples: Using Locally with GitHub Actions

This directory contains examples of how to use Locally from a GitHub Actions workflow via the locallybuild/setup-locally action.

Dependencies

• A GitHub Actions workflow with id-token: write permission (so the runner can request an OIDC token).
• OIDC trust configured in your Locally account — either against your User or against a Team. See setup-locally's README for the full walkthrough.

Examples

• Creating a Resource Group from a workflow authenticating with a Team UUID
• Creating a Resource Group from a workflow authenticating with a User UUID

Both examples use workflow_dispatch so you can trigger them manually from the Actions tab. Each one:

1. Installs and starts Locally on the runner via locallybuild/setup-locally@v1.
2. Runs az group create against Locally using locally run.
3. Stops Locally and (on failure) uploads ci.log via locallybuild/setup-locally/teardown@v1.

The team-uuid / user-uuid values in these examples are placeholders — replace them with the UUID shown on the Team CI (OIDC) or User OIDC page in your Locally account.