Share via

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

  • Artykuł

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.
  • Program 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.
  • Program PowerShell Core 6 jest end-of-life 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.
  • Możliwość obsługi — obsługuje wykonywanie testowe zadania, publikowanie zadania automatyzacji i wyzwalanie zadania na platformie Azure i hybrydowych procesów roboczych. Elementy Runbook można wykonywać lokalnie.
  • Obsługuje parametry pozycyjne języka Python i parametry programu PowerShell do wyzwalania zadania.
  • Uproszczone elementy webhook — można utworzyć element webhook, uruchomić zadanie za pomocą elementu webhook w prostszy sposób. Ponadto obsługa łączenia harmonogramu z elementem Runbook.
  • Zarządzanie zasobami usługi Automation — można wykonać operację tworzenia, aktualizowania i usuwania zasobów, w tym certyfikatów, zmiennych, poświadczeń i połączeń.
  • Wyświetl właściwości — możesz wyświetlić właściwości i wybrać grupę hybrydowych procesów roboczych, aby wykonać zadania hybrydowe i wyświetlić 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 zapisać 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 klawiszy Ctrl+Shift+P —> wybierz pozycję Zmień katalog. Aby zmienić ścieżkę podstawową z ustawień konfiguracji rozszerzenia, wybierz pozycję Zarządzaj ikoną na pasku działań po lewej stronie i przejdź do pozycji Ustawienia > Extensions > Azure Automation > Directory:Base Path.
    • 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 działań po lewej stronie i przejdź do pozycji Ustawienia > Rozszerzenia > usługi Azure Automation > Directory:Struktura folderów. Możesz zmienić domyślne ustawienie konfiguracji z vscodeAutomation/accHash na subscription/resourceGroupe/automationAccount format.

      Uwaga

      Jeśli konto usługi Automation jest zintegrowane z kontrolą źródła, możesz podać ścieżkę folderu elementu Runbook repozytorium GitHub jako ścieżkę katalogu. Na przykład: zmiana katalogu na C:\abc spowoduje zapisanie elementów Runbook 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 elementu Runbook — można uruchamiać lokalną wersję zadań automatyzacji, takich jak uruchamianie zadań automatyzacji, uruchamianie zadania testowego, wyświetlanie danych wyjściowych zadania i uruchamianie lokalnej wersji elementu Runbook programu PowerShell w trybie debugowania, umożliwiając dodawanie punktów przerwania w skrytecie.

    Uwaga

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

  • Praca z harmonogramami, elementami zawartości i elementami webhook — możesz wyświetlić właściwości harmonogramu, harmonogramu usuwania, harmonogramu linków, aby połączyć harmonogram z elementem Runbook.

  • Dodawanie elementu webhook — możesz dodać element webhook do elementu runbook.

  • Aktualizowanie właściwości zasobów — można tworzyć, aktualizować, wyświetlać właściwości zasobów, takie jak Certyfikaty, Połączenie ions, 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.
  • Przekazywanie pakietów modułów (PowerShell i Python) z rozszerzenia.
  • Automatyczna synchronizacja lokalnych elementów Runbook z kontem usługi Azure Automation. Należy wykonać operację pobierania lub publikowania elementu Runbook.
  • Zarządzanie grupami hybrydowych procesów roboczych.
  • Graficzny element Runbook 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