Udostępnij przez

Tworzenie elementów Runbook za pomocą programu VS Code w usłudze Azure Automation

W tym artykule opisano rozszerzenie programu Visual Studio, którego można użyć do tworzenia elementów Runbook i zarządzania nimi.

Usługa Azure Automation udostępnia nowe rozszerzenie z programu VS Code w celu tworzenia elementów Runbook i zarządzania nimi. Za pomocą tego rozszerzenia można wykonywać wszystkie operacje zarządzania elementami Runbook, takie jak tworzenie i edytowanie elementów Runbook, wyzwalanie zadania, śledzenie ostatnich danych wyjściowych zadań, łączenie harmonogramu, zarządzanie zasobami i lokalne debugowanie.

Wymagania wstępne

  • Konto platformy Azure z aktywną subskrypcją.  Utwórz konto bezpłatnie.
  • Visual Studio Code
  • Moduły programu PowerShell i pakiety języka Python używane przez element Runbook muszą być zainstalowane lokalnie na maszynie, aby uruchomić element Runbook lokalnie.

Obsługiwane systemy operacyjne

Macierz testowa obejmuje następujące systemy operacyjne:

  1. Windows Server 2022 z programem Windows PowerShell 5.1 i programem PowerShell Core 7.2.7
  2. Windows Server 2019 z programem Windows PowerShell 5.1 i programem PowerShell Core 7.2.7
  3. macOS 11 z programem PowerShell Core 7.2.7
  4. Ubuntu 20.04 z programem PowerShell Core 7.2.7

Uwaga

  • Rozszerzenie powinno działać w dowolnym miejscu w programie VS Code i obsługuje program PowerShell 7.2 lub nowszy. W przypadku programu Windows PowerShell obsługiwana jest tylko wersja 5.1.
  • PowerShell Core 6 jest wycofany z eksploatacji i nie jest obsługiwany.

Najważniejsze funkcje    

  • Uproszczone dołączanie — możesz zalogować się przy użyciu konta platformy Azure w prosty i bezpieczny sposób.
  • Wiele języków — obsługuje cały stos środowiska uruchomieniowego automatyzacji, taki jak PowerShell 5, PowerShell 7, Python 2 i Python 3 Runbook.
  • Wsparcie — wspiera wykonywanie testów zadania, publikowanie zadania automatyzacji i wyzwalanie zadania na platformie Azure i hybrydowych pracowników. Można wykonywać runbooki lokalnie.
  • Obsługuje parametry pozycyjne języka Python i parametry programu PowerShell do wyzwalania zadania.
  • Webhooki uproszczone — można utworzyć webhook, uruchomić zadanie przez webhook w prostszy sposób. Ponadto, wsparcie dla łączenia harmonogramu z Runbookiem.
  • Zarządzaj zasobami w Automatyzacji — można tworzyć, aktualizować i usuwać te zasoby, w tym certyfikaty, zmienne, poświadczenia i połączenia.
  • Wyświetl właściwości — możesz wyświetlić właściwości i wybrać hybrydową grupę roboczą, aby wykonywać zadania hybrydowe i przejrzeć ostatnie 10 wykonanych zadań.
  • Debuguj lokalnie — możesz debugować skrypty programu PowerShell lokalnie.
  • Porównanie elementu Runbook — możesz porównać lokalny element Runbook z opublikowaną lub roboczą kopią elementu Runbook.

Najważniejsze funkcje wersji 1.0.8

  • Ustawienia konfiguracji katalogu lokalnego — możesz zdefiniować katalog roboczy, który chcesz zapisywać lokalnie.

    • Zmień katalog:ścieżka podstawowa — po ponownym otwarciu środowiska IDE programu Visual Studio Code należy użyć zmienionej ścieżki katalogu. Aby zmienić katalog przy użyciu palety poleceń, użyj Ctrl+Shift+P —> wybierz pozycję Zmień katalog. Aby zmienić ścieżkę podstawową w ustawieniach konfiguracji rozszerzenia, wybierz ikonę Zarządzaj na pasku działań po lewej stronie i przejdź do Ustawień > Rozszerzenia > Azure Automation > Directory: Ścieżka podstawowa.
    • Zmień katalog:Struktura folderów — możesz zmienić strukturę folderów katalogu lokalnego z vscodeAutomation/accHash na subscription/resourceGroup/automationAccount. Wybierz ikonę Zarządzaj na pasku aktywności po lewej stronie i przejdź do Ustawienia > Rozszerzenia > Azure Automation > Katalog:Struktura folderów. Możesz zmienić domyślne ustawienie konfiguracji z vscodeAutomation/accHash na subscription/resourceGroupe/automationAccount format.

      Uwaga

      Jeśli konto Automation jest zintegrowane z systemem kontroli wersji, możesz wskazać ścieżkę do folderu uruchomienia Runbooka w repozytorium GitHub jako ścieżkę katalogu. Na przykład: zmiana katalogu na C:\abc spowoduje zapisanie skryptów zarządzania w folderze C:\abc\vscodeAutomation.. lub C:\abc\subscriptionName\resourceGroupName\automationAccountName\runbookname.ps1.

  • Operacje zarządzania elementami Runbook — można utworzyć element Runbook, pobrać roboczy element Runbook, pobrać opublikowany element Runbook, otworzyć lokalny element Runbook w edytorze, porównać lokalny element Runbook z opublikowaną lub roboczą kopią elementu Runbook, przekazać go jako wersję roboczą, opublikować element Runbook i usunąć element Runbook z konta usługi Automation.

  • Operacje wykonywania Runbook — można uruchamiać lokalną wersję zadań automatyzacji, takich jak Start Automation jobs, uruchamianie zadania testowego automatyzacji, wyświetlanie danych wyjściowych zadania oraz uruchamianie lokalnej wersji Runbook programu PowerShell w trybie debugowania, co umożliwia dodawanie punktów przerwania w skrypcie.

    Uwaga

    Obecnie obsługujemy używanie wewnętrznych poleceń cmdlet, takich jak Get-AutomationVariable tylko w przypadku nieszyfrowanych zasobów.

  • Praca z harmonogramami, zasobami i webhookami — możesz wyświetlić właściwości harmonogramu, usunąć harmonogram, połączyć harmonogram, aby połączyć harmonogram z Runbookiem.

  • Dodaj webhook — możesz dodać webhook do runbooka.

  • Aktualizowanie właściwości zasobów — można tworzyć, aktualizować, wyświetlać właściwości zasobów, takich jak certyfikaty, połączenia, poświadczenia, zmienne i usuwanie zasobów z rozszerzenia.

Ograniczenia

Obecnie następujące funkcje nie są obsługiwane:

  • Tworzenie nowych harmonogramów.
  • Dodawanie nowych certyfikatów w zasobach.
  • Prześlij pakiety modułów PowerShell i Python z poziomu rozszerzenia.
  • Automatyczna synchronizacja lokalnych Runbooków z kontem Azure Automation. Trzeba wykonać operację pobierania lub publikowania runbooka.
  • Zarządzanie grupami pracowników hybrydowych.
  • Graficzne runbooki i przepływy pracy.
  • W przypadku języka Python nie udostępniamy żadnych opcji debugowania. Zalecamy zainstalowanie dowolnego rozszerzenia debugera w skryscie języka Python.
  • Obecnie obsługujemy tylko niezaszyfrowane zasoby w lokalnym uruchomieniu.

Następne kroki

  • Last updated on