87 lines
2.7 KiB
Markdown
87 lines
2.7 KiB
Markdown
# Развёртывание Gemini Skill Для ServerManager
|
||
|
||
Этот документ описывает, как ServerManager интегрируется с Gemini CLI.
|
||
|
||
## Что устанавливается
|
||
|
||
Для каждого target home устанавливаются:
|
||
|
||
1. Общий backend:
|
||
- `~/.server-connections/ssh.py`
|
||
- `~/.server-connections/encryption.py`
|
||
2. Gemini skill package:
|
||
- `~/.gemini/skills/server-manager/`
|
||
3. Безопасный runtime wrapper:
|
||
- `~/.server-connections/gemini-ssh`
|
||
4. Глобальный Gemini context:
|
||
- `~/.gemini/GEMINI.md`
|
||
|
||
## Skill workflow
|
||
|
||
Gemini должен начинать discovery так:
|
||
|
||
```bash
|
||
$HOME/.server-connections/gemini-ssh --list
|
||
```
|
||
|
||
Далее:
|
||
|
||
- определить `Type`
|
||
- выбрать команду строго по типу
|
||
- выполнить ровно одно действие
|
||
- не раскрывать IP, логины, пароли, порты
|
||
|
||
## Рекомендуемая установка
|
||
|
||
### Через GUI
|
||
|
||
Вкладка `Setup` теперь умеет ставить:
|
||
|
||
- Claude skill
|
||
- Codex skill
|
||
- Gemini skill
|
||
- shared backend и wrappers
|
||
|
||
### Через Python installer
|
||
|
||
```bash
|
||
python3 tools/install_ai_integrations.py
|
||
python3 tools/install_ai_integrations.py --target-home /root
|
||
python3 tools/install_ai_integrations.py --all-users
|
||
```
|
||
|
||
### Через shell installer (Linux/macOS)
|
||
|
||
```bash
|
||
bash tools/install.sh --source-dir /path/to/server-manager
|
||
bash tools/install.sh --source-dir /path/to/server-manager --target-home /root
|
||
bash tools/install.sh --source-dir /path/to/server-manager --all-users
|
||
```
|
||
|
||
## Проверка
|
||
|
||
### 1. Проверить skill discovery
|
||
|
||
```bash
|
||
gemini skills list
|
||
```
|
||
|
||
### 2. Проверить wrapper
|
||
|
||
```bash
|
||
$HOME/.server-connections/gemini-ssh --list
|
||
```
|
||
|
||
### 3. Проверить doctor script
|
||
|
||
```bash
|
||
$HOME/.gemini/skills/server-manager/scripts/server-manager-gemini-doctor.sh
|
||
```
|
||
|
||
## Важные замечания
|
||
|
||
- `servers.json` не размножается автоматически в `--all-users` режиме — это сделано намеренно, чтобы не копировать credentials между пользователями.
|
||
- Для root / service accounts используйте отдельную установку в нужный `target home`.
|
||
- Gemini skill source в репозитории лежит в `.gemini/skills/server-manager/`.
|
||
- При необходимости можно дополнительно ставить mirror в `~/.agents/skills/server-manager/`, но по умолчанию это отключено, чтобы Gemini не ругался на duplicate skill conflict.
|