LocalCloud Cloud Run Local Emulator
Get started
local.cloud — Cloud Run Local Emulator .md Open tab
LocalCloud Google Cloud in-a-box

Cloud Run

Cloud Run runs containerized applications behind HTTP endpoints on Google Cloud. LocalCloud runs supported service containers through Docker for local request tests.

When to use Cloud Run

Typical uses

Use when you can package an HTTP application in a container image and test it through a service URL. LocalCloud runs supported service containers with Docker.

Examples

  • Containerized HTTP APIs
  • Service deployment and update tests
Compute & Runtime

Cloud Run is opt-in to save memory. Add cloudrun to the services you start, for example localcloud start --local-only --services cloudrun,gcs,pubsub; --services sets the exact list.

Explore another service

View all
Local workflow

Example usage

Install the CLI, start LocalCloud, and export its environment in the same shell. Generated endpoints account for remapped ports.

1. Install and start · shell
curl -fsSL https://local.cloud/install.sh | sh
localcloud start --local-only --services cloudrun
# Export GOOGLE_CLOUD_PROJECT and CLOUD_RUN_EMULATOR_HOST
eval "$(localcloud env)"

Deploy and call a containerized API

  1. Build a test HTTP application into a container image.
  2. Create a local Cloud Run service using that image.
  3. Call its endpoint and verify the response after an update.

Documented workflows

  • Service/revision metadata
  • Docker container execution on service create/update

Service boundaries

  • Requires Docker runtime access
  • No jobs, domain mappings, or full revision traffic splitting
Try it in your project

Code examples and integrations

Start with the local guides. Official Google Cloud samples may need endpoint changes and can cover features outside the workflows listed here.

Integration

Build an integration test loop

Start the runtime, verify readiness, exercise your SDK, and clean up test state.

Open guide
Agent testing

Use Cloud Run with an AI agent

Before the agent changes application logic, have it create local Cloud Run state, read it back with the project SDK, and note which feature the check covered. That first local call catches accidental production routing and needs no GCP account, service-account key, or billing project.

Configure this repo

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.

Production endpoints, auth, IAM, quotas, regional behavior, and final release validation still need the target Google Cloud project.

Agent resources has more prompts and the AGENTS.md template.

Related guides

Desktop view