Skip to main content

​
Command Overview

beacon cloud gcs setup creates or prints self-serve Google Cloud Storage setup commands for cloud-agent telemetry.
Command syntax
beacon cloud gcs setup
The helper creates or validates a bucket, creates a dedicated uploader service account, grants object upload access, creates a service-account key, and prints the BEACON_CLOUD_GCS_* environment variables for cloud agents.
This self-serve flow passes a scoped Google service-account key into the provider-managed cloud agent environment. Use it for proof-of-concept testing and prototyping. For production enterprise deployments, use Asymptote Managed or contact Asymptote about secure forwarding in customer-managed infrastructure.

​
Examples

Create GCS resources and print cloud-agent environment variables:
Create GCS resources and print environment variables
beacon cloud gcs setup \
  --project "$GCP_PROJECT" \
  --bucket "$BEACON_CLOUD_GCS_BUCKET" \
  --prefix "$BEACON_CLOUD_GCS_PREFIX" \
  --service-account beacon-cloud-trace-uploader \
  --apply \
  --print-env
Print the setup commands without applying them:
Print GCS setup commands
beacon cloud gcs setup \
  --project "$GCP_PROJECT" \
  --bucket "$BEACON_CLOUD_GCS_BUCKET" \
  --prefix "$BEACON_CLOUD_GCS_PREFIX"

beacon cloud

Review cloud command group behavior.

Claude Code Cloud Agents

Configure Claude Code cloud agent telemetry and GCS upload end to end.

Cursor Cloud Agents

Configure Cursor cloud agent telemetry and GCS upload end to end.

Google Cloud Storage forwarding

Review local endpoint GCS forwarding for persistent endpoint deployments.