Соединение с агентом сервера.UnregCluster

С нулевого реестра создать свой кластер и явно снять регистрацию только пустого UUID

Настоящие CreateClusterInfo/RegCluster/UnregCluster в собственном учебном жизненном цикле, без изменения чужих кластеров и без удаления реестра с диска.

Подготовка

1. Работайте только в новой отдельной Windows-VM без рабочих процессов/кластеров. Установленная платформа и заранее зарегистрированный V85.COMConnector должны быть8.5.1.1343 соответствующей разрядности. Регистрацию COM и запуск служб этот BSL не выполняет.

2. Создайте отдельную файловую ИБ с именем конфигурации УчебныйЖизненныйЦиклCOM85: без данных, каталогов, документов, регистров, подписок, фоновых заданий и расширений. В ней создайте общий модуль УчебныйCOM85: Сервер=Истина, ВызовСервера=Истина, Глобальный=Ложь, Клиент/ВнешнееСоединение=Ложь. Вставьте полностью код одного урока, не смешивайте одинаковые функции разных уроков.

3. Создайте обработку и управляемую форму с командой Выполнить и полным модулем формы из дополнительного блока. Строковые реквизиты: Операция, ИмяАгента, ПарольАгента, ИмяАдминистратора, ПарольАдминистратора, UUIDОпыта, UUIDКластера, Дополнительно; числовые ПортАгента, ПортRAS, ПортКластера; булевый ПодтвержденСвойСтенд. Поля всех паролей и Дополнительно переведите в режим пароля, значения не сохраняйте в настройках.

4. В своей VM вручную поднимите один отдельный ragent и один ras с отдельным новым каталогом реестров. RAS должен обслуживать именно этот агент, а не другой локальный сервис. Из реально выбранных администратором свободных портов впишите три разные величины: agent-port для ConnectAgent, ras-port для АдминистрированиеСервера, manager-port для своего кластера. Не подставляйте1545 в ConnectAgent.

5. До первого создания кластера вручную удалите только автоматически созданный пустой кластер своей новой VM, если он появился. Консоль должна показывать0кластеров; никакие чужие кластеры не допускаются. Первый урок также проверяет нулевой список обоими интерфейсами до RegCluster.

6. Заведите постоянного своего администратора агента и после создания кластера постоянного своего администратора кластера через консоль. Их реальные новые учебные пароли передавайте форме; учебные временные администраторы в уроке никогда не заменяют постоянных.

7. Один раз самостоятельно получите UUIDОпыта в своей файловой ИБ выражением Строка(Новый УникальныйИдентификатор), сохраните текст в собственном журнале опыта. Имя кластера: own-com85-cluster-<UUIDОпыта>. После создания сохраните фактический RAS UUIDКластера из результата; имя не заменяет UUID.

8. Читающая команда Каталог85 не равна доказательству отсутствия production. Изоляция VM и новый реестр обязательны до любого подключения. COM не предоставляет UUID в интерфейсе IClusterInfo: пример сопоставляет его с прочитанным UUID RAS по sole-кластеру, точным loopback/имени/порту.

9. Запись/применение/отмена регистрации выполняются только отдельной явно выбранной строкой Операция. Не добавляйте автоматические повторы, очистку при исключении или откат чужого состояния. В случае частичного выполнения сохраните UUID и сначала прочитайте фактическое состояние.

10. Пароли очищаются из реквизитов и локальной структуры, но это не гарантирует стирания строк из памяти. Не выводите ОписаниеОшибки, строки подключения, Password или аргументы операций. Код статически проверяется здесь, но COM/RAS/1С, сеть и процессы не запускались.

11. В новом агенте перед первой командой0кластеров. Операция=СоздатьКластер85, UUIDКластера пока пуст. После ответа занесите фактический UUID в форму и вручную заведите своего постоянного администратора кластера.

12. Для финальной команды УдалитьКластер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 Тогда
            ВызватьИсключение "В своём новом стенде нет расширений базы или сеанса";
        КонецЕсли;
    КонецЦикла;
    Если ТранзакцияАктивна() Тогда
        ВызватьИсключение "Чужая или вложенная активная транзакция не допускается";
    КонецЕсли;
КонецПроцедуры

&НаКлиенте
Процедура Выполнить(Команда)
    Данные = Новый Структура;
    Данные.Вставить("ПортАгента", ПортАгента);
    Данные.Вставить("ПортRAS", ПортRAS);
    Данные.Вставить("ПортКластера", ПортКластера);
    Данные.Вставить("ИмяАгента", ИмяАгента);
    Данные.Вставить("ПарольАгента", ПарольАгента);
    Данные.Вставить("ИмяАдминистратора", ИмяАдминистратора);
    Данные.Вставить("ПарольАдминистратора", ПарольАдминистратора);
    Данные.Вставить("UUIDОпыта", UUIDОпыта);
    Данные.Вставить("UUIDКластера", UUIDКластера);
    Данные.Вставить("Дополнительно", Дополнительно);
    ПарольАгента = "";
    ПарольАдминистратора = "";
    Дополнительно = "";
    Попытка
        Ответ = ВыполнитьНаСервере(Операция, Данные, ПодтвержденСвойСтенд);
    Исключение
        Данные.ПарольАгента = "";
        Данные.ПарольАдминистратора = "";
        Данные.Дополнительно = "";
        Сообщить("Операция не подтверждена. Не повторяйте запись автоматически. Проверьте только свой изолированный стенд и ранее записанные UUID.");
        Возврат;
    КонецПопытки;
    Данные.ПарольАгента = "";
    Данные.ПарольАдминистратора = "";
    Данные.Дополнительно = "";
    Сообщить(Ответ);
КонецПроцедуры

&НаСервереБезКонтекста
Функция ВыполнитьНаСервере(Операция, Данные, ПодтвержденСвойСтенд)
    Возврат УчебныйCOM85.Выполнить85(Операция, Данные, ПодтвержденСвойСтенд);
КонецФункции

Разбор по шагам

1. СоединитьсяСоСвоимАгентом85 проверяет точную платформу, новую пустую конфигурацию и явное подтверждение VM; только затем создает свои два административных подключения.

2. RAS выполняет проверку точной версии обслуживаемого агента. COM и RAS получают разные порты; COM AuthenticateAgent принимает имя, затем пароль, тогда как RAS ВыполнитьАутентификацию принимает пароль, затем имя.

3. ПолучитьСвойКластер85 принимает только один кластер: собственный UUID, имя с UUIDОпыта, loopback127.0.0.1 и фактический порт. UUID берется из RAS, не выдумывается как свойство COM-кластера.

4. До операции повторно проверяется допустимый набор ИБ; по умолчанию0. Постоянная кластерная аутентификация отделена от агентской и не заменяется учетными данными временного создаваемого объекта.

5. До RegCluster и RAS, и COM подтверждают0кластеров. Фабрика возвращает новое описание, которому явно заданы собственные имя, loopback, фактический manager-port и SecurityLevel2.

6. После регистрации заново читается RAS-массив; фактический UUID сообщается ученику. UUIDОпыта и UUIDКластера различны: первый метка принадлежности, второй реальная идентичность сервера.

7. Каталог85 повторно проверяет UUID и0ИБ. УдалитьКластер85 не удаляет папки; проверяет0сеансов/соединений и0профилей, снимает только собственную регистрацию, затем требует0кластеров обоими API.

Как проверить результат

1. При появлении любого другого кластера до создания запись запрещена.

2. После создания имя и порт совпадают, UUID сохранен; повторное создание отклоняется.

3. После явного снятия регистрации оба списка пусты; чужие каталоги и службы не затронуты.

Ожидаемый результат

Ученик умеет отличать черновик COM-описания, реально зарегистрированный кластер, UUID RAS и отмену регистрации пустого кластера.

На что обратить внимание

1. Это будущий ручной учебный запуск на собственной VM, а не уже выполненная операция. runtimeVerifiedScenarios остается0; статические проверки не гарантируют COM-регистрацию, лицензии или успешный ответ агента.

2. Проверки выполняются перед вызовами, но не образуют распределенную транзакцию и не исключают гонку. Только один оператор может менять стенд; при любом несоответствии остановитесь.

3. Не используйте production, копию рабочего реестра или имена чужих пользователей. Нельзя расширять разрешения рабочей базы ради COM-подключения.

4. RegCluster может обновлять/регистрировать существующий объект; поэтому пример разрешает фабрику только при0кластеров и не переиспользует чужое описание.

5. UnregCluster требует аутентификацию кластера и работает только с пустым кластером; его нельзя применять для ремонта production.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.