Tipi di runbook di Automazione di Azure

La funzionalità Automazione dei Processi su Azure supporta diversi tipi di runbook, come definito nella tabella seguente.

Tipo Descrizione
PowerShell
(scelta consigliata)		 Runbook testuale basato su script di Windows PowerShell. Le versioni attualmente supportate sono PowerShell 7.6, PowerShell 7.4 e PowerShell 5.1. Poiché PowerShell 7.1 e PowerShell 7.2 non sono più supportati dal prodotto madre PowerShell, si creano runbook con versioni supportate a lungo termine come PowerShell 7.6 o PowerShell 7.4.
Flusso di lavoro PowerShell Runbook testuale basato sullo scripting del flusso di lavoro di Windows PowerShell.
Pitone
(scelta consigliata)		 Runbook testuale basato sullo scripting Python. La versione attualmente supportata è Python 3.10. Poiché Python 2.7 e Python 3.8 non sono più supportati dal prodotto padre Python, è consigliabile creare runbook in Python 3.10.
Grafico Runbook grafico basato su Windows PowerShell e creato e modificato completamente nell'editor grafico nel portale di Azure.
Grafico del flusso di lavoro di PowerShell Runbook grafico basato su flusso di lavoro Windows PowerShell e creato e modificato completamente nell'editor grafico nel portale di Azure.

Per altre informazioni sull'ambiente di automazione dei processi, consultare Esecuzione di runbook in Automazione di Azure.

Nota

Automazione di Azure seguirà il ciclo di vita del supporto delle versioni del linguaggio PowerShell e Python in base alle sequenze temporali pubblicate rispettivamente dai prodotti padre, PowerShell e Python. È consigliabile usare runbook con versioni delle lingue supportate.

Tenere conto delle considerazioni seguenti per determinare quale tipo usare per un runbook specifico:

  • Non è possibile convertire i runbook dal tipo grafico al tipo testuale e viceversa.
  • Esistono limitazioni di uso dei runbook di tipi diversi come runbook figlio. Per altre informazioni, vedere Runbook figlio in Automazione di Azure.

Manuali operativi di PowerShell

I runbook di PowerShell sono basati su Windows PowerShell. È possibile modificare direttamente il codice del runbook usando l'editor di testo del portale di Azure. È anche possibile usare un editor di testo offline e importare il runbook in Automazione di Azure.

La versione di PowerShell è determinata dalla versione di runtime specificata.

Lo stesso ruolo di lavoro ibrido per runbook e sandbox di Azure può eseguire più runbook di PowerShell destinati a versioni di runtime diverse affiancate. Le versioni runtime di PowerShell 7.6 e PowerShell 7.4 sono supportate sia per lavori cloud che ibridi in tutte le regioni.

Nota

  • Al momento dell'esecuzione del runbook, se si seleziona Versione di runtime come versione 7.4, vengono usati i moduli di PowerShell destinati alla versione di runtime 7.4 e se si seleziona Versione di runtime come versione 5.1, vengono usati i moduli di PowerShell destinati alla versione di runtime 5.1.

Assicurarsi di selezionare la versione del runtime corretta per i moduli.

Ad esempio: se si esegue un runbook per uno scenario di automazione di SharePoint in Runtime versione7.4, importare il modulo in Runtime versione7.4; se si esegue un runbook per uno scenario di automazione di SharePoint in Runtime versione5.1, importare il modulo in Runtime versione5.1.

Vantaggi

  • Implementare tutta la logica complessa con il codice di PowerShell senza le altre complessità del flusso di lavoro di PowerShell.
  • Avvio più rapido rispetto ai runbook del flusso di lavoro PowerShell poiché non è necessaria la compilazione prima dell'esecuzione.
  • Esecuzione in Azure e nei ruoli di lavoro ibridi per runbook sia per Windows che per Linux.

Limitazioni e problemi noti

Di seguito sono riportate le limitazioni correnti e i problemi noti relativi ai runbook di PowerShell:

Limitazioni PowerShell 7.6 è disponibile nell'esperienza di runtime environment.

  • Per la versione runtime di PowerShell 7.6, le attività dei moduli non vengono estratte per i moduli importati.

  • PowerShell 7.x non supporta i flussi di lavoro. Per altre informazioni, vedere Flusso di lavoro di PowerShell.

  • PowerShell 7.x attualmente non supporta i runbook firmati.

  • L'integrazione del controllo del fonte non supporta PowerShell 7.6. Inoltre, i runbook PowerShell 7.6 nel controllo versi vengono creati nell'account Automation come Runtime 5.1.

  • Il modulo AZ 15.1.0 è installato di default. L'elenco completo dei moduli dei componenti della versione del modulo Az selezionata viene visualizzato dopo la configurazione della versione Az usando il portale di Azure o l'API.

  • I moduli PowerShell 7.6 importati vengono validati durante l'esecuzione del lavoro. Assicurarsi che tutte le dipendenze per il modulo selezionato vengano importate anche per la corretta esecuzione del processo.

  • Automazione di Azure manuali non supportano Start-Job con la Credenza -.

  • Azure non supporta tutti i parametri di input di PowerShell. Altre informazioni. Problemi noti

  • I runbook che dipendono da percorsi di file interni, ad esempio C:\modules, potrebbero non riuscire a causa delle modifiche apportate all'infrastruttura back-end del servizio. Modificare il codice del runbook per assicurarsi che non ci siano dipendenze da percorsi di file interni e usare Get-ChildItem per ottenere le informazioni del modulo necessarie.

  • Il cmdlet Get-AzStorageAccount potrebbe non riuscire con un errore: Il comando Get-AzStorageAccount è stato trovato nel modulo Az.Storage, ma non è stato possibile caricare il modulo.

  • L'esecuzione di script figlio tramite .\child-runbook.ps1 non è supportata.
    Soluzione alternativa: usare Start-AutomationRunbook (cmdlet interno) o Start-AzAutomationRunbook (da modulo Az.Automation ) per avviare un altro runbook dal runbook padre.

  • Quando si usa il modulo ExchangeOnlineManagement, versione 3.0.0 o successiva, è possibile riscontrare errori. Per risolvere il problema, assicurarsi di caricare in modo esplicito i moduli PowerShellGet e PackageManagement.

  • Quando si usa il cmdlet New-AzAutomationVariable all'interno di Az.Automation Module per caricare una variabile di tipo oggetto, l'operazione non funziona come previsto. Soluzione alternativa: convertire l'oggetto in una stringa JSON usando il cmdlet ConvertTo-Json e quindi caricare la variabile con la stringa JSON come valore. Questa soluzione alternativa garantisce una corretta gestione della variabile all'interno dell'ambiente di Automazione di Azure come stringa JSON.

    Esempio - Crea un oggetto PowerShell che memorizzi informazioni sulle VM di Azure

    azurepowershell

# Retrieve Azure virtual machines with status information for the 'northeurope' region 
$AzVM = Get-AzVM -Status | Where-Object {$_.Location -eq "northeurope"} 

$VMstopatch = @($AzVM).Id 

# Create an Azure Automation variable (This cmdlet will not fail, but the variable may not work as intended when used in the runbook.) 
New-AzAutomationVariable -ResourceGroupName "mrg" -AutomationAccountName "mAutomationAccount2" -Name "complex1" -Encrypted $false -Value $VMstopatch 

# Convert the object to a JSON string 
$jsonString = $VMstopatch | ConvertTo-Json 

# Create an Azure Automation variable with a JSON string value (works effectively within the automation runbook) 
New-AzAutomationVariable -ResourceGroupName "mrg" -AutomationAccountName "mAutomationAccount2" -Name "complex1" -Encrypted $false -Value $jsonString

Runbook del flusso di lavoro PowerShell

I runbook del flusso di lavoro PowerShell sono runbook di testo basati sul flusso di lavoro Windows PowerShell. È possibile modificare direttamente il codice del runbook usando l'editor di testo del portale di Azure. È anche possibile usare un editor di testo offline e importare il runbook in Automazione di Azure.

Nota

PowerShell 7.1 (anteprima) e PowerShell 7.2 non supportano i runbook del flusso di lavoro.

Vantaggi

  • Implementazione di tutta la logica complessa con codice del flusso di lavoro PowerShell.
  • Uso dei checkpoint per riprendere l'operazione in caso di errore.
  • Uso dell'elaborazione parallela per eseguire più azioni in parallelo.
  • Può includere altri runbook grafici e runbook di flusso di lavoro di PowerShell come runbook figli per creare flussi di lavoro di livello elevato.

Limiti

  • Il flusso di lavoro di PowerShell non è supportato nelle versioni di PowerShell 7 e successive. Di conseguenza, i runbook obsoleti non possono essere aggiornati.
  • Gestione inefficiente dell'esecuzione parallela rispetto alle versioni più recenti di PowerShell 7+.
  • Il flusso di lavoro di PowerShell funziona internamente usando più processi. Di conseguenza, i moduli disponibili in un processo potrebbero non essere disponibili in un altro processo e causare eccezioni come comando non trovato.
  • I runbook devono gestire la complessità aggiuntiva derivante dal flusso di lavoro PowerShell, come gli oggetti deserializzati.
  • I runbook richiedono più tempo per l'avvio rispetto ai runbook di PowerShell poiché devono essere compilati prima dell'esecuzione.
  • È possibile includere solo runbook di PowerShell come runbook figlio usando il cmdlet Start-AzAutomationRunbook.
  • I runbook non possono essere eseguiti in un ruolo di lavoro ibrido per runbook Linux.

Runbook Python

I runbook Python vengono compilati in Python 3.10. È possibile modificare direttamente il codice del runbook usando l'editor di testo del portale di Azure. È anche possibile usare un editor di testo offline e importare il runbook in Automazione di Azure. Python 2.7 e Python 3.8 non sono più supportati dal prodotto padre ed è consigliabile creare runbook nella versione di runtime di Python 3.10.

La versione runtime Python 3.10 è supportata sia per lavori cloud che ibridi in tutte le regioni.

Vantaggi

Nota

L'importazione di un pacchetto Python può richiedere qualche minuto.

  • Usa le librerie Python affidabili.
  • Può essere eseguito in Azure o in ruoli di lavoro ibridi per runbook.
  • Gli script e i pacchetti di qualsiasi versione 3.x potrebbero funzionare se il codice è compatibile tra versioni diverse.
  • Per i processi ibridi python 3.10 nei computer Windows, è possibile scegliere di installare qualsiasi versione 3.x che si vuole usare.
  • Per i processi ibridi Python 3.10 su macchine Linux, noi dipendiamo dalla versione di Python 3 installata sulla macchina per eseguire DSC OMSConfig e il Linux Hybrid Worker. Versioni diverse dovrebbero funzionare se non sono presenti modifiche di rilievo nelle firme dei metodi o nei contratti tra le versioni di Python 3.

Limiti

Le limitazioni dei runbook Python sono:

  • Per i moduli Python 3.10, attualmente sono supportati solo i file wheel destinati al sistema operativo Linux cp310. Ulteriori informazioni
  • L'integrazione del controllo del codice sorgente non è supportata.
  • I pacchetti personalizzati per Python 3.10 vengono convalidati solo durante il runtime del processo. Il processo dovrebbe non riuscire se il pacchetto non è compatibile nel runtime o se le dipendenze necessarie dei pacchetti non vengono importate nell'account di automazione.
  • Attualmente, i runbook Python 3.10 sono supportati solo dal portale di Azure e dall'API REST.

Nota

L'uso di un webhook per avviare un runbook Python non è supportato.

Più versioni di Python

È applicabile ai lavoratori ibridi di Windows. Per un ruolo di lavoro runbook di Windows, quando si esegue un runbook Python 2, questo cerca prima la variabile di ambiente PYTHON_2_PATH e verifica se punta a un file eseguibile valido. Ad esempio, se la cartella di installazione è C:\Python2, verifica se C:\Python2\python.exe è un percorso valido. Se non viene trovato, cerca la variabile di ambiente PATH per eseguire un controllo simile.

Per Python 3, cerca prima la variabile di PYTHON_3_PATH env e quindi esegue il fallback alla variabile di ambiente PATH.

Quando si usa una sola versione di Python, è possibile aggiungere il percorso di installazione alla variabile PATH. Se si desidera utilizzare entrambe le versioni sul Runbook Worker, impostare PYTHON_2_PATH e PYTHON_3_PATH sulla posizione del modulo per quelle versioni.

Problemi noti

Per i processi cloud, i processi Python 3.8 talvolta hanno esito negativo con un messaggio di eccezione invalid interpreter executable path. È possibile che venga visualizzata questa eccezione se il processo viene ritardato, a partire da più di 10 minuti o se si usa Start-AutomationRunbook per avviare runbook Python 3.8. Se il processo è ritardato, il riavvio del runbook dovrebbe essere sufficiente.

Runbook grafici

È possibile creare e modificare runbook grafici e flussi di lavoro di PowerShell usando l'editor grafico nel portale di Azure. Tuttavia, non è possibile creare o modificare questo tipo di runbook con un altro strumento. Funzionalità principali dei runbook grafici:

  • Vengono esportati come file nel tuo account di Automazione e poi importati in un altro account di Automazione.
  • Genera codice PowerShell.
  • Sono convertiti in runbook grafici del flusso di lavoro di PowerShell durante l'importazione.

Vantaggi

  • Uso di un modello di creazione con inserimento, collegamento e configurazione visivi.
  • Concentrarsi su come i dati fluiscono attraverso il processo.
  • Rappresentazione grafica dei processi di gestione.
  • Inclusione di altri runbook come runbook figlio per creare flussi di lavoro di livello elevato.
  • Agevolazione della programmazione modulare.

Limiti

  • Non è possibile creare o modificare all'esterno del portale di Azure.
  • Potrebbe richiedere un'attività di codice contenente il codice di PowerShell per eseguire una logica complessa.
  • Non è possibile eseguire la conversione in uno dei formati di testo, né convertire un runbook testuale in un formato grafico.
  • Non è possibile visualizzare o modificare direttamente il codice di PowerShell creato dal flusso di lavoro grafico. È possibile visualizzare il codice creato in qualsiasi attività di codice.
  • Non è possibile eseguire runbook in un ruolo di lavoro ibrido per runbook Linux. Consulta Gestisci le risorse nel tuo datacenter o cloud usando Hybrid Runbook Worker.
  • I runbook grafici non possono essere firmati digitalmente.

Passaggi successivi

  • Last updated on