Arc OS Docs Open in app →

Guía de Standard Cloud

El plan Starter Cloud incluye un contenedor Docker dedicado para tu equipo de IA. Esta guía cubre el aprovisionamiento, el acceso por terminal, la configuración de GitHub y la gestión del ciclo de vida.

Qué obtienes

Un contenedor Ubuntu 22.04 dedicado en Hetzner arc-cloud-prod (157.180.44.232):

Aprovisionamiento

  1. Mejora al plan Starter Cloud (Settings → Billing).
  2. Ve a Settings → Cloud Workspace.
  3. Haz clic en Provision Container — tarda ~30 segundos.
  4. Cuando el estado muestre ready, haz clic en Open Terminal.

Terminal web

El terminal es una sesión WebSocket completa de xterm.js enrutada a través del servidor CRM. Puedes ejecutar:

arc <project>          # start a bridge session
claude -p "..."        # direct Claude call
git clone ...          # clone your repo into /workspace

La sesión usa tu JWT del CRM para la autenticación — no se necesitan claves SSH desde tu navegador.

Enrutamiento Chat ↔ Cloud (Phase 70)

Una vez aprovisionado, los mensajes de chat del CRM o de Telegram se ejecutan dentro de tu contenedor, no en el servidor maestro. El worker lanza claude -p en /workspace/<project>; las ediciones aterrizan en tus repos de la bot-org; los snapshots de pausa por inactividad envían el trabajo a GitHub. Guía completa: cloud-chat-routing.md.

Repositorios

Cada proyecto de Arc OS recibe automáticamente un repo privado bajo una organización de GitHub gestionada por el bot. Tu Cloud Workspace clona cada repo de proyecto en /workspace/<project> al aprovisionar, y envía un snapshot al pausar. Tú diriges la sincronización desde tu portátil con arc pull / arc push / arc cloud sync.

Para el modelo completo — tres tipos de repo (system / project / external), la convención de nombres, los comandos del día a día y el flujo de repos externos — consulta cloud-repos.md.

Configuración SSH de GitHub (para repos externos)

Los repos auto-gestionados de Arc OS descritos arriba no requieren configuración — se autentican mediante un token de instalación de corta duración escrito en ~/.git-credentials automáticamente. La configuración SSH de abajo solo es necesaria cuando quieres clonar tus propios repos privados de GitHub como entradas external en el panel Repositories:

  1. En Settings → Cloud Workspace, haz clic en GitHub SSH Setup.
  2. Arc OS genera un par de claves Ed25519 en el contenedor.
  3. Copia la clave pública mostrada en la UI.
  4. Añádela en GitHub → Settings → SSH and GPG keys → New SSH key.
  5. Prueba con ssh -T [email protected] en el terminal.

Inactividad y reanudación

Los contenedores se pausan automáticamente tras 30 minutos de inactividad (un cron corre cada 5 min en el servidor API). Esto es intencional — un contenedor pausado cuesta $0 de cómputo.

Para reanudar:

La reanudación tarda ~2-3 segundos (unpause de Docker).

Estados del ciclo de vida

Estado Significado
provisioning Contenedor en creación
ready En ejecución, aceptando conexiones
paused Suspendido por inactividad, se reanuda con actividad
suspended Suspendido manualmente o por impago
deleted Desaprovisionado (cancelación)

Cancelación

Cuando cancelas Starter Cloud:

Para reactivarlo, vuelve a suscribirte a Starter Cloud — se aprovisiona un contenedor nuevo.

Seguridad