Настоящие CreateClusterInfo/RegCluster/UnregCluster в собственном учебном жизненном цикле, без изменения чужих кластеров и без удаления реестра с диска.
Где и как запускать
Полный серверный общий модуль УчебныйCOM85 и полный модуль управляемой формы в отдельной файловой учебной ИБ. Свой Windows-агент/RAS, точная платформа8.5.1.1343; перечисленные записи являются только авторским учебным кодом, фактических запусков0.
Подготовка
Работайте только в новой отдельной Windows-VM без рабочих процессов/кластеров. Установленная платформа и заранее зарегистрированный V85.COMConnector должны быть8.5.1.1343 соответствующей разрядности. Регистрацию COM и запуск служб этот BSL не выполняет.
Создайте отдельную файловую ИБ с именем конфигурации УчебныйЖизненныйЦиклCOM85: без данных, каталогов, документов, регистров, подписок, фоновых заданий и расширений. В ней создайте общий модуль УчебныйCOM85: Сервер=Истина, ВызовСервера=Истина, Глобальный=Ложь, Клиент/ВнешнееСоединение=Ложь. Вставьте полностью код одного урока, не смешивайте одинаковые функции разных уроков.
Создайте обработку и управляемую форму с командой Выполнить и полным модулем формы из дополнительного блока. Строковые реквизиты: Операция, ИмяАгента, ПарольАгента, ИмяАдминистратора, ПарольАдминистратора, UUIDОпыта, UUIDКластера, Дополнительно; числовые ПортАгента, ПортRAS, ПортКластера; булевый ПодтвержденСвойСтенд. Поля всех паролей и Дополнительно переведите в режим пароля, значения не сохраняйте в настройках.
В своей VM вручную поднимите один отдельный ragent и один ras с отдельным новым каталогом реестров. RAS должен обслуживать именно этот агент, а не другой локальный сервис. Из реально выбранных администратором свободных портов впишите три разные величины: agent-port для ConnectAgent, ras-port для АдминистрированиеСервера, manager-port для своего кластера. Не подставляйте1545 в ConnectAgent.
До первого создания кластера вручную удалите только автоматически созданный пустой кластер своей новой VM, если он появился. Консоль должна показывать0кластеров; никакие чужие кластеры не допускаются. Первый урок также проверяет нулевой список обоими интерфейсами до RegCluster.
Заведите постоянного своего администратора агента и после создания кластера постоянного своего администратора кластера через консоль. Их реальные новые учебные пароли передавайте форме; учебные временные администраторы в уроке никогда не заменяют постоянных.
Один раз самостоятельно получите UUIDОпыта в своей файловой ИБ выражением Строка(Новый УникальныйИдентификатор), сохраните текст в собственном журнале опыта. Имя кластера: own-com85-cluster-<UUIDОпыта>. После создания сохраните фактический RAS UUIDКластера из результата; имя не заменяет UUID.
Читающая команда Каталог85 не равна доказательству отсутствия production. Изоляция VM и новый реестр обязательны до любого подключения. COM не предоставляет UUID в интерфейсе IClusterInfo: пример сопоставляет его с прочитанным UUID RAS по sole-кластеру, точным loopback/имени/порту.
Запись/применение/отмена регистрации выполняются только отдельной явно выбранной строкой Операция. Не добавляйте автоматические повторы, очистку при исключении или откат чужого состояния. В случае частичного выполнения сохраните UUID и сначала прочитайте фактическое состояние.
Пароли очищаются из реквизитов и локальной структуры, но это не гарантирует стирания строк из памяти. Не выводите ОписаниеОшибки, строки подключения, Password или аргументы операций. Код статически проверяется здесь, но COM/RAS/1С, сеть и процессы не запускались.
В новом агенте перед первой командой0кластеров. Операция=СоздатьКластер85, UUIDКластера пока пуст. После ответа занесите фактический UUID в форму и вручную заведите своего постоянного администратора кластера.
Для финальной команды УдалитьКластер85 сначала отдельными командами удалите собственные профили/серверы и ИБ предыдущих опытов, закройте учебные сеансы. Удаление ИБ здесь не выполняется. Убедитесь, что остался только созданный UUID и0ИБ.
Функция Выполнить85(Операция, Данные, Подтверждение) Экспорт
Если СтрРазделить("СоздатьКластер85,Каталог85,УдалитьКластер85", ",").Найти(Операция) = Неопределено Тогда
ВызватьИсключение "Выберите отдельную команду создания, каталога или удаления своего кластера";
КонецЕсли;
Связь = СоединитьсяСоСвоимАгентом85(Данные, Подтверждение);
Если Операция = "СоздатьКластер85" Тогда
Если Связь.RAS.ПолучитьКластеры().Количество() <> 0 Или Связь.Агент.GetClusters().Количество() <> 0 Тогда
ВызватьИсключение "Новое создание разрешено только при0кластеров";
КонецЕсли;
Кластер = Связь.Агент.CreateClusterInfo();
Кластер.ClusterName = "own-com85-cluster-" + Данные.UUIDОпыта;
Кластер.HostName = "127.0.0.1";
Кластер.MainPort = Данные.ПортКластера;
Кластер.SecurityLevel = 2;
Связь.Агент.RegCluster(Кластер);
Кластеры = Связь.RAS.ПолучитьКластеры();
Если Кластеры.Количество() <> 1 Тогда
ВызватьИсключение "Создание не подтверждено sole-кластером; повторять запись запрещено";
КонецЕсли;
Созданный = Кластеры[0];
Если Созданный.Имя <> Кластер.ClusterName Или Созданный.Порт <> Данные.ПортКластера
Или Созданный.ИмяКомпьютера <> "127.0.0.1" Тогда
ВызватьИсключение "Фактический паспорт созданного кластера не совпал";
КонецЕсли;
Созданный.ВыполнитьАутентификацию("", "");
Если Созданный.ПолучитьИнформационныеБазы().Количество() <> 0 Тогда
ВызватьИсключение "В собственном новом кластере неожиданно есть ИБ";
КонецЕсли;
Возврат "Создан только свой кластер. UUIDКластера=" + Строка(Созданный.ИдентификаторКластера)
+ ". Вручную заведите постоянного администратора кластера; не повторяйте СоздатьКластер85";
КонецЕсли;
Стенд = ПолучитьСвойКластер85(Связь, Данные);
Если Операция = "Каталог85" Тогда
Возврат "Подтвержден свой UUID=" + Строка(Стенд.RAS.ИдентификаторКластера) + "; ИБ=0";
КонецЕсли;
Если Связь.Агент.GetSessions(Стенд.COM).Количество() <> 0
Или Связь.Агент.GetConnections(Стенд.COM).Количество() <> 0 Тогда
ВызватьИсключение "Нельзя отменять регистрацию при оставшихся сеансах или соединениях";
КонецЕсли;
Если Связь.Агент.GetSecurityProfiles(Стенд.COM).Количество() <> 0 Тогда
ВызватьИсключение "Сначала явно удалите только созданные собственные учебные профили";
КонецЕсли;
Связь.Агент.UnregCluster(Стенд.COM);
Если Связь.Агент.GetClusters().Количество() <> 0 Или Связь.RAS.ПолучитьКластеры().Количество() <> 0 Тогда
ВызватьИсключение "Снятие регистрации не подтверждено двумя повторными чтениями";
КонецЕсли;
Возврат "Регистрация только своего пустого кластера снята; реестр0кластеров. Каталоги/файлы/службы не удалялись";
КонецФункции
Функция СоединитьсяСоСвоимАгентом85(Данные, Подтверждение)
ПроверитьСвойПустойСтенд();
Если ТипЗнч(Подтверждение) <> Тип("Булево") Или Не Подтверждение Тогда
ВызватьИсключение "Подтвердите отдельную собственную VM без рабочих кластеров";
КонецЕсли;
Для Каждого Поле Из СтрРазделить("ПортАгента,ПортRAS,ПортКластера", ",") Цикл
Порт = Данные[Поле];
Если ТипЗнч(Порт) <> Тип("Число") Тогда
ВызватьИсключение "Порт своего процесса должен быть числом";
КонецЕсли;
Если Порт < 1 Или Порт > 65535 Или Порт <> Цел(Порт) Тогда
ВызватьИсключение "Недопустимый фактический порт";
КонецЕсли;
КонецЦикла;
Если Данные.ПортАгента = Данные.ПортRAS Или Данные.ПортАгента = Данные.ПортКластера
Или Данные.ПортRAS = Данные.ПортКластера Тогда
ВызватьИсключение "Порты агента, менеджера кластера и ras различаются";
КонецЕсли;
Для Каждого Поле Из СтрРазделить("ИмяАгента,ПарольАгента,ИмяАдминистратора,ПарольАдминистратора,UUIDОпыта,UUIDКластера,Дополнительно", ",") Цикл
Если ТипЗнч(Данные[Поле]) <> Тип("Строка") Тогда
ВызватьИсключение "Имена, пароли и UUID должны быть строками";
КонецЕсли;
КонецЦикла;
ПроверитьUUID85(Данные.UUIDОпыта);
СерверRAS = Новый АдминистрированиеСервера("127.0.0.1", Данные.ПортRAS);
СерверRAS.ВыполнитьАутентификацию(Данные.ПарольАгента, Данные.ИмяАгента);
Если СерверRAS.ПолучитьВерсию() <> "8.5.1.1343" Тогда
ВызватьИсключение "RAS обязан обслуживать ровно собственный агент8.5.1.1343";
КонецЕсли;
Соединитель = Новый COMОбъект("V85.COMConnector");
Агент = Соединитель.ConnectAgent("127.0.0.1:" + Формат(Данные.ПортАгента, "ЧГ=0"));
Агент.AuthenticateAgent(Данные.ИмяАгента, Данные.ПарольАгента);
Возврат Новый Структура("Агент,RAS,Соединитель", Агент, СерверRAS, Соединитель);
КонецФункции
Процедура ПроверитьUUID85(UUID)
Проверенный = Новый УникальныйИдентификатор(UUID);
Если UUID <> Строка(Проверенный) Или UUID = "00000000-0000-0000-0000-000000000000" Тогда
ВызватьИсключение "Введите канонический собственный ненулевой UUID";
КонецЕсли;
КонецПроцедуры
Функция ПолучитьСвойКластер85(Связь, Данные, РазрешенаСвояБаза = Ложь)
ПроверитьUUID85(Данные.UUIDКластера);
КластерыRAS = Связь.RAS.ПолучитьКластеры();
Если КластерыRAS.Количество() <> 1 Тогда
ВызватьИсключение "В агенте должен быть только один собственный кластер";
КонецЕсли;
КластерRAS = КластерыRAS[0];
ИмяКластера = "own-com85-cluster-" + Данные.UUIDОпыта;
Если Строка(КластерRAS.ИдентификаторКластера) <> Данные.UUIDКластера
Или КластерRAS.Имя <> ИмяКластера Или КластерRAS.Порт <> Данные.ПортКластера
Или КластерRAS.ИмяКомпьютера <> "127.0.0.1" Тогда
ВызватьИсключение "RAS UUID, имя, loopback или порт своего кластера не совпали";
КонецЕсли;
КластерRAS.ВыполнитьАутентификацию(Данные.ИмяАдминистратора, Данные.ПарольАдминистратора);
БазыRAS = КластерRAS.ПолучитьИнформационныеБазы();
Если Не РазрешенаСвояБаза И БазыRAS.Количество() <> 0 Тогда
ВызватьИсключение "Этот урок требует полностью пустой кластер";
КонецЕсли;
Если РазрешенаСвояБаза Тогда
Если БазыRAS.Количество() <> 1 Тогда
ВызватьИсключение "Разрешена только одна специально подготовленная собственная ИБ";
КонецЕсли;
Если БазыRAS[0].Имя <> "own-com85-base-" + Данные.UUIDОпыта
Или (БазыRAS[0].Описание <> "owned-com85-lifecycle:" + Данные.UUIDОпыта
И БазыRAS[0].Описание <> "owned-com85-lifecycle:" + Данные.UUIDОпыта + ":checked") Тогда
ВызватьИсключение "Чужая ИБ или неверный маркер собственного стенда";
КонецЕсли;
КонецЕсли;
КластерыCOM = Связь.Агент.GetClusters();
Если КластерыCOM.Количество() <> 1 Тогда
ВызватьИсключение "COM и RAS должны видеть один и тот же sole кластер";
КонецЕсли;
Кластер = КластерыCOM.Получить(0);
Если Кластер.ClusterName <> КластерRAS.Имя Или Кластер.HostName <> КластерRAS.ИмяКомпьютера
Или Кластер.MainPort <> КластерRAS.Порт Тогда
ВызватьИсключение "Нельзя сопоставить COM-описание с собственным RAS UUID";
КонецЕсли;
Связь.Агент.Authenticate(Кластер, Данные.ИмяАдминистратора, Данные.ПарольАдминистратора);
БазыCOM = Связь.Агент.GetInfoBases(Кластер);
Если БазыCOM.Количество() <> БазыRAS.Количество() Тогда
ВызватьИсключение "Состояние собственных ИБ изменилось между чтениями";
КонецЕсли;
Основных = 0;
Вторичных = 0;
Для Каждого Рабочий Из КластерRAS.ПолучитьРабочиеСерверы() Цикл
Если Рабочий.ИмяКомпьютера <> "127.0.0.1" Тогда
ВызватьИсключение "В своём UUID-кластере появился нелокальный рабочий сервер";
КонецЕсли;
Если Рабочий.ЦентральныйСервер И Рабочий.Порт = Данные.ПортАгента Тогда
Основных = Основных + 1;
ИначеЕсли Не Рабочий.ЦентральныйСервер И Рабочий.Имя = "own-com85-worker-" + Данные.UUIDОпыта
И Рабочий.Порт <> Данные.ПортАгента Тогда
Вторичных = Вторичных + 1;
Иначе
ВызватьИсключение "Разрешены только собственные основной и UUID-вторичный рабочие серверы";
КонецЕсли;
КонецЦикла;
Если Основных <> 1 Или Вторичных > 1 Тогда
ВызватьИсключение "Own-топология рабочего стенда изменилась";
КонецЕсли;
Возврат Новый Структура("COM,RAS,БазыCOM,БазыRAS", Кластер, КластерRAS, БазыCOM, БазыRAS);
КонецФункции
Процедура ПроверитьСвойПустойСтенд()
Если Метаданные.Справочники.Количество() <> 0 Или Метаданные.Документы.Количество() <> 0 Или Метаданные.Перечисления.Количество() <> 0 Или Метаданные.РегистрыСведений.Количество() <> 0 Или Метаданные.РегистрыНакопления.Количество() <> 0 Или Метаданные.РегистрыБухгалтерии.Количество() <> 0 Или Метаданные.РегистрыРасчета.Количество() <> 0 Или Метаданные.ПланыВидовХарактеристик.Количество() <> 0 Или Метаданные.ПланыВидовРасчета.Количество() <> 0 Или Метаданные.ПланыСчетов.Количество() <> 0 Или Метаданные.ПланыОбмена.Количество() <> 0 Или Метаданные.Последовательности.Количество() <> 0 Или Метаданные.БизнесПроцессы.Количество() <> 0 Или Метаданные.Задачи.Количество() <> 0 Или Метаданные.ОбщиеРеквизиты.Количество() <> 0 Или Метаданные.ПодпискиНаСобытия.Количество() <> 0 Или Метаданные.РегламентныеЗадания.Количество() <> 0 Или Метаданные.ВнешниеИсточникиДанных.Количество() <> 0 Тогда
ВызватьИсключение "Нужен только свой новый пустой учебный стенд";
КонецЕсли;
Если Метаданные.ЕстьИзмененияРасширениямиКонфигурации() Тогда
ВызватьИсключение "Свой сеанс не должен изменяться расширениями";
КонецЕсли;
Источники = Новый Массив;
Источники.Добавить(ИсточникРасширенийКонфигурации.БазаДанных);
Источники.Добавить(ИсточникРасширенийКонфигурации.СеансАктивные);
Источники.Добавить(ИсточникРасширенийКонфигурации.СеансОтключенные);
Для Каждого Источник Из Источники Цикл
Расширения = РасширенияКонфигурации.Получить(, Источник);
Если ТипЗнч(Расширения) <> Тип("Массив") Тогда
ВызватьИсключение "Native список расширений должен иметь тип Массив";
КонецЕсли;
Если Расширения.Количество() <> 0 Тогда
ВызватьИсключение "В своём новом стенде нет расширений базы или сеанса";
КонецЕсли;
КонецЦикла;
Если ТранзакцияАктивна() Тогда
ВызватьИсключение "Чужая или вложенная активная транзакция не допускается";
КонецЕсли;
КонецПроцедурыМодуль управляемой формы обработки: команда Выполнить
Обработка.УчебныйCOM85.Форма.Форма: полный модуль формы
Клиентский/серверный модуль управляемой формы отдельной файловой ИБ; процедуры уже содержат директивы. Поля созданы согласно подготовке.
&НаКлиенте
Процедура Выполнить(Команда)
Данные = Новый Структура;
Данные.Вставить("ПортАгента", ПортАгента);
Данные.Вставить("ПортRAS", ПортRAS);
Данные.Вставить("ПортКластера", ПортКластера);
Данные.Вставить("ИмяАгента", ИмяАгента);
Данные.Вставить("ПарольАгента", ПарольАгента);
Данные.Вставить("ИмяАдминистратора", ИмяАдминистратора);
Данные.Вставить("ПарольАдминистратора", ПарольАдминистратора);
Данные.Вставить("UUIDОпыта", UUIDОпыта);
Данные.Вставить("UUIDКластера", UUIDКластера);
Данные.Вставить("Дополнительно", Дополнительно);
ПарольАгента = "";
ПарольАдминистратора = "";
Дополнительно = "";
Попытка
Ответ = ВыполнитьНаСервере(Операция, Данные, ПодтвержденСвойСтенд);
Исключение
Данные.ПарольАгента = "";
Данные.ПарольАдминистратора = "";
Данные.Дополнительно = "";
Сообщить("Операция не подтверждена. Не повторяйте запись автоматически. Проверьте только свой изолированный стенд и ранее записанные UUID.");
Возврат;
КонецПопытки;
Данные.ПарольАгента = "";
Данные.ПарольАдминистратора = "";
Данные.Дополнительно = "";
Сообщить(Ответ);
КонецПроцедуры
&НаСервереБезКонтекста
Функция ВыполнитьНаСервере(Операция, Данные, ПодтвержденСвойСтенд)
Возврат УчебныйCOM85.Выполнить85(Операция, Данные, ПодтвержденСвойСтенд);
КонецФункцииРазбор по шагам
СоединитьсяСоСвоимАгентом85 проверяет точную платформу, новую пустую конфигурацию и явное подтверждение VM; только затем создает свои два административных подключения.
RAS выполняет проверку точной версии обслуживаемого агента. COM и RAS получают разные порты; COM AuthenticateAgent принимает имя, затем пароль, тогда как RAS ВыполнитьАутентификацию принимает пароль, затем имя.
ПолучитьСвойКластер85 принимает только один кластер: собственный UUID, имя с UUIDОпыта, loopback127.0.0.1 и фактический порт. UUID берется из RAS, не выдумывается как свойство COM-кластера.
До операции повторно проверяется допустимый набор ИБ; по умолчанию0. Постоянная кластерная аутентификация отделена от агентской и не заменяется учетными данными временного создаваемого объекта.
До RegCluster и RAS, и COM подтверждают0кластеров. Фабрика возвращает новое описание, которому явно заданы собственные имя, loopback, фактический manager-port и SecurityLevel2.
После регистрации заново читается RAS-массив; фактический UUID сообщается ученику. UUIDОпыта и UUIDКластера различны: первый метка принадлежности, второй реальная идентичность сервера.
Каталог85 повторно проверяет UUID и0ИБ. УдалитьКластер85 не удаляет папки; проверяет0сеансов/соединений и0профилей, снимает только собственную регистрацию, затем требует0кластеров обоими API.
Как проверить результат
При появлении любого другого кластера до создания запись запрещена.
После создания имя и порт совпадают, UUID сохранен; повторное создание отклоняется.
После явного снятия регистрации оба списка пусты; чужие каталоги и службы не затронуты.
Ожидаемый результат
Ученик умеет отличать черновик COM-описания, реально зарегистрированный кластер, UUID RAS и отмену регистрации пустого кластера.
На что обратить внимание
Это будущий ручной учебный запуск на собственной VM, а не уже выполненная операция. runtimeVerifiedScenarios остается0; статические проверки не гарантируют COM-регистрацию, лицензии или успешный ответ агента.
Проверки выполняются перед вызовами, но не образуют распределенную транзакцию и не исключают гонку. Только один оператор может менять стенд; при любом несоответствии остановитесь.
Не используйте production, копию рабочего реестра или имена чужих пользователей. Нельзя расширять разрешения рабочей базы ради COM-подключения.
RegCluster может обновлять/регистрировать существующий объект; поэтому пример разрешает фабрику только при0кластеров и не переиспользует чужое описание.
UnregCluster требует аутентификацию кластера и работает только с пустым кластером; его нельзя применять для ремонта production.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.