Гайд по Standard Cloud

План Starter Cloud включає виділений Docker-контейнер для твоєї AI-команди. Цей гайд охоплює провіжининг, доступ до термінала, налаштування GitHub і керування життєвим циклом.

Що ти отримуєш

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

• Claude CLI попередньо встановлений і автентифікований
• Бінарник Arc попередньо встановлений
• Постійний том /workspace (переживає рестарти контейнера)
• Non-root користувач arcuser для безпеки
• 1.5 vCPU, 2 GB RAM, security-політика no-new-privileges

Провіжининг

1. Перейди на план Starter Cloud (Settings → Billing).
2. Відкрий Settings → Cloud Workspace.
3. Натисни Provision Container — займає ~30 секунд.
4. Коли статус стане 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 виконуються всередині твого контейнера, а не на master-сервері. Воркер запускає claude -p у /workspace/<project>; правки лягають у твої bot-org репозиторії; snapshot при паузі через простій пушить роботу на GitHub. Повний гайд: cloud-chat-routing.md.

Репозиторії

Кожен проєкт Arc OS автоматично отримує приватний репозиторій у керованій ботом GitHub-організації. Твій Cloud Workspace клонує кожен репозиторій проєкту в /workspace/<project> при провіжинингу і пушить snapshot при паузі. Синхронізацію з ноутбука керуєш через 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:

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

Простій і відновлення

Контейнери автоматично ставляться на паузу після 30 хвилин неактивності (cron виконується кожні 5 хв на API-сервері). Це навмисно — призупинений контейнер коштує $0 compute.

Щоб відновити:

• Надішли будь-яке повідомлення у чат CRM Workspace
• Виконай /continue у Telegram (якщо у проєкту є TG-бот)
• Натисни Resume у Settings → Cloud Workspace

Відновлення займає ~2-3 секунди (Docker unpause).

Стани життєвого циклу

Скасування

Коли ти скасовуєш Starter Cloud:

• Статус контейнера одразу змінюється на paused
• Дані у /workspace зберігаються 7 днів
• Через 7 днів контейнер депровіжиниться

Щоб реактивувати, знову перейди на Starter Cloud — буде створено новий контейнер.

Безпека

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