No GCP secrets are required for the bounded local job.
GitHub Actions
LocalCloud in GitHub Actions
The Public Preview License permits individuals and organizations, including for-profit companies, to run ongoing internal CI without payment or a license key.
Readiness gate: http://localhost:24080/health.
Keep the workflow non-production and review the proprietary Public Preview License.
Health before tests
The workflow should fail fast if LocalCloud is not healthy. Do not let tests silently fall back to production SDK endpoints.
Keep local jobs credentialless
A LocalCloud PR job should not need service-account JSON, workload identity, or a billing project. If a later deployment job needs them, keep it separate and guarded.
Copy-ready setup
Commands and prompts
Use these snippets as starting points, then keep the checks scoped to localhost until you intentionally validate against real Google Cloud.
GitHub Actions YAML
name: localcloud-integration-tests
on: [pull_request]
jobs:
test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Start LocalCloud
run: |
# Public preview permits non-production internal organization and team CI.
# Pin a qualified image digest before relying on this workflow.
docker run -d --name localcloud -p 127.0.0.1:24080-24092:24080-24092 -m 4g jaysen2apache/localcloud:latest
for i in $(seq 1 60); do curl -fsS http://localhost:24080/health && exit 0; sleep 2; done
docker logs localcloud
exit 1
- name: Export emulator env and test
run: |
eval "$(curl -fsS http://localhost:24080/env?format=shell)"
./scripts/integration-test.shUse the sandbox deliberately
- Permitted workflows use local endpoint values and should stop rather than fall back to real Google Cloud or real credentials. The Public Preview License permits individuals and organizations, including for-profit companies, to use LocalCloud for non-production internal development, testing, CI, evaluation, and pilots.
- LocalCloud emulates bounded local development workflows. Validate application behavior against real Google Cloud before production deployment.
- Before production deployment, unset LocalCloud emulator environment variables and validate behavior against real Google Cloud.
Keep the agent on the supported path
- Terraform docs — Endpoint override patterns for IaC.
- Integration testing — How to structure localhost verification.
- Compatibility matrix — Check current support boundaries before relying on a local-only test.
- Service catalog — Review every LocalCloud service, endpoint, and limitation.
- SDK examples — Use standard Google Cloud SDKs pointed at localhost.
- Seed data — Load deterministic fixtures for repeatable agent and CI runs.