Skip to content

docs: add cloud sandbox development documentation#16425

Draft
dashed wants to merge 6 commits intomasterfrom
alberto/sandbox-docs
Draft

docs: add cloud sandbox development documentation#16425
dashed wants to merge 6 commits intomasterfrom
alberto/sandbox-docs

Conversation

@dashed
Copy link
Member

@dashed dashed commented Feb 18, 2026

Summary

Adds comprehensive Cloud Sandbox documentation for developing sentry/getsentry on pre-configured GCE virtual machines.

Changes

New page: develop-docs/development-infrastructure/sandbox.mdx (~460 lines)

Complete sandbox documentation covering:

  • Quick Start (3-command setup)
  • IDE Integration:
    • VS Code Remote-SSH (workspace, interpreter, extensions, settings, debugging with launch.json)
    • JetBrains Gateway (SDK, source roots, database tool)
    • Terminal (vim, tmux)
  • Development Workflows (edit on VM, git-sync, auto-reload)
  • Sandbox Commands (17-command reference table)
  • Port Forwarding with named profiles (devserver, services, all)
  • Colored Logs (--color/--no-color with auto-detect)
  • Hybrid Mode (local devserver + remote services)
  • Syncing Changes (lockfile-aware dependency detection)
  • Running Commands (migrate, restart-devserver, exec)
  • Lifecycle Management (start, stop, destroy)
  • Troubleshooting (5 common issues with solutions)
  • What's Pre-installed (languages, containers, tools, databases, repos, services)

Modified: devservices.mdx

  • Added Cloud Sandbox section with employee-only warning
  • 17-command quick reference including --color flag

Modified: environment/index.mdx

  • Added Cloud Sandbox Alternative info callout

Test plan

  • All content reviewed for accuracy against actual devservices CLI implementation
  • Cross-references between sandbox.mdx and devservices.mdx work correctly
  • Command examples match current CLI argument structure
  • Port forwarding profiles match constants in devservices code

Add primary sandbox documentation page covering Quick Start, IDE
integration (VS Code Remote-SSH, JetBrains Gateway, terminal), port
forwarding, logs, sync, lifecycle management, and troubleshooting.

Add cross-reference callouts to existing environment and devservices docs.
@vercel
Copy link

vercel bot commented Feb 18, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
develop-docs Ready Ready Preview, Comment Feb 18, 2026 5:01am
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
sentry-docs Ignored Ignored Preview Feb 18, 2026 5:01am

Request Review

Add detailed setup instructions including multi-root workspace, Python
interpreter config, recommended extensions, settings JSON, debugging
with launch.json, JetBrains SDK/source roots, and database tool config.
Add convenience commands to the command reference table, quick reference,
and a new "Running Commands" section with usage examples.
Add port profiles section (devserver, services, all) and hybrid mode
workflow for running devserver locally with remote sandbox services.
Includes step to stop remote devserver to free VM resources.
Simplify hybrid mode docs from 4 manual steps to a single
devservices sandbox hybrid command. Add hybrid to command
reference tables.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

Comments