Cordium: open-source sandbox-платформа на Kubernetes

spec:
  image:
    registry:
      url: python:3.12-bookworm

  repository:
    url: https://github.com/myorg/my-project

  runtime:
    tasks:
      - name: install
        type: ON_CREATE
        workingDir: /workspace/repo
        run: pip install -r requirements.txt
        onFailure: ON_FAILURE_ABORT

spec:
  image:
    dockerfile:
      inline: |
        FROM node:22-bookworm

        ENV DEBIAN_FRONTEND=noninteractive

        RUN apt-get update -qq && \
            apt-get install -y --no-install-recommends \
              podman \
              postgresql-client \
              curl \
              git \
            && rm -rf /var/lib/apt/lists/*

        RUN npm install -g @anthropic-ai/claude-code

  repository:
    url: https://github.com/myorg/api-service
    cloneOptions:
      branch: ${{ vars.BRANCH }}
      depth: 1

  vars:
    - name: BRANCH
      value: main
    - name: TASK
      value: "Review the codebase and fix any failing tests."

  runtime:
    autoStop: true
    envVars:
      - key: NODE_ENV
        value: test
      - key: SENTRY_DSN
        fromSecret: sentry-dsn

    tasks:
      - name: install-dependencies
        type: ON_CREATE
        workingDir: /workspace/repo
        run: npm ci
        onFailure: ON_FAILURE_ABORT

      - name: start-postgres
        type: POST_START
        runAsRoot: true
        run: |
          podman rm -f workspace-postgres 2>/dev/null || true
          podman run \
            --name workspace-postgres \
            --net host \
            -e POSTGRES_PASSWORD=password \
            -e POSTGRES_DB=app \
            -d docker.io/postgres:16

          for i in $(seq 1 30); do
            pg_isready -h localhost -p 5432 -U postgres && break
            sleep 2
          done

      - name: run-tests
        type: POST_START
        workingDir: /workspace/repo
        run: npm test
        onFailure: ON_FAILURE_CONTINUE

      - name: run-agent
        type: POST_START
        workingDir: /workspace/repo
        run: claude "${{ vars.TASK }}"

  limit:
    cpu:
      millicores: 4000
    memory:
      megabytes: 8192
    storage:
      megabytes: 20480

export OCTELIUM_DOMAIN=example.com
# Создать Workspace из Template по умолчанию и подключить терминал
cordium run

# Подключиться к существующему Workspace (запускает его, если остановлен)
cordium run abc

# Создать из конкретного Template
cordium run --template ml-env.my-project

# Создать из YAML-файла конфигурации
cordium run --file workspace.yaml

# Создать из образа контейнера
cordium run --image python:3.11-slim

# Создать из Dockerfile
cordium run --dockerfile ./Dockerfile

# Создать из git-репозитория, клонировав конкретную ветку
cordium run --repository https://github.com/myorg/my-project --branch develop

# Создать в конкретном Space, используя его Template по умолчанию
cordium run --space my-project

# Создать временный (ephemeral) Workspace
cordium run --ephemeral

# Создать временный Workspace, который удаляется при завершении терминальной сессии
cordium run --ephemeral --rm

# Временная изолированная среда для ИИ-агента с ограничениями ресурсов и секретом
cordium run --ephemeral --rm \
  --image python:3.11-slim \
  --env-from-secret ANTHROPIC_API_KEY=anthropic-key \
  --cpu 2000 --memory 4096

# Задать переменные окружения
cordium run --image node:20 -e NODE_ENV=development -e PORT=3000

# Получить переменную из Space Secret
cordium run --template backend.my-project \
  --env-from-secret DATABASE_URL=staging-db-url

# Клонировать основной репозиторий и дополнительный с переменными
cordium run --repository https://github.com/myorg/api-service \
  --additional-repo shared-lib=https://github.com/myorg/shared-lib \
  --var SERVICE=services/payments \
  --var BRANCH=main


# Открыть терминал Workspace
cordium terminal abc
cordium term abc          # короткий псевдоним

# Выполнить команду и передать код завершения
cordium exec abc -- make test

# Выполнить в конкретной рабочей директории
cordium exec abc -w /workspace/repo -- go build ./...

# Выполнить от имени root
cordium exec abc --root -- apt-get install -y ripgrep
# Или
cordium exec abc -- sudo pt-get install -y ripgrep

# Задать переменные окружения для конкретной команды
cordium exec abc -e GOOS=linux -e GOARCH=amd64 -- go build ./...

# Получить вывод удалённой команды локально
cordium exec abc -- cat /workspace/repo/output.json > local.json

# Интерактивная SSH-сессия через встроенный SSH-клиент в Cordium CLI
cordium ssh abc

# Выполнить удалённую команду по SSH
cordium ssh abc -- uptime

# Локальный проброс портов
cordium ssh abc -L 5432:localhost:5432

# Несколько пробросов портов без открытия shell
cordium ssh abc -N -L 5432:localhost:5432 -L 6379:localhost:6379

# Динамический SOCKS5-прокси
cordium ssh abc -D 1080 -N

# Подключиться к кластеру Octelium для использования нативных SSH-утилит (OpenSSH, scp, rsync и т. д.)
octelium connect -d

# Сгенерировать блок SSH config для использования с VS Code, JetBrains, Zed, rsync
cordium ssh abc --print-config >> ~/.ssh/config

# Затем использовать VS Code Remote SSH
code --remote ssh-remote+cordium-abc /workspace/repo

# Также можно использовать другие инструменты, например rsync
rsync -avz ./dist/ cordium-abc:/workspace/repo/dist/

# Скопировать локальный файл в Workspace
cordium cp ./config.json abc:/workspace/repo/config.json

# Скопировать файл из Workspace локально
cordium cp abc:/workspace/repo/output.csv ./output.csv

# Рекурсивно скопировать директории
cordium cp -r ./src/ abc:/workspace/repo/src/

# Скопировать между двумя Workspace-ами
cordium cp abc:/workspace/repo/model.pt def:/workspace/repo/model.pt


# Стримить логи Workspace
cordium logs abc

# Запустить Workspace
cordium start abc

# Остановить Workspace
cordium stop abc
cordium delete workspace abc

# Создать Space
cordium create space my-project

# Создать Template с встроенной конфигурацией
cordium create template ml-env.my-project \
  --image python:3.11 \
  --repository https://github.com/myorg/ml-project \
  --env-from-secret WANDB_API_KEY=wandb-secret \
  --cpu 8000 --memory 16384

# Собрать pre-build снимок Template
cordium build ml-env.my-project

# Создать Workspace из Template с переопределением переменных
cordium run --template go-build.my-project \
  --var SERVICE=services/payments \
  --var BRANCH=main \
  --ephemeral

curl -o install-cluster.sh https://octelium.com/install-cluster.sh
chmod +x install-cluster.sh

# Замените <DOMAIN> на ваш реальный домен
./install-cluster.sh --domain <DOMAIN> --cordium

cordium run

# Установить CLI Octelium
curl -fsSL https://octelium.com/install.sh | bash
# Установить Cordium CLI
curl -fsSL https://octelium.com/install-cordium.sh | bash

# Установить CLI Octelium
iwr https://octelium.com/install.ps1 -useb | iex
# Установить Cordium CLI
iwr https://octelium.com/install-cordium.ps1 -useb | iex

brew install octelium/tap/octelium
brew install octelium/tap/cordium