Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 30 additions & 0 deletions develop-docs/development-infrastructure/devservices.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -230,3 +230,33 @@ docker run --rm \
# Validate that data has been copied over
docker run --rm -v sentry_postgres-data:/data ubuntu ls -l /data
```

## Cloud Sandbox

The `devservices sandbox` commands manage GCE virtual machines pre-configured with all Sentry dependencies, Docker services, and development tools.

<Alert title="Employees Only" level="warning">
Cloud sandboxes require GCP project access. Contact #discuss-dev-infra for setup.
</Alert>

See the <Link to="/development/sandbox/">Cloud Sandbox documentation</Link> for full details.

### Quick Reference

```shell
devservices sandbox create [NAME] --project PROJECT # Create a new sandbox VM
devservices sandbox ssh [NAME] # SSH with auto port-forward
devservices sandbox ssh-config [NAME] --append # Generate SSH config for IDE integration
devservices sandbox sync [NAME] # Sync code changes
devservices sandbox logs [SERVICE] [-f] [--color] # View service logs (colored)
devservices sandbox migrate [NAME] # Run database migrations
devservices sandbox restart-devserver [NAME] # Restart the devserver
devservices sandbox exec "COMMAND" # Run a command on the sandbox
devservices sandbox hybrid [NAME] # Local devserver + remote services
devservices sandbox stop [NAME] # Stop VM (preserves disk)
devservices sandbox start [NAME] # Restart stopped VM
devservices sandbox destroy [NAME] # Delete VM and disk
devservices sandbox list # List all sandboxes
devservices sandbox status [NAME] # Show sandbox details
devservices sandbox port-forward [NAME] # Background port forwarding
```
3 changes: 3 additions & 0 deletions develop-docs/development-infrastructure/environment/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,9 @@ sidebar_order: 2
We primarily support development on macOS (arm64 only), but Linux (amd64) should be possible too.
If you run into any problems on either platform, please open an issue on [devenv](https://github.com/getsentry/devenv/).

<Alert title="Cloud Sandbox Alternative" level="info">
Don't want to run Docker and dependencies locally? Use a <Link to="/development/sandbox/">cloud sandbox</Link> — a pre-configured GCE VM with everything installed. Just `devservices sandbox create` and `devservices sandbox ssh`.
</Alert>

## Setup

Expand Down
Loading
Loading