Гайд по Standard Cloud

Тариф Starter Cloud включает выделенный Docker-контейнер для твоей AI-команды. Этот гайд охватывает провижининг, доступ к терминалу, настройку GitHub и управление жизненным циклом.

Что ты получаешь

Выделенный контейнер Ubuntu 22.04 на Hetzner arc-cloud-prod (157.180.44.232):

Claude CLI предустановлен и аутентифицирован
Бинарник Arc предустановлен
Персистентный том /workspace (переживает рестарты контейнера)
Непривилегированный пользователь arcuser для безопасности
1.5 vCPU, 2 ГБ RAM, политика безопасности no-new-privileges

Провижининг

Перейди на тариф Starter Cloud (Settings → Billing).
Открой Settings → Cloud Workspace.
Нажми Provision Container — занимает ~30 секунд.
Когда статус станет ready, нажми Open Terminal.

Веб-терминал

Терминал — полноценная WebSocket-сессия xterm.js, проксируемая через CRM-сервер. Можно запускать:

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

Сессия использует твой CRM JWT для аутентификации — SSH-ключи из браузера не нужны.

Маршрутизация Chat ↔ Cloud (Phase 70)

После провижининга сообщения чата из CRM или Telegram выполняются внутри твоего контейнера, а не на мастер-сервере. Воркер запускает claude -p в /workspace/<project>; правки попадают в твои репозитории bot-org; снапшот при паузе по простою пушит работу на GitHub. Полный гайд: cloud-chat-routing.md.

Репозитории

Каждый проект Arc OS автоматически получает приватный репозиторий в управляемой ботом организации GitHub. Твой Cloud Workspace клонирует каждый репозиторий проекта в /workspace/<project> при провижининге и пушит снапшот при паузе. Синхронизацию с ноутбука ты ведёшь через arc pull / arc push / arc cloud sync.

Полная модель — три типа репозиториев (system / project / external), конвенция именования, повседневные команды и флоу внешних репозиториев — см. cloud-repos.md.

Настройка GitHub SSH (для внешних репозиториев)

Описанные выше авто-управляемые репозитории Arc OS не требуют никакой настройки — они аутентифицируются через короткоживущий installation token, автоматически записываемый в ~/.git-credentials. Настройка SSH ниже нужна только когда ты хочешь склонировать собственные приватные GitHub-репозитории как external записи в панели Repositories:

В Settings → Cloud Workspace нажми GitHub SSH Setup.
Arc OS сгенерирует пару Ed25519-ключей в контейнере.
Скопируй публичный ключ, показанный в UI.
Добавь его в GitHub → Settings → SSH and GPG keys → New SSH key.
Проверь командой ssh -T [email protected] в терминале.

Простой и возобновление

Контейнеры автоматически ставятся на паузу после 30 минут неактивности (cron выполняется каждые 5 минут на API-сервере). Это сделано намеренно — контейнер на паузе стоит $0 compute.

Чтобы возобновить:

Отправь любое сообщение в чате CRM Workspace
Выполни /continue в Telegram (если у проекта есть TG-бот)
Нажми Resume в Settings → Cloud Workspace

Возобновление занимает ~2-3 секунды (Docker unpause).

Состояния жизненного цикла

Состояние	Значение
`provisioning`	Контейнер создаётся
`ready`	Работает, принимает подключения
`paused`	Приостановлен по простою, возобновляется при активности
`suspended`	Приостановлен вручную или из-за проблем с оплатой
`deleted`	Депровижинен (отмена подписки)

Отмена подписки

При отмене Starter Cloud:

Статус контейнера сразу меняется на paused
Данные в /workspace сохраняются 7 дней
Через 7 дней контейнер депровижинится

Для повторной активации вернись на тариф Starter Cloud — будет создан новый контейнер.

Безопасность

Контейнер работает от arcuser (не root)
--cap-drop=ALL --security-opt=no-new-privileges в рантайме
SSH-мост с API-сервера использует выделенный ключ hetzner_ed25519 (не твой личный)
IP контейнера внутренний для сети Hetzner — прямого публичного доступа нет
Весь трафик проксируется через 62.171.128.248 (API-сервер Contabo) → 157.180.44.232 (контейнеры Hetzner)