137 lines
4.4 KiB
Markdown
137 lines
4.4 KiB
Markdown
# ollama-plagin-swap
|
|
|
|
Удалённый контроль swap для серверов Ollama, используемых через API OpenCode.
|
|
|
|
## Что устанавливается
|
|
|
|
- `src/ollama_swap_agent.py` и `src/ollama_swap_common.py`: Python-агент для macOS и Ubuntu.
|
|
- `examples/opencode/ollama-swap.js`: канонический клиентский плагин OpenCode без зависимостей.
|
|
- `examples/opencode/ollama-swap.ts`: необязательный TypeScript-плагин с пользовательскими инструментами и runtime-guard.
|
|
- Агент предоставляет `GET /health`, `GET /status` и `POST /restart`.
|
|
|
|
## Почему раньше дублировались плагины
|
|
|
|
OpenCode автоматически загружает все файлы плагинов из `.opencode/plugins/` проекта и из
|
|
`~/.config/opencode/plugins/`. Если один и тот же файл лежит в обоих местах, он загружается
|
|
дважды. Поэтому исходники перенесены в `examples/opencode/`, а устанавливается только один
|
|
глобальный файл.
|
|
|
|
## Установка клиента на текущий macOS
|
|
|
|
```sh
|
|
./scripts/install-client.sh
|
|
```
|
|
|
|
Устанавливаются файлы:
|
|
|
|
```text
|
|
~/.config/opencode/plugins/ollama-swap.js
|
|
~/.config/ollama-plagin-swap/clients.json
|
|
```
|
|
|
|
Отредактируйте `clients.json` и укажите URL и токен удалённого агента Ollama.
|
|
|
|
## Установка агента на сервере Ollama
|
|
|
|
Подключитесь по SSH к серверу `10.8.0.62` под пользователем с правами администратора/root. Пример:
|
|
|
|
```sh
|
|
ssh admin@10.8.0.62
|
|
```
|
|
|
|
### Сервер Ollama на macOS
|
|
|
|
Выполните на сервере Ollama:
|
|
|
|
```sh
|
|
mkdir -p ~/src/ollama-plagin-swap
|
|
# Сначала скопируйте файлы репозитория на сервер, затем:
|
|
cd ~/src/ollama-plagin-swap
|
|
./scripts/install-agent.sh
|
|
```
|
|
|
|
Установщик создаёт файлы:
|
|
|
|
```text
|
|
~/.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`, затем перезапустите агент:
|
|
|
|
```sh
|
|
launchctl unload ~/Library/LaunchAgents/com.ollama.swap-agent.plist 2>/dev/null || true
|
|
launchctl load -w ~/Library/LaunchAgents/com.ollama.swap-agent.plist
|
|
```
|
|
|
|
Сам сервис Ollama агент перезапускает командами:
|
|
|
|
```sh
|
|
launchctl unload ~/Library/LaunchAgents/com.ollama.serve.plist 2>/dev/null
|
|
launchctl load -w ~/Library/LaunchAgents/com.ollama.serve.plist
|
|
```
|
|
|
|
### Сервер Ollama на Ubuntu
|
|
|
|
Выполните на сервере Ollama под root:
|
|
|
|
```sh
|
|
cd /opt/ollama-plagin-swap
|
|
sudo ./scripts/install-agent.sh
|
|
```
|
|
|
|
Установщик создаёт файлы:
|
|
|
|
```text
|
|
/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`, затем выполните:
|
|
|
|
```sh
|
|
sudo systemctl daemon-reload
|
|
sudo systemctl enable --now ollama-swap-agent
|
|
```
|
|
|
|
При необходимости откройте доступ с клиентского IP:
|
|
|
|
```sh
|
|
sudo ufw allow from <ip-клиента-opencode> to any port 8731 proto tcp
|
|
```
|
|
|
|
Сам сервис Ollama агент перезапускает командой:
|
|
|
|
```sh
|
|
sudo systemctl restart ollama
|
|
```
|
|
|
|
## Проверка агента на сервере
|
|
|
|
```sh
|
|
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
|
|
```
|
|
|
|
Ручной запрос на перезапуск:
|
|
|
|
```sh
|
|
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
|
|
```
|
|
|
|
## Локальные проверки перед установкой
|
|
|
|
```sh
|
|
/usr/bin/python3 -m py_compile src/*.py tests/*.py
|
|
/opt/homebrew/bin/pytest -q
|
|
node --check .opencode/plugins/ollama-swap.js
|
|
```
|