Skip to main content

Command Overview

beacon cloud s3 setup creates or prints self-serve Amazon S3 setup commands for cloud-agent telemetry.
Command syntax
beacon cloud s3 setup
The helper creates or validates a bucket, blocks public access, creates a dedicated IAM user, grants prefix-scoped s3:PutObject, creates one access key, and prints the BEACON_CLOUD_S3_* plus AWS credential environment variables for cloud agents.
This self-serve flow passes scoped AWS access keys 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 S3 resources and print cloud-agent environment variables:
Create S3 resources and print environment variables
beacon cloud s3 setup \
  --bucket "$BEACON_CLOUD_S3_BUCKET" \
  --region us-east-1 \
  --prefix "$BEACON_CLOUD_S3_PREFIX" \
  --iam-user beacon-cloud-trace-uploader \
  --apply \
  --print-env
Print the setup commands without applying them:
Print S3 setup commands
beacon cloud s3 setup \
  --bucket "$BEACON_CLOUD_S3_BUCKET" \
  --region us-east-1 \
  --prefix "$BEACON_CLOUD_S3_PREFIX" \
  --iam-user beacon-cloud-trace-uploader \
  --print
The printed policy grants only:
s3:PutObject on arn:aws:s3:::<bucket>/<prefix>/*
Delete or rotate the generated IAM access key after the cloud-agent test is complete.

beacon cloud

Review cloud command group behavior.

Claude Code Cloud Agents

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

S3 forwarding

Review local endpoint S3 forwarding for persistent endpoint deployments.