Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Быстрый старт

Путь от нуля до работающей машины. Нужен токен доступа — его выдаёт команда cps (альфа по приглашениям).

1. Установка CLI

curl -fsSL https://cps.run/install.sh | sh

Скрипт скачивает бинарь cps под вашу ОС/архитектуру и ставит его в ~/.local/bin. Если этого каталога нет в PATH:

export PATH="$HOME/.local/bin:$PATH"

Поддержка: Linux и macOS, x86_64 или arm64. Проверить установку:

cps version

2. Вход

cps login --token <ваш-токен>

По умолчанию API — https://cps.run. Выберите проект вашей организации:

cps project list          # показывает проект "default", созданный для вашей org
cps project use <prj_id>  # из списка выше

3. Запуск машины

cps new ubuntu --name dev --start --wait

По умолчанию: 1 vCPU, 512 MiB RAM, диск 4 GiB и TTL 24 часа (машина сама удалится через сутки, чтобы ничего не осталось работать по забывчивости). Переопределить: --cpu, --ram 2G, --disk 10G, --ttl 2h. Для постоянной машины (без авто-удаления) — --ttl 0.

4. Работа с машиной

cps ssh dev                       # root-шелл по SSH
cps exec dev -- uname -a          # разовая команда
cps cp ./file dev:/root/          # скопировать файл внутрь
cps expose dev 8080               # опубликовать порт по публичному HTTPS
cps metrics dev                   # живые CPU / память
cps ps                            # список ваших машин

cps expose вернёт публичный URL вида https://rte-....cps.run, проксирующий на указанный порт внутри машины.

5. Snapshot и backup

Машину нужно остановить (cps stop):

cps stop dev
cps snapshot create dev --name base --wait     # быстрая точка восстановления
cps backup create dev --name daily --wait      # durable-копия вне хоста (S3)
cps snapshot restore <snap> --name dev2 --start --wait

Snapshot — быстрый слепок диска (точка восстановления). Backup — durable-копия в off-host хранилище (S3), переживает потерю хоста и восстанавливается на любом хосте флота.

6. Уборка

cps rm dev --yes

Лимиты и этикет (альфа)

  • У вашей org есть квота ресурсов и лимит на число машин. cps предупредит при достижении лимита.
  • Машины аппаратно изолированы (Firecracker + jailer) и не видят друг друга.
  • Пожалуйста, без злоупотреблений (спам, сканирование, майнинг). Это приватная альфа.
  • Вопросы, баги, идеи → чат @cps_run в Telegram.

Если что-то не так

  • cps ssh завис → Ctrl-C и повторить; про устойчивые зависания напишите в чат.
  • 401/403 → токен истёк или выбран не тот проект (cps project use).
  • cps whoami показывает, под кем вы аутентифицированы.