Share via

Runbookcreatie via VS Code in Azure Automation

  • Artikel

In dit artikel wordt uitgelegd wat de Visual Studio-extensie is die u kunt gebruiken om runbooks te maken en te beheren.

Azure Automation biedt een nieuwe extensie van VS Code voor het maken en beheren van runbooks. Met deze extensie kunt u alle runbookbeheerbewerkingen uitvoeren, zoals runbooks maken en bewerken, een taak activeren, recente taken bijhouden, een planning, assetbeheer en lokale foutopsporing koppelen.

Vereisten

  • Een Azure-account met een actief abonnement. Gratis een account maken
  • Visual Studio Code.
  • PowerShell-modules en Python-pakketten die door runbook worden gebruikt, moeten lokaal op de computer zijn geïnstalleerd om het runbook lokaal uit te voeren.

Ondersteunde besturingssystemen

De testmatrix bevat de volgende besturingssystemen:

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

Notitie

  • De extensie moet overal in VS Code werken en ondersteunt PowerShell 7.2 of hoger. Voor Windows PowerShell wordt alleen versie 5.1 ondersteund.
  • PowerShell Core 6 is het einde van de levensduur en wordt niet ondersteund.

Belangrijke functies

  • Vereenvoudigde onboarding : u kunt zich aanmelden met een Azure-account op een eenvoudige en veilige manier.
  • Meerdere talen : ondersteunt alle Automation Runtime-stacks, zoals PowerShell 5, PowerShell 7, Python 2 en Python 3-runbooks.
  • Ondersteuning: ondersteunt de testuitvoering van taken, het publiceren van Automation-taken en het activeren van een taak in Azure en Hybrid Workers. U kunt runbooks lokaal uitvoeren.
  • Ondersteunt positionele Python-parameters en PowerShell-parameters om een taak te activeren.
  • Webhooks vereenvoudigd : u kunt een webhook maken, een taak starten via een webhook op een eenvoudigere manier. Ondersteuning voor het koppelen van een planning aan een Runbook.
  • Automation-assets beheren: u kunt bewerkingen voor maken, bijwerken en verwijderen uitvoeren op assets, waaronder certificaten, variabelen, referenties en verbindingen.
  • Eigenschappen weergeven: u kunt de eigenschappen bekijken en de Hybrid Worker-groep selecteren om hybride taken uit te voeren en de recente laatste tien uitgevoerde taken weer te geven.
  • Lokaal fouten opsporen : u kunt lokaal fouten opsporen in de PowerShell-scripts.
  • Runbookvergelijking : u kunt het lokale runbook vergelijken met het gepubliceerde runbook of de kopie van het conceptrunbook.

Belangrijke functies van v1.0.8

  • Configuratie-instellingen voor lokale adreslijst: u kunt de werkmap definiëren die u lokaal wilt opslaan.

    • Map wijzigen: basispad : u gebruikt het gewijzigde mappad wanneer u Visual Studio Code IDE opnieuw opent. Als u de map wilt wijzigen met behulp van het opdrachtpalet, gebruikt u Ctrl+Shift+P-> selecteer Map wijzigen. Als u het basispad van de configuratie-instellingen voor extensies wilt wijzigen, selecteert u het pictogram Beheren in de activiteitenbalk aan de linkerkant en gaat u naar Instellingen > Extensies > Azure Automation > Directory:Base Path.
    • Mapstructuur wijzigen- U kunt de lokale mapstructuur wijzigen van vscodeAutomation/accHash in subscription/resourceGroup/automationAccount. Selecteer het pictogram Beheren in de activiteitenbalk aan de linkerkant en ga naar Instellingen > Extensies > Azure Automation > Directory: Mapstructuur. U kunt de standaardconfiguratie-instelling wijzigen van vscodeAutomation/accHash in subscription/resourceGroupe/automationAccount-indeling .

      Notitie

      Als uw Automation-account is geïntegreerd met broncodebeheer, kunt u het pad naar de runbookmap van uw GitHub-opslagplaats opgeven als het mappad. Bijvoorbeeld: als u map wijzigt in C:\abc , worden runbooks opgeslagen in C:\abc\vscodeAutomation.. of C:\abc//subscriptionName//resourceGroupName//automationAccountName//runbookname.ps1.

  • Runbookbeheerbewerkingen : u kunt runbook maken, conceptrunbook ophalen, gepubliceerd runbook ophalen, lokaal runbook openen in de editor, lokaal runbook vergelijken met een gepubliceerd of concept runbook kopiëren, uploaden als concept, runbook publiceren en runbook verwijderen uit uw Automation-account.

  • Runbookuitvoeringsbewerkingen : u kunt een lokale versie van Automation-taken uitvoeren, zoals Automation-taken starten, Automation-testtaak starten, taakuitvoer weergeven en lokale versie van het PowerShell-runbook uitvoeren in de foutopsporingsmodus door u in staat te stellen onderbrekingspunten toe te voegen in het script.

    Notitie

    Momenteel ondersteunen we het gebruik van interne cmdlets, zoals Get-AutomationVariable alleen met niet-versleutelde assets.

  • Werken met schema's, assets en webhooks : u kunt de eigenschappen van een planning bekijken, schema verwijderen, schema koppelen om een planning te koppelen aan een runbook.

  • Webhook toevoegen : u kunt een webhook toevoegen aan het runbook.

  • Eigenschappen van assets bijwerken: u kunt eigenschappen van assets maken, bijwerken, weergeven, zoals certificaten, Verbinding maken ions, referenties, variabelen en het verwijderen van assets uit de extensie.

Beperkingen

Momenteel worden de volgende functies niet ondersteund:

  • Nieuwe planningen maken.
  • Nieuwe certificaten toevoegen in assets.
  • Modules (PowerShell en Python) uploaden vanuit de extensie.
  • Automatisch synchroniseren van lokale runbooks naar een Azure Automation-account. U moet de bewerking uitvoeren om runbook ophalen of publiceren uit te voeren.
  • Beheer van Hybrid Worker-groepen.
  • Grafisch runbook en werkstromen.
  • Voor Python bieden we geen opties voor foutopsporing. U wordt aangeraden een extensie voor foutopsporingsprogramma's te installeren in uw Python-script.
  • Momenteel ondersteunen we alleen de niet-versleutelde assets in lokale uitvoering.

Volgende stappen

  • Zie De Azure Automation-extensie voor Visual Studio Code gebruiken voor runbookbeheerbewerkingen en om runbook- en taken te testen