Terraform

Terraform GCP emulator workflow

LocalCloud can provide local endpoint overrides for Terraform validation. Use it to catch resource wiring mistakes before a real Google Cloud plan or apply.

Read docs Check compatibility SDK examples

Agent prompt CTAs

Configure internal CI

Have an agent add a permitted non-production LocalCloud CI workflow.

Read https://local.cloud/docs/licensing/ before changing this automation. Keep the workflow within the Public Preview License's non-production boundary. Propose the smallest change that starts LocalCloud, waits for readiness, exports emulator env vars, runs integration tests locally, and avoids real GCP secrets.

Configure this repo

Have an agent wire an existing project to LocalCloud safely.

Set up this repository to use LocalCloud for local GCP development. First read https://local.cloud/ai/agents.md, then inspect this repo, identify the GCP services and SDK language, configure emulator environment variables, and run the narrowest integration test against localhost. Do not use real GCP credentials or production endpoints.

Fact

Use the Terraform env export endpoint.

Fact

Keep real provider credentials out of local validation.

Fact

Run real GCP plan/apply only as a separate production gate.

Endpoint export

Generate local provider overrides

Use the LocalCloud Terraform export endpoint to set local service endpoints. Keep those overrides scoped to the personal local shell or eligible automation job.

Agent instruction

Ask for the smallest plan first

Have the agent identify used Google provider resources, export LocalCloud endpoints, and run the narrowest local Terraform validation before proposing broader IaC changes.

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.

Terraform local setup

localcloud env --format terraform
export GOOGLE_APPLICATION_CREDENTIALS="$PWD/.localcloud/fake-service-account.json"
curl -fsS http://localhost:24080/terraform/readiness?mode=endpoint
terraform init
terraform plan

Limitations

Use 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.
Terraform provider behavior that depends on IAM, org policy, quotas, or regional managed services still needs real Google Cloud validation.

Next routes

Keep the agent on the supported path

Terraform docs — LocalCloud Terraform setup details.
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.