LocalCloud LocalCloud Google Cloud in-a-box
Glossary

Sandboxed cloud SDK

A standard cloud client library configured so its requests resolve to a local emulator instead of the public cloud endpoint, without changing application code.

Read docs Check compatibility SDK examples
Fact

Routing is normally done with emulator environment variables loaded into the process.

Fact

Some clients ignore those variables and need explicit endpoint configuration.

Fact

Confirm the client is not silently falling back to real Google Cloud before trusting a local result.

Definition

What Sandboxed cloud SDK means here

A standard cloud client library configured so its requests resolve to a local emulator instead of the public cloud endpoint, without changing application code.

  • Routing is normally done with emulator environment variables loaded into the process.
  • Some clients ignore those variables and need explicit endpoint configuration.
  • Confirm the client is not silently falling back to real Google Cloud before trusting a local result.
LocalCloud boundary

How to use the term safely

In LocalCloud content, this term should not imply production replacement, legal permission, hidden credentials, or complete cloud parity. It describes a bounded local-development workflow that still needs license review and release validation against real Google Cloud.

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.
Next routes

Keep the agent on the supported path

  • SDK examples — Routing standard Google Cloud clients at LocalCloud.
  • Agent routes — Agent sandbox entry points.
  • Compatibility — Service support boundaries.
  • 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.