https://doc.ruscomtech.ru/index.php?action=history&feed=atom&title=%D0%9F%D0%B5%D1%80%D0%B5%D0%BD%D0%BE%D1%81_%D1%80%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D0%B9_PythonПеренос расширений Python - История изменений2026-04-13T14:26:16ZИстория изменений этой страницы в викиMediaWiki 1.36.1https://doc.ruscomtech.ru/index.php?title=%D0%9F%D0%B5%D1%80%D0%B5%D0%BD%D0%BE%D1%81_%D1%80%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D0%B9_Python&diff=5762&oldid=prevIKuznetsov: Новая страница: «== Требования == * [https://www.python.org/downloads/ Python 3.10]. * Ключ-АСТРОМ версии 1.286 или более поздней. * <...»2025-09-18T15:35:08Z<p>Новая страница: «== Требования == * [https://www.python.org/downloads/ Python 3.10]. * Ключ-АСТРОМ версии 1.286 или более поздней. * <...»</p>
<p><b>Новая страница</b></p><div>== Требования ==<br />
<br />
* [https://www.python.org/downloads/ Python 3.10].<br />
* Ключ-АСТРОМ версии 1.286 или более поздней.<br />
* <code>dt-extensions-sdk[cli]</code> установлен в вашем <code>PATH</code>.<br />
<br />
{| class="wikitable"<br />
|Проверьте, установлен ли у вас <code>dt-extensions-sdk</code> в <code>PATH</code>, запустив <code>dt-sdk --version</code> на терминале.<br />
|}<br />
<br />
== Последовательность действи ==<br />
Чтобы перенести существующее расширение '''Python EF1''' с помощью '''Visual Studio Code''', выполните следующие действия.<br />
<br />
# Создайте новое расширение '''EF2'''.<br />
# Импортируйте расширение '''EF1''' с помощью команды <code>astromkey extensions: Convert Python</code>.<br />
# Преобразуйте код, переместив класс из исходного расширения в файл <code>__main__.py</code> нового расширения.<br />
<br />
=== Создание нового расширения EF2 ===<br />
<br />
# Откройте пустую папку в '''Visual Studio Code''', затем выполните команду <code>astromkey extensions: Initialize Workspace</code>.<br />
# Выберите версию схемы (рекомендуется последняя) и сертификаты, которые вы хотите использовать для подписи расширения.<br />
# Выберите тип проекта <code>Python Extension 2.0</code>.<br />
# Дайте своему расширению имя; оно должно соответствовать соглашению об именовании модулей '''Python''', используя все строчные буквы с необязательными подчеркиваниями.<br />
<br />
=== Импорт существующего расширения EF1 ===<br />
'''Первый шаг''' — конвертировать старый файл <code>plugin.json</code> в новый формат <code>activationSchema.json</code>. Это автоматически создаст пользовательский интерфейс '''Settings 2.0''' для вашего расширения, который определяет пользовательский интерфейс для настройки расширения.<br />
<br />
Выполните команду <code>astromkey extensions: Convert Python</code>. Вы можете импортировать существующее расширение '''Python''' из:<br />
<br />
* Расширения '''zip'''- файла<br />
* Файла '''plugin.json'''<br />
* Вашей среды Ключ-АСТРОМ<br />
<br />
В этом примере мы импортируем из среды Ключ-АСТРОМ , что дает вам список всех расширений '''Python''' в этой среде.<br />
<br />
Если вы хотите импортировать данные со своего компьютера, откроется окно выбора файлов, в котором вы сможете выбрать '''ZIP-файл''' расширения или файл '''plugin.json'''.<br />
<br />
После выбора расширения ваши настройки <code>activationSchema.json</code> будут перезаписаны правильными. Вам необходимо проверить файл, чтобы убедиться, что ваш интерфейс выглядит так, как вы хотите.<br />
<br />
При импорте локального расширения ЕдиногоАгента удалите запись <code>activation > remote</code> из файла <code>extension.yaml file</code>.<br />
<br />
Однако при импорте удаленного расширения АктивногоШлюза удалите <code>activation > local</code>.<br />
<br />
Вы также можете заставить свое расширение работать удаленно и локально, сохранив обе записи и изменив файл <code>activationSchema.json</code> соответствующим образом.<br />
<br />
=== Изменение кода расширения ===<br />
Перенесите существующий код расширения в файл нового расширения <code>__main__.py</code>. Проще всего это сделать, вставив код из существующего класса расширения в новый класс <code>ExtensionImpl</code>.<br />
<br />
Вот наиболее существенные изменения, которые вам необходимо внести в свой код:<br />
<br />
==== Справочник по преобразованию кодов ====<br />
{| class="wikitable"<br />
!Описание<br />
!Метод EF1<br />
!Метод EF2<br />
!Примечания<br />
|-<br />
|Ведение логов<br />
|<code>self.logger.info("message")</code><br />
|<code>self.logger.info("message")</code><br />
|Остается прежним<br />
|-<br />
|Получение пользовательских параметров<br />
|<code>self.config.get("param_name", "default_value")</code><br />
|<code>self.activation_config.get("param_name", "default_value")</code><br />
|Вы можете найти и заменить все записи <code>self.config.</code> на <code>self.activation_config.</code><br />
|-<br />
|Сообщение о событии<br />
|<code>self.results_builder.report_custom_info_event</code><br />
|<code>self.report_dt_event</code><br />
|Постарайтесь не включать топологию (группы, устройства, идентификаторы) в код; это определяется далее в файле <code>extension.yaml</code>.<br />
|-<br />
|Сообщение метрики<br />
|<code>device.absolute("metric_key", metric_value, {"dimension_name": "dimension_value"})</code><br />
|<code>self.report_metric("metric_key", metric_value, {"dimension_name": "dimension_value"})</code><br />
|В коде Python больше нет концепции <code>device</code>; отправляйте метрики напрямую.<br />
|-<br />
|Создание группы и пользовательского устройства<br />
|<code>self.topology_builder.create_group</code>,<code>group.create_device</code><br />
|<code>n/a</code><br />
|Не существует; топология определена в файле <code>extension.yaml</code>.<br />
|}<br />
<br />
=== Создание и загрузка расширения ===<br />
Соберите расширение, выполнив команду <code>astromkey extensions: Build</code>. Если сборка прошла успешно, вы увидите приглашение загрузить расширение в среду Ключ-АСТРОМ и активировать его. Примите оба приглашения.<br />
<br />
Теперь ваше расширение загружено в Ключ-АСТРОМ, и вы можете создать конфигурации мониторинга, чтобы начать мониторинг.</div>IKuznetsov