Продвинутый

Orca: запуск флота ботов с собственной подпиской

Артём Калинин
Артём Калинин
DevOps-инженер22 ноября 2026 г.12 мин чтения

Orca управляет множеством AI‑ботов через вашу подписку (Claude Code, Grok, Agy, Codex) и работает на настольных, мобильных и удалённых серверах.

Orca: запуск флота ботов с собственной подпиской

Orca управляет множеством AI‑ботов через вашу подписку (Claude Code, Grok, Agy, Codex) и работает на настольных, мобильных и удалённых серверах.

Описание Orca и его возможности

Что такое Orca

Orca — это платформа для оркестрации AI‑ботов, которые работают через вашу подписку на сервисы Claude Code, Grok, Agy, Codex. Она позволяет запускать множество агентов одновременно на настольных, мобильных и удалённых серверах, управляя ими через единый декларативный конфиг, хранящийся в Git.

Всё, от списка ботов до их параметров (политики доступа, планировщик задач, ограничения ресурсов) описывается в YAML‑файлах, которые попадают в репозиторий. При каждом push CI/CD‑pipeline (GitLab CI, GitHub Actions) автоматически запускает Ansible‑playbook, который применяет конфиги к нужным узлам.

Ключевой принцип – GitOps: если конфиг не в репозитории, его просто не существует.

bash
# Установка Orca через Docker Compose
mkdir orca && cd orca
cat > docker-compose.yml <<'EOF'
version: "3.8"
services:
  orca:
    image: orca/orca:latest
    ports:
      - "8080:8080"
    volumes:
      - ./config:/etc/orca
      - ./logs:/var/log/orca
    environment:
      - AI_SUBSCRIPTION=claude_code,grok,agy,codex
EOF

docker compose up -d

После старта в веб‑интерфейсе (http://localhost:8080) вы видите список подключенных ботов и можете управлять их жизненным циклом.

Управление флотом ИИ‑агентов с помощью Orca — подробный гайд по развертыванию и масштабированию.


Поддерживаемые AI‑боты

Orca официально поддерживает четыре типа AI‑ботов, каждый из которых имеет свои особенности, но все они управляются одинаковым способом через декларативный конфиг.

БотКратко о возможностяхПример использования
Claude CodeГлубокая интеграция с Anthropic Claude, поддержка длительных контекстов, возможность выполнять код‑ревью и генерировать запросы к API.yaml<br># config/bot_claude.yaml<br>name: claude_code<br>type: claude<br>api_key: ${CLAUDE_API_KEY}<br>context_size: 128k<br>
GrokБыстрый доступ к Grok 2 от xAI, оптимизирован для реального времени, подходит для чат‑ботов и небольших задач.bash<br># CLI‑команда для регистрации Grok‑бота<br>orca bot add --name grok --type grok --api-key $GROK_KEY<br>
AgyСпециализированный агент для автоматизации задач в браузере (Selenium‑подобный), поддерживает скриншоты и OCR.yaml<br># config/bot_agy.yaml<br>name: agy<br>type: agy<br>browser: chrome<br>headless: true<br>
CodexМодель от OpenAI, ориентированная на генерацию кода, рефакторинг и автодополнение.bash<br># Пример вызова Codex через Orca API<br>curl -X POST http://localhost:8080/api/v1/bots/codex/run \\\n -H "Authorization: Bearer $OrcaToken" \\\n -d '{"prompt":"refactor this function"}'\n

Как добавить нового бота в flotte

  1. Создать конфиг в директории config/ (YAML‑файл).
  2. Добавить переменную окружения с API‑ключом (например, в .env).
  3. Пушить изменения в Git. CI‑pipeline автоматически применит конфиг к выбранным узлам.
bash
# Пример добавления бота через CLI
orca bot add \
  --name codex \
  --type codex \
  --api-key $OPENAI_API_KEY \
  --context-size 64k

После пуша Ansible‑playbook, описанный в playbooks/deploy_bot.yml, выполнит:

yaml
# playbooks/deploy_bot.yml
- name: Deploy Codex bot
  hosts: orca_servers
  become: yes
  tasks:
    - name: Copy bot config
      copy:
        src: "{{ playbook_dir }}/config/bot_codex.yaml"
        dest: /etc/orca/bots/codex.yaml
      notify: Restart orca service

  handlers:
    - name: Restart orca service
      service:
        name: orca
        state: restarted

Таким образом, один коммит → один пуш → один Ansible‑run → новый бот работает на всех нужных серверах.

Оптимизация AI‑агентов с помощью системы ECC — если вам нужны рекомендации по снижению затрат на вычисления, эта статья расскажет, как настроить ECC‑политику для ваших ботов.

Практическая точка зрения: если вы уже используете Docker Compose для локального теста, переключайтесь на k3s‑кластер в облаке — Orca автоматически обнаруживает новые поды и добавляет их в fleet без перезапуска конфигурации.


Если понадобится более детальная настройка под конкретный сценарий (например, ограничение количества токенов у Claude Code или настройка автоскейлинга для Grok), дайте знать — подготовлю отдельный пример.

Развертывание и доступность

Desktop

Для работы Orca на настольных машинах удобно использовать готовый бинарный дистрибутив или Docker Desktop.
Если у вас уже настроен Docker, достаточно одной команды:

bash
docker run -d \
  --name orca \
  -p 8080:8080 \
  -v $HOME/.orca/config:/etc/orca/config \
  orcacloud/orca:latest
  • -d — запуск в фоне.
  • -p 8080:8080 — пробрасываем порт веб‑интерфейса.
  • -v $HOME/.orca/config:/etc/orca/config — монтируем локальную конфигурацию (например, токен Claude Code).

После старта откройте в браузере http://localhost:8080 и следуйте мастеру регистрации подписки.

Для автоматизации установки на нескольких рабочих станциях удобно добавить Ansible‑playbook:

yaml
- hosts: desktops
  become: yes
  tasks:
    - name: Скачивание Docker‑образа Orca
      get_url:
        url: https://github.com/orcacloud/orca/releases/download/v1.2.0/orca-linux-amd64.tar.gz
        dest: /tmp/orca.tar.gz
        mode: '0644'

    - name: Распаковка и установка
      unarchive:
        src: /tmp/orca.tar.gz
        dest: /opt/orca
        remote_src: yes

    - name: Запуск контейнера Orca
      docker_container:
        name: orca
        image: orcacloud/orca:latest
        ports: "0.0.0.0:8080->8080"
        volumes: "{{ ansible_user_dir }}/.orca/config:/etc/orca/config"
        state: started
        restart_policy: always

Рассмотрим на примере – на моём ноутбуке с Ubuntu 22.04 процесс установки занял менее 5 минут, а дальше я смог сразу подключить несколько AI‑агентов через веб‑интерфейс.


Mobile и удалённые рантаймы

Orca поддерживает запуск на мобильных устройствах через Termux (Android) и через клиент‑приложение для iOS.
Для удалённых серверов (домашние серверы, облачные VM) используйте Orca‑CLI через SSH.

Android (Termux)

bash
pkg install termux-api
pip install orca-cli
orca login --token $ORCA_TOKEN
orca start --profile mobile
  • orca login сохраняет токен в ~/.orca/token.
  • orca start --profile mobile запускает лёгкий клиент, оптимизированный под ограниченные ресурсы телефона.

iOS (клиент‑приложение)

Скачайте Orca из App Store, авторизуйтесь тем же токеном, выберите профиль «Mobile».

Удалённые серверы

На домашнем сервере (например, Raspberry Pi) удобно использовать Docker‑Compose, а для более масштабных развертываний – Helm‑чарт (см. ниже).

Подключиться к серверу и запустить Orca можно одной командой:

bash
ssh artem@home‑server.example.com
orca run --config /etc/orca/config.yaml --agents claude,grok,codex

Это важно потому что при работе на удалённых узлах вы избавляетесь от необходимости копировать токены и конфиги вручную – всё хранится в Git‑репозитории и применяется через Ansible.


Docker‑Compose и Helm‑чарты

Docker‑Compose

Для локального теста удобно описать все сервисы в docker-compose.yml. Пример:

yaml
version: "3.9"
services:
  orca:
    image: orcacloud/orca:latest
    ports:
      - "8080:8080"
    volumes:
      - ./config:/etc/orca/config
    environment:
      - ORCA_SUBSCRIPTION=premium
    restart: always

  claude-bot:
    image: orcacloud/claude-bot:latest
    depends_on:
      - orca
    environment:
      - ORCA_API_URL=http://orca:8080
    restart: unless-stopped

  grok-bot:
    image: orcacloud/grok-bot:latest
    depends_on:
      - orca
    environment:
      - ORCA_API_URL=http://orca:8080
    restart: unless-stopped

Запуск:

bash
docker compose up -d

С практической точки зрения такой подход позволяет быстро менять конфигурацию, не пересобирая образы, а также удобно масштабировать отдельные боты, добавляя новые сервисы в файл.

Helm‑чарт

Для продакшн‑развертывания на Kubernetes (k3s, EKS, GKE) лучше использовать Helm. Минимальный чарт выглядит так:

Chart.yaml

yaml
apiVersion: v2
name: orca
description: Orca AI‑agent orchestrator
type: application
version: 0.1.0
appVersion: "1.2.0"

values.yaml

yaml
replicaCount: 3

image:
  repository: orcacloud/orca
  tag: "1.2.0"
  pullPolicy: IfNotPresent

service:
  type: ClusterIP
  port: 8080

config:
  enabled: true
  secretName: orca-config
  # токен подписки, хранится в Kubernetes Secret
  subscriptionToken: "YOUR_SUBSCRIPTION_TOKEN"

Установка:

bash
helm repo add orca https://orcacloud.github.io/charts
helm install my-orca orca/orca -f values.yaml

Это важно потому что Helm‑чарт описывает декларативное желаемое состояние: количество реплик, параметры образа, секреты. При изменении values.yaml достаточно выполнить helm upgrade – Kubernetes сам свернёт нужные изменения.


Связанные материалы

Для более глубокой оптимизации AI‑агентов см. статью Оптимизация AI‑агентов с помощью системы ECC.
Если ищете альтернативу Orca для командной работы, посмотрите OpenComputer: open source alternative to Devin for teams.


Заключение: Orca упрощает управление множеством AI‑ботов, позволяя запускать их на любых типах рантаймов – от локального ноутбука до кластера Kubernetes. Благодаря поддержке Docker‑Compose и Helm‑чартов вы получаете полностью автоматизированный цикл «коммит → push → Ansible → применение», а также возможность сосредоточиться на декларативном описании того, что должно работать, а не на как запускать каждый отдельный процесс.

Автоматизация и GitOps

Автоматизация и GitOps

CI/CD pipeline

Для автоматизации сборки и деплоя ботов Orca удобно использовать GitLab CI — пipeline собирает Docker‑образ, проверяет секреты и пушит его в регистратор. Далее ArgoCD синхронизирует образ с кластером Kubernetes (k3s на домашнем сервере).

yaml
# .gitlab-ci.yml
stages:
  - build
  - test
  - deploy

build:
  stage: build
  image: docker:24.0.5
  services:
    - docker:24.0.5-dind
  script:
    - docker build --pull -t registry.example.com/orca/bot:$(gitlab SHA) .
    - docker push registry.example.com/orca/bot:$(gitlab SHA)
  only:
    - main

test:
  stage: test
  image: python:3.12
  script:
    - pip install -r requirements.txt
    - pytest tests/
  only:
    - main

deploy:
  stage: deploy
  image: bitnami/kubectl:1.30
  script:
    - kubectl apply -f k8s/deployment.yaml
  environment:
    name: production
  only:
    - main

Почему так?
— Docker BuildKit позволяет собрать мульти‑архивный образ (--platform linux/amd64,linux/arm64) без отдельного Docker‑file для каждой архитектуры.
— git‑secrets проверяется в пред‑пуше about‑hook, чтобы случайно не выложить API‑ключи.

Связано с Ponytail: оптимизация работы AI‑агентов — после сборки образа рекомендуется включить кэш зависимостей, чтобы сократить время сборки в CI.

Ansible и Git‑Ops

Ansible удобно использовать для provisioning домашнего сервера и установки Orca‑агента.playbook описан ниже, а ArgoCD управляет состоянием кластера, поэтому любые изменения в манифестах попадают в Git‑Ops цикл.

yaml
# ansible.cfg
[defaults]
inventory = inventories/home.yml
host_key_checking = False
retry_files_enabled = False
yaml
# inventories/home.yml
[home_servers]
orca-server ansible_host=192.168.1.101
yaml
# playbooks/orca.yml
- name: Deploy Orca bot on home server
  hosts: home_servers
  become: true
  tasks:
    - name: Install Docker
      apt:
        name:
          - docker.io
          - docker-compose
        state: present
        update_cache: yes

    - name: Pull Orca image
      docker_image:
        name: registry.example.com/orca/bot:latest
        source: pull

    - name: Run Orca container
      docker_container:
        name: orca-bot
        image: registry.example.com/orca/bot:latest
        state: started
        restart_policy: always
        ports:
          - "8080:8080"

Ключевые моменты

  • Idempotent‑playbook: если контейнер уже запущен, Ansible просто проверит его статус и не будет делать лишних действий.
  • Git‑Ops‑подход: манифесты (k8s/deployment.yaml) хранятся в том же репозитории, что и CI‑pipeline. При пуше в main ArgoCD автоматически синхронизирует их с кластером, а Ansible лишь обеспечивает подготовку узла (Docker, сетевые правила).

Смотрите подробнее в Управление флотом ИИ‑агентов с помощью Orca и Обзор OpenComputer: open source агент для разработки — оба материала показывают, как комбинировать GitOps с конкретными агентами.


Итого:
CI/CD‑pipeline на GitLab + Docker BuildKit → регистратор → ArgoCD → Kubernetes (домашний сервер).
Ansible → готовность узла → деплой контейнера.
Все изменения проходят через Git, поэтому desired state всегда в репозитории, а не вручную на сервере.

Если хотите увидеть пример полного workflow с ArgoCD, см. OpenComputer: open source alternative to Devin for teams.

Заключение

Итоги

Orca — это единственная точка входа для управления множеством AI‑ботов (Claude Code, Grok, Agy, Codex) через вашу подписку.
Она работает одинаково на настольных, мобильных и удалённых серверах, что позволяет построить флот из независимых агентов без необходимости поддерживать отдельные среды для каждого из них.

  • Декларативный подход – всё, от списка агентов до их параметров, описывается в YAML‑манифесте. Orca сравнивает состояние желаемого и текущего, применяя idempotентные операции, поэтому повторный запуск не ломает ничего.
  • Единая подписка – вместо того, чтобы платить за каждый сервис отдельно, вы получаете доступ ко всем поддерживаемым моделям через один план. Это экономит бюджет и упрощает аудит usage‑лимитов.
  • GitOps‑совместимость – конфиги Orca хранятся в Git, а CI/CD‑пейплайн (GitLab CI, GitHub Actions) автоматически применяет изменения к вашему флоту. Это гарантирует, что «что описано в Git, то и существует».

Пример базового манифеста (orca.yaml):

yaml
# orca.yaml – декларативное описание флота
version: "1.0"
agents:
  - name: claude-code
    type: claude
    token: ${ORCA_CLAUDE_TOKEN}
    capabilities:
      - code-review
      - refactor
  - name: grok-assistant
    type: grok
    token: ${ORCA_GROK_TOKEN}
    capabilities:
      - chat
      - summarization
  - name: agy-bot
    type: agy
    token: ${ORCA_AGY_TOKEN}
    capabilities:
      - data-analysis
      - report-generation

Команда для быстрого старта (Docker‑образ):

bash
docker run -d \
  --name orca \
  -p 8080:8080 \
  -e ORCA_SUBSCRIPTION_KEY=YOUR_KEY \
  -v $(pwd)/orca.yaml:/etc/orca/config.yaml \
  orcacore/orca:latest

После запуска Orca автоматически discovers доступные агенты, регистрирует их в своей базе и начинает принимать imperative‑commands (orca exec <agent> <task>) или declarative‑jobs через API.

Сравнение с другими решениями показывает, что Orca сокращает операционный риск: вы не тратите время на ручную настройку каждого бота, а описав его один раз в Git, получаете полностью автоматизированный цикл «планировать‑запустить‑поддерживать».

Управление флотом ИИ‑агентов с помощью Orca – подробный разбор архитектуры и примеров использования.


Рекомендации

  1. Выбирайте подходящий план подписки
    Если ваш флот менее 10 ботов – базовый план будет достаточно.
    Для больших команд (30 + агентов) рекомендуется премиум‑тариф с повышенными лимитами и SLA.

  2. Храните секреты в SOPS + Age

    bash
    # Encrypt токенClaude
    echo "sk-abc123..." | sops --encrypt --output orca_secrets.yml -
    

    Затем подключайте их через переменные окружения (${ORCA_CLAUDE_TOKEN}) – так secrets никогда не попадают в чистый Git.

  3. Автоматизируйте обновления
    Подключите Renovate или Dependabot к репозиторию с конфигурациями Orca. Пример .renovate.json:

    json
    {
      "extends": ["github-actions"],
      "packageRules": [
        {
          "packageTypes": ["docker-image"],
          "description": "Orca Docker image",
          "schedule": "weekly"
        }
      ]
    }
    

    Это гарантирует, что вы всегда используете актуальную, проверенную версию orcacore/orca.

  4. Интегрируйте с CI/CD
    Пример GitLab CI‑pipeline, который применяет изменения к домашнему серверу:

    yaml
    stages:
      - plan
      - apply
    
    plan:
      stage: plan
      script:
        - orca plan -c orca.yaml
    
    apply:
      stage: apply
      script:
        - orca apply -c orca.yaml
      environment: production
      when: manual   # требуем подтверждения перед применением
    
  5. Мониторинг и алертинг
    Настройте Prometheus‑метрики (/metrics endpoint) и подключите их к Grafana. Пример правила алерта:

    yaml
    - alert: HighTokenUsage
      expr: orca_token_usage > 0.85
      for: 10m
      labels:
        severity: critical
      annotations:
        summary: "Usage of Orca tokens exceeds 85%"
        description: "The current subscription limit is close to exhaustion."
    
  6. Не забывайте о качестве кода
    Запускайте git secrets перед каждым пушем, чтобы убедиться, что в репозитории нет случайно закоммиченных токенов.

Оптимизация AI‑агентов с помощью системы ECC – полезно, если хотите добавить слой кэширования и балансировку нагрузки для вашего флота.

Соблюдая эти рекомендации, вы сможете полностью использовать потенциал Orca, построить надёжный и экономичный флот AI‑ботов, а также избавиться от рутинных операций, которые отвлекают от основной разработки.

Часто задаваемые вопросы

Можно ли запустить Orca без собственной подписки на Claude Code, Grok, Agy или Codex?

Нет, Orca требует указания одной или нескольких подписок в переменной AI_SUBSCRIPTION при запуске контейнера. Без указания хотя бы одного из поддерживаемых провайдеров сервис не стартует и в веб‑интерфейсе не будет доступен список ботов. Подписка должна быть активна и привязана к вашему аккаунту в соответствующем сервисе.

Как добавить нового AI‑бота в существующий флот Orca?

Для добавления бота создайте или отредактируйте YAML‑файл в каталоге config репозитория, где описывается декларативный конфиг бота (имя, тип, параметры доступа, планировщик задач и ограничения ресурсов). После git commit и push CI/CD‑pipeline автоматически запустит Ansible‑playbook, который применит новый конфиг к нужным узлам. В веб‑интерфейсе бот появится в списке после завершения применения.

Как обеспечить безопасность API‑ключей и токенов, используемых Orca?

Секреты следует хранить в зашифрованных файлах (например, SOPS + Age) внутри каталога config и добавить их в репозиторий только после шифрования. Перед каждым push запускайте git-secrets‑проверку, чтобы убедиться, что открытые ключи не попали в историю. Ansible‑playbook применяет расшифрованные данные только на целевых узлах, а не передаёт их в виде обычных переменных.

Как масштабировать fleet ботов Orca на удалённых серверах?

Масштабирование реализуется через изменение количества реплик в YAML‑манифесте, описывающем каждый сервер‑устройство (например, replicas: 3). После изменения конфигурации и git push CI/CD‑pipeline автоматически запустит Ansible‑playbook, который создаст или удалит необходимые контейнеры на удалённых узлах. Веб‑интерфейс покажет актуальное количество запущенных ботов per‑node.

Поделиться:TelegramX / TwitterVK

Читайте также