Files
ollama-plagin-swap/README.md
T

3.8 KiB

ollama-plagin-swap

Удалённый контроль swap для серверов Ollama, используемых через API OpenCode.

Что устанавливается

  • src/ollama_swap_agent.py и src/ollama_swap_common.py: Python-агент для macOS и Ubuntu.
  • .opencode/plugins/ollama-swap.js: клиентский плагин OpenCode.
  • .opencode/plugins/ollama-swap.ts: необязательный TypeScript-плагин с пользовательскими инструментами OpenCode.
  • Агент предоставляет GET /health, GET /status и POST /restart.

Установка клиента на текущий macOS

./scripts/install-client.sh

Устанавливаются файлы:

~/.config/opencode/plugins/ollama-swap.js
~/.config/ollama-plagin-swap/clients.json

Отредактируйте clients.json и укажите URL и токен удалённого агента Ollama.

Установка агента на сервере Ollama

Подключитесь по SSH к серверу 10.8.0.62 под пользователем с правами администратора/root. Пример:

ssh admin@10.8.0.62

Сервер Ollama на macOS

Выполните на сервере Ollama:

mkdir -p ~/src/ollama-plagin-swap
# Сначала скопируйте файлы репозитория на сервер, затем:
cd ~/src/ollama-plagin-swap
./scripts/install-agent.sh

Установщик создаёт файлы:

~/.local/share/ollama-plagin-swap/ollama_swap_agent.py
~/.local/share/ollama-plagin-swap/ollama_swap_common.py
~/.config/ollama-plagin-swap/config.json
~/Library/LaunchAgents/com.ollama.swap-agent.plist

Измените токен в ~/.config/ollama-plagin-swap/config.json, затем перезапустите агент:

launchctl unload ~/Library/LaunchAgents/com.ollama.swap-agent.plist 2>/dev/null || true
launchctl load -w ~/Library/LaunchAgents/com.ollama.swap-agent.plist

Сам сервис Ollama агент перезапускает командами:

launchctl unload ~/Library/LaunchAgents/com.ollama.serve.plist 2>/dev/null
launchctl load -w ~/Library/LaunchAgents/com.ollama.serve.plist

Сервер Ollama на Ubuntu

Выполните на сервере Ollama под root:

cd /opt/ollama-plagin-swap
sudo ./scripts/install-agent.sh

Установщик создаёт файлы:

/opt/ollama-plagin-swap/ollama_swap_agent.py
/opt/ollama-plagin-swap/ollama_swap_common.py
/etc/ollama-plagin-swap/config.json
/etc/systemd/system/ollama-swap-agent.service

Измените /etc/ollama-plagin-swap/config.json, затем выполните:

sudo systemctl daemon-reload
sudo systemctl enable --now ollama-swap-agent

При необходимости откройте доступ с клиентского IP:

sudo ufw allow from <ip-клиента-opencode> to any port 8731 proto tcp

Сам сервис Ollama агент перезапускает командой:

sudo systemctl restart ollama

Проверка агента на сервере

curl -sS -H "Authorization: Bearer <token>" http://10.8.0.62:8731/health
curl -sS -H "Authorization: Bearer <token>" http://10.8.0.62:8731/status

Ручной запрос на перезапуск:

curl -sS -X POST \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"reason":"manual","force":false}' \
  http://10.8.0.62:8731/restart

Локальные проверки перед установкой

/usr/bin/python3 -m py_compile src/*.py tests/*.py
/opt/homebrew/bin/pytest -q
node --check .opencode/plugins/ollama-swap.js