framework/skills/tool-usage/platform-admin/rac-use/SKILL.md
Администрирование кластера серверов 1С через утилиту RAC — просмотр/завершение сеансов, управление блокировками, соединениями, информационными базами и другими объектами кластера.
npx skillsauth add steelmorgan/1c-agent-based-dev-framework rac-useInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
| Триггер | Действие |
|---------|----------|
| Нужно проверить/убить сеансы в базе | session list / session terminate |
| Нужно отключить соединения | connection list / connection disconnect |
| Нужно заблокировать вход в базу | infobase update --sessions-deny=on |
| Нужно запретить регл. задания | infobase update --scheduled-jobs-deny=on |
| Нужно посмотреть блокировки | lock list |
| Нужна информация о кластере/базах | cluster list / infobase summary list |
Бинарник: /opt/1cv8/current/rac (всегда актуальная версия).
Данные подключения: <project_root>/configs/yaxunit-runner.yml, секция app.connection — сервер, база, логин, пароль.
Адрес агента кластера: по умолчанию localhost:1545. Если сервер отличается — указать явно как последний аргумент: rac <command> <host>:<port>.
Все команды требуют --cluster=<uuid>. Получи его первым:
/opt/1cv8/current/rac cluster list
Вывод содержит cluster : <uuid> — запомни и используй далее.
# Найти UUID базы
/opt/1cv8/current/rac infobase --cluster=<cluster_uuid> summary list
# Список сеансов базы
/opt/1cv8/current/rac session --cluster=<cluster_uuid> list --infobase=<infobase_uuid>
/opt/1cv8/current/rac session --cluster=<cluster_uuid> terminate \
--session=<session_uuid> \
--error-message="Сеанс завершён агентом для выполнения задачи"
# Включить блокировку
/opt/1cv8/current/rac infobase --cluster=<cluster_uuid> update \
--infobase=<infobase_uuid> \
--infobase-user=<user> --infobase-pwd=<pwd> \
--sessions-deny=on \
--denied-message="База заблокирована для обслуживания" \
--permission-code="secret123"
# Снять блокировку
/opt/1cv8/current/rac infobase --cluster=<cluster_uuid> update \
--infobase=<infobase_uuid> \
--infobase-user=<user> --infobase-pwd=<pwd> \
--sessions-deny=off
# Запретить
/opt/1cv8/current/rac infobase --cluster=<cluster_uuid> update \
--infobase=<infobase_uuid> \
--infobase-user=<user> --infobase-pwd=<pwd> \
--scheduled-jobs-deny=on
# Разрешить
/opt/1cv8/current/rac infobase --cluster=<cluster_uuid> update \
--infobase=<infobase_uuid> \
--infobase-user=<user> --infobase-pwd=<pwd> \
--scheduled-jobs-deny=off
/opt/1cv8/current/rac lock --cluster=<cluster_uuid> list --infobase=<infobase_uuid>
# Список соединений базы
/opt/1cv8/current/rac connection --cluster=<cluster_uuid> list --infobase=<infobase_uuid>
# Разрыв конкретного соединения
/opt/1cv8/current/rac connection --cluster=<cluster_uuid> disconnect \
--process=<process_uuid> --connection=<connection_uuid>
| Режим | Назначение |
|-------|-----------|
| cluster | Кластеры: список, создание, удаление, администраторы |
| infobase | Информационные базы: создание, обновление, удаление, блокировка сеансов/рег.заданий |
| session | Сеансы: список, информация, принудительное завершение |
| connection | Соединения: список, разрыв |
| lock | Блокировки: просмотр |
| process | Рабочие процессы |
| server | Рабочие серверы |
| manager | Менеджеры кластера |
| agent | Агент кластера |
| service | Сервисы менеджера |
| rule | Требования назначения |
| profile | Профили безопасности |
| counter | Счётчики потребления ресурсов |
| limit | Ограничения потребления ресурсов |
Справка по любому режиму: rac help <mode>.
| Ошибка | Причина | Решение |
|--------|---------|---------|
| Агент кластера недоступен | Не запущен ragent или неверный адрес | Проверить localhost:1545 или указать правильный адрес |
| Неверный идентификатор кластера | UUID скопирован с ошибкой | Повторить cluster list |
| Недостаточно прав | Нужны credentials администратора кластера | Добавить --cluster-user / --cluster-pwd |
| Информационная база не найдена | Неверный UUID базы | Проверить через infobase summary list |
depends_on:
tools
Diagnostics for Vanessa Automation runs. Use when a feature scenario failed, artifacts were not created, or you need to classify a failure after launch.
tools
Creating and refining Vanessa Automation feature scenarios based on real project requirements. Use when you need to write or update a scenario test, not just run it.
tools
--- name: v8-session-manager description: Use when working with the 1С session manager (v8-session-manager) - launch, configuration, connecting 1С clients, reading session_list, calling proxied MCP-tools from 1С extensions, diagnostics. Triggers: mention of `v8-session-manager`, `session_list`, 1С extension MCP showcase, error “no active sessions” / “session_id required”, connecting a client to the manager via `mcpMode=ws`. provides_capabilities: # Built-in manager tools — always available whi
tools
Use when Codex needs to manage v8-runner on local 1C projects through the CLI: configure v8project.yaml, initialize infobases or EDT workspaces, build sources from Designer or EDT, run syntax checks and tests, dump infobase changes, convert source formats, load or export artifacts, launch 1C clients, or choose safe 1C automation command sequences.