Przewodnik po Standard Cloud

Plan Starter Cloud obejmuje dedykowany kontener Docker dla Twojego zespołu AI. Ten przewodnik opisuje provisioning, dostęp do terminala, konfigurację GitHub i zarządzanie cyklem życia.

Co otrzymujesz

Dedykowany kontener Ubuntu 22.04 na serwerze Hetzner arc-cloud-prod (157.180.44.232):

• Claude CLI preinstalowane i uwierzytelnione
• Binarka Arc preinstalowana
• Trwały wolumen /workspace (przeżywa restarty kontenera)
• Użytkownik non-root arcuser dla bezpieczeństwa
• 1.5 vCPU, 2 GB RAM, polityka bezpieczeństwa no-new-privileges

Provisioning

1. Przejdź na plan Starter Cloud (Settings → Billing).
2. Wejdź w Settings → Cloud Workspace.
3. Kliknij Provision Container — zajmuje ~30 sekund.
4. Gdy status pokaże ready, kliknij Open Terminal.

Terminal webowy

Terminal to pełna sesja WebSocket xterm.js proxowana przez serwer CRM. Możesz uruchamiać:

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

Sesja używa Twojego JWT z CRM do uwierzytelniania — przeglądarka nie potrzebuje kluczy SSH.

Routing czat ↔ Cloud (Phase 70)

Po provisioningu wiadomości czatu z CRM lub Telegrama działają wewnątrz Twojego kontenera, a nie na serwerze master. Worker uruchamia claude -p w /workspace/<project>; edycje trafiają do Twoich repozytoriów bot-org; snapshoty przy pauzie bezczynności wypychają pracę na GitHub. Pełny przewodnik: cloud-chat-routing.md.

Repozytoria

Każdy projekt Arc OS automatycznie otrzymuje prywatne repo w organizacji GitHub zarządzanej przez bota. Twój Cloud Workspace klonuje każde repo projektu do /workspace/<project> przy provisioningu i wypycha snapshot przy pauzie. Synchronizację ze swojego laptopa sterujesz przez arc pull / arc push / arc cloud sync.

Pełny model — trzy typy repo (systemowe / projektowe / zewnętrzne), konwencja nazewnictwa, codzienne komendy i przepływ repo zewnętrznych — opisany jest w cloud-repos.md.

Konfiguracja GitHub SSH (dla repo zewnętrznych)

Opisane wyżej repozytoria auto-zarządzane przez Arc OS nie wymagają żadnej konfiguracji — uwierzytelniają się przez krótkotrwały token instalacyjny zapisywany automatycznie do ~/.git-credentials. Poniższa konfiguracja SSH jest potrzebna tylko, gdy chcesz sklonować własne prywatne repozytoria GitHub jako wpisy zewnętrzne w panelu Repositories:

1. W Settings → Cloud Workspace kliknij GitHub SSH Setup.
2. Arc OS generuje parę kluczy Ed25519 w kontenerze.
3. Skopiuj klucz publiczny pokazany w UI.
4. Dodaj go w GitHub → Settings → SSH and GPG keys → New SSH key.
5. Przetestuj przez ssh -T [email protected] w terminalu.

Bezczynność i wznawianie

Kontenery auto-pauzują się po 30 minutach bezczynności (cron działa co 5 min na serwerze API). To celowe — wstrzymany kontener kosztuje $0 mocy obliczeniowej.

Aby wznowić:

• Wyślij dowolną wiadomość w czacie Workspace w CRM
• Uruchom /continue w Telegramie (jeśli Twój projekt ma bota TG)
• Kliknij Resume w Settings → Cloud Workspace

Wznawianie zajmuje ~2-3 sekundy (Docker unpause).

Stany cyklu życia

Anulowanie

Gdy anulujesz Starter Cloud:

• Status kontenera natychmiast zmienia się na paused
• Twoje dane w /workspace są zachowywane przez 7 dni
• Po 7 dniach kontener jest deprovisionowany

Aby ponownie aktywować, wróć na plan Starter Cloud — zostanie zprovisionowany nowy kontener.

Bezpieczeństwo

• Kontener działa jako arcuser (non-root)
• --cap-drop=ALL --security-opt=no-new-privileges w runtime
• Bridge SSH z serwera API używa dedykowanego klucza hetzner_ed25519 (nie Twojego osobistego)
• IP kontenera jest wewnętrzne dla sieci Hetzner — brak bezpośredniego dostępu publicznego
• Cały ruch proxowany przez 62.171.128.248 (serwer API Contabo) → 157.180.44.232 (kontenery Hetzner)