Add ollama-plagin-swap remote swap control plugin
This commit is contained in:
@@ -0,0 +1,129 @@
|
||||
# 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
|
||||
|
||||
```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
|
||||
```
|
||||
Reference in New Issue
Block a user