Creazione di runbook tramite VS Code in Automazione di Azure

Questo articolo illustra l'estensione di Visual Studio che è possibile usare per creare e gestire runbook.

Automazione di Azure offre ora una nuova estensione di VS Code per la creazione e la gestione di runbook. Usando questa estensione, è possibile eseguire tutte le operazioni di gestione dei runbook, ad esempio la creazione e la modifica di runbook, l'attivazione di un processo, il rilevamento dell'output dei processi recenti, il collegamento di una pianificazione, la gestione degli asset e il debug locale.

Prerequisiti

• Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.
• Visual Studio Code.
• Per eseguire il runbook in locale, è necessario che i moduli di PowerShell e i pacchetti Python usati dal runbook siano installati localmente.

Sistemi operativi supportati

La matrice di test include i sistemi operativi seguenti:

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

Funzionalità chiave    

• Onboarding semplificato: è possibile accedere usando un account Azure in modo semplice e sicuro.
• Più linguaggi: supporta tutti gli stack di runtime di Automazione, ad esempio i runbook di PowerShell 5, PowerShell 7, Python 2 e Python 3.
• Supportability: supporta l'esecuzione di test del processo, la pubblicazione del processo di Automazione e l'attivazione del processo in ruoli di lavoro di Azure e ibridi. È possibile eseguire i runbook in locale.
• Supporta i parametri posizionali Python e i parametri di PowerShell per attivare il processo.
• Webhook semplificati: è possibile creare un webhook e avviare un processo tramite un webhook in modo più semplice. È inoltre supportato il collegamento di una pianificazione a un runbook.
• Gestione degli asset di Automazione: è possibile eseguire operazioni di creazione, aggiornamento ed eliminazione su asset, tra cui certificati, variabili, credenziali e connessioni.
• Visualizzazione di proprietà: è possibile visualizzare le proprietà e selezionare un gruppo di lavoro ibrido per eseguire processi ibridi, oltre a visualizzare gli ultimi 10 processi eseguiti.
• Debug in locale: è possibile eseguire il debug degli script di PowerShell in locale.
• Confronto tra runbook: è possibile confrontare il runbook locale con la relativa copia pubblicata o in bozza.

Funzionalità principali della versione 1.0.8

• Impostazioni di configurazione della directory locale: è possibile definire la directory di lavoro in cui salvare i runbook in locale.

  • Cambio di directory: percorso di base: usare il percorso di directory cambiato quando si riapre l'IDE di Visual Studio Code. Per cambiare la directory tramite il riquadro comandi, usare CTRL+MAIUSC+P -> selezionare Cambia directory. Per cambiare il percorso di base rispetto alle impostazioni di configurazione dell'estensione, selezionare l'icona Gestisci sulla barra delle attività a sinistra e passare a Impostazioni > Estensioni > Automazione di Azure > Directory:Percorso di base.
  • Cambio di directory: struttura della cartella: è possibile cambiare la struttura della cartella della directory locale da vscodeAutomation/accHash a subscription/resourceGroup/automationAccount. Selezionare l'icona Gestisci sulla barra delle attività a sinistra e passare a Impostazioni > Estensioni > Automazione di Azure > Directory:Struttura della cartella. È possibile cambiare l'impostazione di configurazione predefinita dal formato vscodeAutomation/accHash a subscription/resourceGroupe/automationAccount.

    Nota

    Se l'account di automazione è integrato con il controllo del codice sorgente, è possibile specificare il percorso della cartella dei runbook del repository GitHub come percorso della directory. Ad esempio, passando alla directory C:\abc i runbook verranno memorizzati in C:\abc\vscodeAutomation.. o C:\abc//subscriptionName//resourceGroupName//automationAccountName//runbookname.ps1.

• Operazioni di gestione dei runbook: è possibile creare runbook, recuperare il runbook bozza, recuperare il runbook pubblicato, aprire il runbook locale nell'editor, confrontare il runbook locale con una copia pubblicata o in bozza, caricare come bozza, pubblicare il runbook ed eliminarlo dall'account di Automazione.

• Operazioni di esecuzione dei runbook: è possibile eseguire una versione locale dei processi di Automazione, ad esempio avviare processi di Automazione, avviare il processo di test di Automazione, visualizzare gli output dei processi ed eseguire la versione locale del runbook di PowerShell in modalità di debug, con la possibilità di aggiungere punti di interruzione nello script.

  Nota

  Attualmente è supportato l'uso di cmdlet interni come Get-AutomationVariable solo con asset non crittografati.

• Usare pianificazioni, asset e webhook: è possibile visualizzare le proprietà di una pianificazione, eliminare una pianificazione e collegarla a un runbook.

• Aggiungere un webhook: è possibile aggiungere un webhook al runbook.

• Aggiornare le proprietà degli asset: è possibile creare, aggiornare e visualizzare le proprietà degli asset, ad esempio certificati, connessioni, credenziali e variabili, oltre a eliminare gli asset dall'estensione.

Limiti

Le seguenti funzionalità non sono attualmente supportate:

• Creazione di nuove pianificazioni.
• Aggiunta di nuovi certificati negli asset.
• Caricare i pacchetti di moduli (PowerShell e Python) dall'estensione.
• Sincronizzare automaticamente i runbook locali con l'account di Automazione di Azure. Sarà necessario eseguire l'operazione per recuperare o pubblicare il runbook.
• Gestione dei gruppi di ruoli di lavoro ibridi.
• Runbook e flussi di lavoro grafici.
• Per Python non sono disponibili opzioni di debug. È consigliabile installare qualsiasi estensione di debugger nello script Python.
• Attualmente, sono supportati solo gli asset non crittografati nell'esecuzione locale.

Passaggi successivi

• Per le operazioni di gestione dei runbook e per testare runbook e processi, vedere Usare l'estensione di Automazione di Azure per Visual Studio Code