1С: Администрирование

Эта панель работает и без открытого проекта 1С.

Панель 1С: Администрирование в activity bar доступна всегда: проект 1С не нужен. Внутри два представления — Информационные базы и Кластеры.

Список баз запускает клиент 1С из записи платформы (ibases.v8i). Кластеры — консоль серверов через rac.

Информационные базы

Представление показывает тот же список, что 1С при запуске: личный ibases.v8i и общие списки из 1cestart.cfg.

Как открыть базу

В строке базы две кнопки: Предприятие и Конфигуратор. Клик по имени ничего не запускает. Та же команда есть в палитре: 1С: Администрирование → Открыть список — Enter открывает Предприятие, кнопки в строке выбора — Предприятие или Конфигуратор.

Обе кнопки открывают базу штатным запуском платформы. Если в записи нет авторизации, 1С покажет своё окно входа.

В заголовке списка две кнопки. Открыть окно запуска платформы показывает штатное окно 1cestart со списком баз: его кнопка 1C:EDT заводит в стартере EDT проект под базу. Открыть 1C:EDT Start показывает окно стартера: его проекты это рабочие области EDT, проект под базу называется как база, при первом открытии стартер просит выбрать версию EDT, а EDT запускает кнопка у проекта.

Откуда берётся список

Источник	Где лежит
Личный список	Windows: %APPDATA%\1C\1CEStart\ibases.v8i; Linux и macOS: ~/.1C/1cestart/ibases.v8i
Общие списки	Пути из 1cestart.cfg (CommonInfoBases)

Папки в списке те же, что видно в самой 1С. Новые записи появляются сами, кнопка Обновить перечитывает список принудительно.

Кластеры

Консоль администрирования кластера серверов 1С:Предприятие внутри VS Code. Работает через штатную утилиту платформы rac.

Из представления видно дерево: подключения → кластеры → информационные базы, рабочие серверы, менеджеры, процессы, сеансы, соединения и блокировки. Оттуда же выполняются административные действия, открывается таблица активности с метриками и карточка свойств базы.

Что нужно для работы

1. Установленная платформа 1С на машине с VS Code — утилиты 1cestart и rac входят в её поставку. rac работает по сети, поэтому для управления удалённым кластером локальной платформы достаточно.
2. Запущенный сервер администрирования ras на стороне кластера. Без него rac подключаться некуда: представление покажет ошибку соединения.
3. Совпадение версий: версия rac должна совпадать с версией сервера администрирования. Если на машине несколько версий платформы, нужную выбирают полем «Версия платформы» в параметрах подключения — у каждого сервера она своя.

Проверить, что утилита найдена и сервер отвечает, можно кнопкой Проверить подключение в форме подключения.

Где ищутся rac и 1cestart

Путь определяется автоматически по тем же правилам, что и остальные бинарники платформы:

ОС	Каталоги установки
Windows	%PROGRAMFILES%\1cv8
Linux, macOS	/opt/1cv8/<архитектура>, /opt/1C/v8.3/<архитектура>

Первым проверяется каталог архитектуры текущей машины (arm64, x86_64, i386), затем x86_64. Внутри каталога версии бинарник ищется и в подкаталоге bin/, и напрямую — раскладки Windows, .deb-пакетов и .run-установщика различаются. Стартер 1cestart живёт в common рядом с каталогами версий.

Если платформа установлена нестандартно, укажите каталог установки настройкой 1c-platform-tools.clusters.path.platform — дальше расширение ищет утилиты само, как и для ibsrv.

Подключения

Подключение описывает один сервер администрирования: адрес, порт и версию rac. Доступ задаётся наборами учётных данных — группами администраторов той же формы.

Заводят и правят подключения в форме — отдельной вкладкой Подключения к кластерам 1С: слева список, справа поля. Открывается кнопкой + в заголовке представления, командой 1С: Кластеры → Создать подключение или пунктом Свойства в контекстном меню подключения.

• Сервер администрирования (ras) и порт: порт по умолчанию — 1545.
• Версия платформы — какой rac вызывать. Поле предлагает версии, установленные на этой машине, но значение можно и вписать. Пусто — берётся наибольшая установленная.
• Администратор кластера и администратор центрального сервера — какой набор учётных данных использовать с этим подключением: конкретный набор или «не использовать».
• Проверить подключение — кнопка в форме: видно, найдена ли утилита и отвечает ли сервер. Если есть набор администратора кластера, проверка дополнительно запрашивает базы первого кластера. Проверяются набранные значения, сохранять перед этим не нужно; итог остаётся точкой слева в списке: зелёная — всё сошлось, красная — нет.

Удаляют подключение крестиком в списке формы или пунктом Удалить в контекстном меню узла — без подтверждения: из списка исчезает запись, сам кластер и его базы не меняются. Правки применяются по кнопке Сохранить, до неё список не меняется.

Подключения переезжают между машинами штатной синхронизацией параметров VS Code: включите Settings Sync, и на другой машине список появится сам. Файла в проекте для этого не нужно.

Учётные данные

Доступ к кластеру и информационным базам задаётся наборами, там же в форме Подключения к кластерам 1С, под списком подключений. Команда 1C: Кластеры → Учётные данные открывает форму сразу на наборах.

Наборов у каждой роли может быть сколько угодно. Они разведены на три группы, у каждой своя кнопка + и свой цвет точки в списке:

• Администраторы кластера (оранжевая точка) — привязываются к кластерам кнопкой Привязать кластер.
• Администраторы центрального сервера (фиолетовая) — привязываются к серверам кнопкой Привязать сервер.
• Администраторы ИБ (синяя) — привязываются к базам кнопкой Привязать базу или из контекстного меню базы в дереве, пункт Назначить учётные данные.

Набор — это учётная запись: название, пользователь, пароль. Работает он там, куда привязан. Привязка к кластеру точнее выбора в карточке подключения и перекрывает его. Кнопки привязки сами читают списки кластеров и баз по всем подключениям; снять привязку — крестиком в списке привязок набора.

При обращении к базе или кластеру привязанный набор подставляется сам. Если привязки нет или набор не приняли — короткое уведомление в углу с кнопкой Открыть. Дерево и карточка при этом не блокируются диалогом.

Наборы нужны не всегда. Кластер без заведённых администраторов читается и правится без набора, база без пользователей — тоже. Если администраторы есть, набор кластера открывает список баз, сеансы, блокировки и процессы, набор базы — её полные сведения, соединения, разрыв соединения, правку и удаление, а набор центрального сервера — правку самого кластера и его администраторов.

Пароль после сохранения в форме не показывается. Пустое поле означает «оставить сохранённый».

Кнопка Проверить обращается к серверу под этим набором и показывает, принят ли он.

Пароли в списке не хранятся. Они живут в защищённом хранилище VS Code (SecretStorage) и между машинами не синхронизируются. Имена наборов и привязки переезжают вместе с подключениями.

Дерево кластера

Ветки загружаются по требованию: раскрытие узла — это обращение к серверу администрирования.

• Информационные базы — список баз кластера; внутри каждой свои Сеансы, Соединения и Блокировки, отобранные по этой базе.
• Рабочие серверы — центральный сервер идёт первым; внутри сервера — его Рабочие процессы.
• Менеджеры кластера — главный менеджер идёт первым, у каждого видны адрес и процесс операционной системы.
• Администраторы — учётные записи кластера: имя, описание и способ входа. Рядом с подключением есть такая же группа Администраторы центрального сервера — это отдельный список самого сервера.
• Рабочие процессы — адрес и порт в подписи, состояние и число соединений в описании; работающий процесс отмечен зелёным, остановленный — красным. Внутри процесса — его Соединения.
• Сеансы — номер и пользователь в подписи, приложение и компьютер в описании. Сеанс, ждущий блокировки СУБД или управляемой блокировки, подсвечен; спящий сеанс отмечен в описании.
• Соединения — номер, приложение, компьютер и время установки.
• Блокировки — что и когда заблокировано.

Если ветку прочитать не удалось, вместо списка появляется узел с причиной — дерево при этом остаётся открытым.

Кнопка Обновить в заголовке перечитывает всё, Обновить на узле — только его ветку.

Автообновление

Состояние кластера меняется само, поэтому дерево умеет обновляться периодически: кнопка в заголовке представления или настройки clusters.autoRefresh.enabled и clusters.autoRefresh.intervalSeconds. По умолчанию автообновление выключено, а включённое работает только когда представление видно — скрытое к серверу не обращается.

Состояние видно по самой кнопке: выключено — перечёркнутый значок и подпись Включить автообновление, включено — обычный значок обновления и подпись Выключить…. Рядом с названием представления в этом случае появляется пометка «автообновление», чтобы периодические обращения к серверу не выглядели необъяснимыми.

Таблица активности

Команда Списки таблицей (на узле кластера или базы, значок в строке узла) открывает вкладку, где базы, сеансы, соединения и блокировки видны списком со столбцами.

• Информационные базы: состояние блокировок с интервалом и сообщением, СУБД и сервер. Без привязанного набора администратора эти столбцы пустые.
• Сеансы: кто, откуда и в какой базе работает, плюс метрики нагрузки — память, вызовы, процессорное время, обращения к СУБД.
• Соединения: кто и когда подключился и сколько ждёт блокировку; подробные метрики соединения лежат в его карточке.
• Блокировки: что заблокировано, объект и время установки.

Что с таблицей можно делать:

• сортировать щелчком по заголовку — например, найти сеанс с наибольшим потреблением памяти или самым долгим вызовом;
• искать по строке поиска: отбор идёт по видимому тексту, поэтому ищутся и пользователь, и компьютер, и имя базы;
• действовать по строке: завершить сеанс, прервать его текущий серверный вызов, разорвать соединение, открыть свойства базы или удалить её — с теми же подтверждениями, что и в дереве;
• выделять строки как в любом списке VS Code: щелчок выбирает одну, Ctrl добавляет и снимает, Shift берёт диапазон от предыдущего щелчка, Ctrl+A — все найденные строки, Esc снимает выделение. Кнопки в строке при щелчке выполняют своё действие и выделение не меняют;
• действовать пачкой: у сеансов и соединений кнопка Завершить выбранные или Разорвать выбранные показывает, сколько строк выбрано, и спрашивает подтверждение один раз на всю пачку. Строки, скрытые поиском, в действие не попадают. Выделение сбрасывается при обновлении списка: часть выбранного на сервере может уже не существовать;
• выгружать: кнопка Копировать или Ctrl+C кладёт в буфер обмена выбранные строки, а без выделения — всё, что видно на экране, с учётом поиска и сортировки. Разделитель «;», поэтому вставленное открывается Excel с русскими настройками.

Действия

Сеансы и соединения

• Завершить — из контекстного меню сеанса или значком на узле. В подтверждении можно выбрать «С сообщением…» — текст увидит пользователь в закрываемом сеансе.
• Прервать текущий вызов — мягче завершения: сеанс продолжит работу, оборвётся только затянувшийся серверный вызов (зависший отчёт или обработка).
• Выключить (на рабочем процессе) — процесс перестаёт принимать новые соединения и завершается, когда отпустит текущие; кластер поднимает замену.
• Завершить все сеансы — на узле базы; в подтверждении показано, сколько сеансов будет завершено. Чтобы пользователи не вернулись сразу же, сначала запретите начало сеансов.
• Разорвать — из контекстного меню соединения.

Необратимые действия по умолчанию подтверждаются; отключить подтверждение можно настройкой clusters.confirmDestructiveActions (завершение всех сеансов базы подтверждается всегда).

Блокировки информационной базы

• Запретить / разрешить начало сеансов (на узле базы) — при запрете спрашиваются сообщение для пользователей и код разрешения, позволяющий войти вопреки блокировке. Начало блокировки ставится текущим временем. Снятие блокировки сообщение и код не затирает.
• Запретить / разрешить регламентные задания.

Если платформа требует администратора информационной базы, берётся привязанный к базе набор. Нет привязки — уведомление в углу с кнопкой открыть форму.

Администраторы

Списки видны в дереве и правятся оттуда же:

• Администраторы под кластером: пока их нет, кластер открыт всем, кто дотянулся до ras.
• Администраторы центрального сервера под подключением: они нужны, чтобы править сами кластеры.

Кнопка + на группе открывает карточку администратора, Свойства — ту же карточку для существующей записи, Удалить убирает её. В карточке задаются имя, описание и способы входа: паролем, средствами операционной системы (с указанием учётной записи ОС) или обоими сразу.

Запись с существующим именем платформа перезаписывает, поэтому при правке имя не меняется, а пароль задаётся заново: прочитать сохранённый платформа не даёт.

Удаление последнего администратора снимает защиту целиком, поэтому подтверждение об этом прямо предупреждает.

Свойства объектов

У каждого объекта дерева одна кнопка Свойства: она и показывает, и правит.

Объект	Что в карточке
Подключение	форма подключения к серверу администрирования
Кластер	параметры кластера, правятся администратором центрального сервера
Информационная база	блокировки, режим работы, профили безопасности
Рабочий сервер	диапазон портов, пределы памяти, ограничения на процесс, расписание перезапуска
Рабочий процесс, менеджер, сеанс, соединение	сведения и нагрузка, только для чтения: платформа менять их не даёт
Администратор	имя, описание и способы входа

Карточки читаемые: объём показан в мегабайтах, длительность в секундах, метки времени в привычном порядке, идентификаторы приложений заменены названиями.

У каждого объекта своя вкладка: свойства двух соединений или сеансов можно открыть рядом и сравнить. Повторное открытие того же объекта переиспользует его вкладку, а не плодит копии.

Свойства кластера

Свойства кластера (контекстное меню кластера) открывают карточку параметров: имя, перезапуск рабочих процессов (период, порог памяти, время превышения, порог ошибок, завершение зависших процессов, снятие дампа), сеансы и отказоустойчивость (принудительное завершение, уровень отказоустойчивости, балансировка нагрузки, уровень безопасности), проверка связи и расписание перезапуска.

Читается карточка без аутентификации. Сохранение уходит с набором администратора центрального сервера, если он выбран в карточке подключения; сервер с заведёнными администраторами без набора откажет, и в углу появится уведомление с кнопкой открыть учётные данные.

Часть параметров платформа принимает молча, но не применяет: вызов завершается успешно, а значение остаётся прежним (так ведёт себя, например, период перезапуска на кластере без соответствующих условий). После сохранения карточка показывает «Сохранено; платформа не приняла: …» с перечнем таких параметров.

Свойства информационной базы

Свойства информационной базы (контекстное меню базы) открывают карточку — то же, что показывает консоль кластера, но редактируемое:

• Размещение — имя, СУБД, сервер и база данных. Только для чтения: размещение меняют вместе с самой базой, а не из консоли кластера.
• Блокировка сеансов — запрет начала сеансов, сообщение пользователю, код разрешения и интервал действия (с и по). Даты выбираются в поле даты и времени; пустое значение означает «без ограничения».
• Режим работы — запрет регламентных заданий, выдача лицензий сервером, описание базы.
• Профили безопасности — профиль базы и профиль безопасного режима для внешнего кода.

Сохраняются только изменённые поля, поэтому правка из другой консоли в это же время не затирается. Пустое поле осмысленно: так значение стирается.

Журнал

Вызовы rac и запуск баз пишутся в общий журнал расширения — канал вывода 1C: Platform Tools. Записи кластера помечены скоупом [clusters], запуска баз — [ibases]. В строке rac видно команду, время выполнения и число полученных объектов, а при неудаче — сообщение утилиты. Открыть журнал можно кнопкой Показать журнал в сообщении об ошибке или выбрав канал в панели Output.

Уровень переключается командой Developer: Set Log Level…: на уровне Debug в журнал добавляется строка о старте каждого вызова rac — она нужна, если вызов повис и итога не будет.

Пароли в журнал не попадают — значения опций --*-pwd заменяются звёздочками. Имя пользователя остаётся: без него не понять, чей доступ отклонён. Учтите, что сама утилита rac получает пароль аргументом командной строки, а значит он виден в списке процессов операционной системы — ввода пароля через поток у неё нет.

Настройки

Настройка	По умолчанию	Назначение
clusters.path.platform	""	Каталог установки платформы 1С для поиска rac и 1cestart
clusters.timeoutSeconds	30	Сколько ждать ответа rac
clusters.autoRefresh.enabled	false	Периодически обновлять дерево кластеров
clusters.autoRefresh.intervalSeconds	30	Интервал автообновления
clusters.confirmDestructiveActions	true	Подтверждать завершение сеанса и разрыв соединения

Все ключи начинаются с 1c-platform-tools.. Открыть раздел целиком — кнопка с шестерёнкой в заголовке представления «Кластеры» или команда 1С: Кластеры → Настройки.

Если что-то не работает

Симптом	Причина и что делать
«Не найден 1cestart»	Платформа установлена нестандартно — укажите clusters.path.platform.
«Каталог базы не найден»	В ibases.v8i указан путь, которого нет на диске.
«Утилита rac не найдена»	Платформа установлена нестандартно — укажите clusters.path.platform. В сообщении перечислены проверенные каталоги.
«Проверьте, что сервер администрирования (ras) запущен»	Не поднят ras либо неверны адрес и порт. Порт по умолчанию — 1545, у ras он задаётся при запуске.
«Нет учётных данных…» или «Администратор … не принят»	В сообщении названа роль: кластера, центрального сервера или информационной базы. Откройте форму учётных данных, заведите набор этой группы и привяжите его к кластеру, серверу или базе.
Несовпадение версий	Версия rac отличается от версии сервера — выберите нужную версию платформы в настройках или в подключении.
Вызовы обрываются по таймауту	Сервер недоступен или отвечает медленно: проверьте сеть и увеличьте clusters.timeoutSeconds.

Подробности любой неудачи — в журнале: сообщение об ошибке предлагает открыть его кнопкой.