Поделиться через

Разработка модуля Runbook с помощью VS Code в служба автоматизации Azure

  • Статья

В этой статье объясняется расширение Visual Studio, которое можно использовать для создания модулей Runbook и управления ими.

служба автоматизации Azure предоставляет новое расширение из VS Code для создания модулей Runbook и управления ими. С помощью этого расширения можно выполнять все операции управления модулями Runbook, такие как создание и редактирование модулей Runbook, активация задания, отслеживание последних выходных данных заданий, связывание расписания, управления ресурсами и локальной отладки.

Необходимые компоненты

Поддерживаемые операционные системы

Матрица тестирования включает следующие операционные системы:

  1. Windows Server 2022 с Windows PowerShell 5.1 и PowerShell Core 7.2.7
  2. Windows Server 2019 с Windows PowerShell 5.1 и PowerShell Core 7.2.7
  3. macOS 11 с PowerShell Core 7.2.7
  4. Ubuntu 20.04 с PowerShell Core 7.2.7

Примечание.

  • Расширение должно работать в любом месте VS Code и поддерживает PowerShell 7.2 или более поздней версии. Для Windows PowerShell поддерживается только версия 5.1.
  • PowerShell Core 6 является конечным и не поддерживается.

Основные возможности

  • Упрощенное подключение . Вы можете войти с помощью учетной записи Azure простым и безопасным способом.
  • Несколько языков . Поддерживает все стеки среды выполнения службы автоматизации, такие как PowerShell 5, PowerShell 7, Python 2 и Runbook Python 3.
  • Поддержка. Поддерживает тестирование выполнения задания, публикации задания автоматизации и активации задания в Azure и гибридных рабочих ролей. Модули Runbook можно выполнять локально.
  • Поддерживает позиционные параметры Python и параметры PowerShell для активации задания.
  • Веб-перехватчики упрощены . Вы можете создать веб-перехватчик, запустить задание с помощью веб-перехватчика проще. Кроме того, поддержка связывания расписания с Runbook.
  • Управление ресурсами службы автоматизации. Вы можете выполнять операции создания, обновления и удаления ресурсов, включая сертификаты, переменные, учетные данные и подключения.
  • Просмотр свойств. Вы можете просмотреть свойства и выбрать гибридную рабочую группу для выполнения гибридных заданий и просмотреть последние 10 выполненных заданий.
  • Локальная отладка— вы можете локально выполнять отладку скриптов PowerShell.
  • Сравнение модулей Runbook. Вы можете сравнить локальный модуль Runbook с опубликованной или черновиковой копией runbook.

Основные функции версии 1.0.8

  • Параметры конфигурации локального каталога. Вы можете определить рабочий каталог, который требуется сохранить модули Runbook локально.

    • Изменение каталога:Базовый путь — при повторном открытии интегрированной среды разработки Visual Studio Code используется измененный путь к каталогу. Чтобы изменить каталог с помощью палитры команд, нажмите клавиши CTRL+SHIFT+P —> выберите "Изменить каталог". Чтобы изменить базовый путь из параметров конфигурации расширения, щелкните значок "Управление" в строке действий слева и перейдите к расширениям > параметров > служба автоматизации Azure > Directory:Base Path.
    • Изменение структуры каталогов: папка — можно изменить структуру папок локального каталога с vscodeAutomation/accHash на подписку/resourceGroup/automationAccount. Щелкните значок "Управление" в строке действий слева и перейдите к расширениям > параметров > служба автоматизации Azure > Directory:Folder Structure. Параметр конфигурации по умолчанию можно изменить с vscodeAutomation/accHash на формат subscription/resourceGroupe/automationAccount .

      Примечание.

      Если учетная запись службы автоматизации интегрирована с системой управления версиями, вы можете указать путь к папке Runbook репозитория GitHub в качестве пути к каталогу. Например, изменение каталога на C:\abc будет хранить модули Runbook в C:\abc\vscodeAutomation.. или C:\abc/subscriptionName//resourceGroupName//automationAccountName//Runbookname.ps1.

  • Операции управления Runbook. Вы можете создать runbook, получить черновик Runbook, получить опубликованный модуль Runbook, открыть локальный модуль Runbook в редакторе, сравнить локальный модуль Runbook с опубликованной или черновиковой копией Runbook, отправить как черновик, опубликовать runbook и удалить runbook из учетной записи службы автоматизации.

  • Операции выполнения Runbook. Вы можете запустить локальную версию заданий автоматизации, таких как задания запуска автоматизации, тестовое задание запуска службы автоматизации, просмотр выходных данных задания и запуск локальной версии Runbook PowerShell в режиме отладки, позволяя добавлять точки останова в скрипт.

    Примечание.

    В настоящее время мы поддерживаем использование внутренних командлетов, таких как Get-AutomationVariable только с нешифрованных ресурсов.

  • Работа с расписаниями, ресурсами и веб-перехватчиками . Вы можете просмотреть свойства расписания, удалить расписание, связать расписание с runbook.

  • Добавление веб-перехватчика — вы можете добавить веб-перехватчик в модуль Runbook.

  • Обновление свойств ресурсов . Вы можете создавать, обновлять, просматривать свойства ресурсов, таких как сертификаты, подключения, учетные данные, переменные и удаление ресурсов из расширения.

Ограничения

В настоящее время следующие функции не поддерживаются:

  • Создание новых расписаний.
  • Добавление новых сертификатов в ресурсы.
  • Отправка пакетов модулей (PowerShell и Python) из расширения.
  • Автоматическая синхронизация локальных модулей Runbook с служба автоматизации Azure учетной записью. Вам потребуется выполнить операцию для получения или публикации модуля Runbook.
  • Управление гибридными рабочими группами.
  • Графический модуль Runbook и рабочие процессы.
  • Для Python мы не предоставляем никаких параметров отладки. Рекомендуется установить любое расширение отладчика в скрипте Python.
  • В настоящее время мы поддерживаем только незашифрованные ресурсы в локальном запуске.

Следующие шаги