Разработка Runbook с помощью VS Code в Azure Automation

В этой статье объясняется расширение 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

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

    • Изменение каталога:Базовый путь — при повторном открытии интегрированной среды разработки Visual Studio Code используется измененный путь к каталогу. Чтобы изменить каталог с помощью палитры команд, нажмите клавиши CTRL+SHIFT+P —> выберите "Изменить каталог". Чтобы изменить базовый путь из настроек конфигурации расширения, выберите значок Управление на панели действий слева и перейдите в Настройки > Расширения > Автоматизация Azure > Directory: Base Path.
    • Изменить каталог: структура папок - можно изменить структуру папок локального каталога с vscodeAutomation/accHash на subscription/resourceGroup/automationAccount. Щелкните значок Управление в строке действий слева и перейдите в Параметры > Расширения > Azure Automation > 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 PowerShell в режиме отладки, с возможностью добавления точек останова в скрипт.

    Примечание.

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

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

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

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

Ограничения

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

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

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