Skip to content

Conversation

@nitaibezerra
Copy link
Contributor

Summary

Adiciona documentação completa sobre VMs Sandbox para desenvolvedores no repositório central de documentação.

Novos Arquivos

docs/infraestrutura/sandbox-vms.md

Guia principal sobre VMs Sandbox:

  • Visão geral e propósito
  • Diagrama de arquitetura (Mermaid)
  • Como solicitar uma sandbox via PR
  • Machine types e custos
  • Conectar via SSH
  • Disco de dados persistente (/mnt/data)
  • Auto-shutdown às 19h
  • Troubleshooting

docs/onboarding/setup-sandbox.md

Setup do VSCode Remote SSH:

  • Pré-requisitos
  • Configuração SSH com tabs (Linux/macOS vs Windows)
  • Conectar no VSCode
  • Extensões recomendadas
  • Workflow diário
  • Troubleshooting
  • Alternativa: IAP Desktop (Windows)

Navegação

Adicionados ao mkdocs.yml:

  • Infraestrutura → VMs Sandbox
  • Onboarding → Setup Sandbox

Preview

Após merge, a documentação estará disponível em:

Test plan

  • Build local com poetry run mkdocs serve
  • Links internos funcionando
  • Mermaid diagrams renderizam

🤖 Generated with Claude Code

nitaibezerra and others added 3 commits December 6, 2025 23:02
Add comprehensive guides for sandbox development environments:

- infraestrutura/sandbox-vms.md: Main guide covering architecture,
  how to request a sandbox via PR, machine types, SSH access,
  data disk usage, auto-shutdown, and troubleshooting

- onboarding/setup-sandbox.md: VSCode Remote SSH setup guide
  with tabs for Linux/macOS and Windows, extensions, and
  daily workflow

- Updated mkdocs.yml navigation

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Add prominent sandbox section with:
- Quick link in Quick Start section
- Dedicated section with Mermaid diagram
- Benefits list with emojis
- Quick steps to create sandbox

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Remove BigQuery/data processing references - sandboxes are
currently for code development only. BigQuery integration
will be added in the future.

Changes:
- Updated home page diagram and benefits
- Updated sandbox-vms.md architecture diagram
- Simplified machine types table
- Changed messaging from "data processing" to "code development"

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@nitaibezerra nitaibezerra merged commit ac066b7 into main Dec 7, 2025
2 checks passed
@nitaibezerra nitaibezerra deleted the docs/sandbox-guides branch December 7, 2025 10:56
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.

2 participants