Gestire l'ambiente di runtime e i runbook associati

1. Accedere al portale di Azure e selezionare l'account di Automazione.

2. In Automazione processi selezionare Ambienti di runtime (anteprima) e quindi selezionare Crea.

3. In Informazioni di basespecificare i dettagli seguenti:

   1. Nome per l'ambiente di runtime. Deve iniziare con alfabeto e può contenere solo alfabeti, numeri, caratteri di sottolineatura e trattini.

   2. Nell'elenco a discesa Linguaggio selezionare il linguaggio di scripting per l'ambiente di runtime.

      • Scegliere PowerShell per il linguaggio di scripting di PowerShell o Python per il linguaggio di scripting Python.

   3. Selezionare versione runtime per il linguaggio di scripting.

      • Per PowerShell: scegliere 5.1, 7.2
      • Per Python: scegliere 3.8, 3.10 (anteprima)

   4. Specificare la descrizione appropriata.

      

4. Selezionare Avanti e nella scheda Pacchetti caricare i pacchetti necessari durante l'esecuzione del runbook. Il pacchetto Az PowerShell viene caricato per impostazione predefinita per tutti gli ambienti di runtime di PowerShell, che include tutti i cmdlet per la gestione delle risorse di Azure. È possibile scegliere la versione del pacchetto Az dall'elenco a discesa. Selezionare Nessuna se non si vuole caricare il pacchetto durante l'esecuzione del runbook.

   

   Nota

   I comandi dell'interfaccia della riga di comando di Azure sono supportati (anteprima) nei runbook associati all'ambiente di runtime di PowerShell 7.2. I comandi dell'interfaccia della riga di comando di Azure versione 2.56.0 sono disponibili come pacchetto predefinito nell'ambiente di runtime di PowerShell 7.2.

5. Per caricare altri pacchetti necessari durante l'esecuzione del runbook. Selezionare Aggiungi un file per aggiungere i file archiviati localmente nel computer o selezionare Aggiungi dalla raccolta per caricare pacchetti da PowerShell Gallery.

   

   Nota

   • Quando si importa un pacchetto, potrebbero essere necessari alcuni minuti. 100 MB è la dimensione totale massima dei file che è possibile importare.
   • Usare file .zip per i tipi di runbook di PowerShell, come indicato qui
   • Per i pacchetti Python 3.8, usare i file .whl destinati a cp38-amd64.
   • Per i pacchetti Python 3.10 (anteprima), usare i file con estensione whl destinati al sistema operativo Linux cp310.

6. Selezionare Avanti e, nella scheda Rivedi e crea, verificare che le impostazioni siano corrette. Quando si seleziona Crea, Azure esegue la convalida nelle impostazioni dell'ambiente di runtime scelte. Se la convalida viene superata, è possibile procedere con la creazione di un ambiente di runtime, il portale indica le impostazioni che è necessario modificare.

Nella pagina Ambienti di runtime (anteprima) è possibile visualizzare l'ambiente di runtime appena creato per l'account di Automazione. Se non si trovano gli ambienti di runtime appena creati nell'elenco, selezionare Aggiorna.

È possibile creare un nuovo ambiente di runtime per PowerShell 7.2 con il modulo Az PowerShell in Automazione

PUT 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments/<runtimeEnvironmentName>?api-version=2023-05-15-preview 

{ 
  "properties": { 
    "runtime": { 
        "language": "PowerShell",  
        "version": "7.2" 
        }, 
        "defaultPackages": { 
            "Az": "7.3.0" 
        } 
     }, 
    "name": "<runtimeEnvironmentName>" 
} 

Caricare un pacchetto Az.Accounts nell'ambiente di runtime.

PUT 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments/<runtimeEnvironmentName>/packages/Az.Accounts?api-version=2023-05-15-preview 
{ 
  "properties": { 
    "contentLink": { 
        "uri": "https://psg-prod-eastus.azureedge.net/packages/az.accounts.2.12.4.nupkg" 
    } 
  } 
} 

1. Nell'account di Automazione, in Automazione processi selezionare Ambienti di runtime (anteprima).

   

GET 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments?api-version=2023-05-15-preview 

1. Nell'account di Automazione, in Automazione processi selezionare Ambienti di runtime (anteprima).

2. Selezionare l'ambiente di runtime da eliminare.

3. Selezionare Elimina per eliminare l'ambiente di runtime.

   

DELETE  
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments/<runtimeEnvironmentName>?api-version=2023-05-15-preview 

1. Nell'account di Automazione, in Automazione processi selezionare Ambienti di runtime (anteprima).

2. Selezionare l'ambiente di runtime da aggiornare.

3. Selezionare la versione dall'elenco a discesa per aggiornare la versione dei pacchetti esistenti.

4. Seleziona Salva.

   

5. Selezionare Aggiungi un file per caricare pacchetti dal computer locale o Aggiungi dalla raccolta per caricare pacchetti da PowerShell Gallery.

   

   Nota

   È possibile aggiungere fino a 10 pacchetti alla volta nell'ambiente di runtime. Assicurarsi di Salvare dopo aver aggiunto 10 pacchetti.

Aggiornare la versione del modulo Az di un ambiente di runtime esistente:

PATCH 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments/<runtimeEnvironmentName>?api-version=2023-05-15-preview 
{ 

  "properties": { 

        "defaultPackages": { 

            "Az": "9.0.0" 

        } 

     } 

} 

Prerequisito

• Assicurarsi di aver creato un ambiente di runtime prima di creare un runbook.

Per creare un nuovo runbook collegato all'ambiente di runtime, seguire questa procedura:

1. Nell'account di Automazione, in Automazione processo selezionare Runbook.

2. Seleziona Crea.

3. Nella scheda Informazioni di base è possibile creare un nuovo runbook o caricare un file dal computer locale o dalla raccolta di PowerShell.

   1. Specificare un nome per il runbook. Deve iniziare con una lettera e può contenere solo lettere, numeri, caratteri di sottolineatura e trattini.

   2. Nell'elenco a discesa tipo runbook selezionare il tipo di runbook che si vuole creare.

   3. Selezionare ambiente di runtime da configurare per il runbook. È possibile Selezionare da ambienti di runtime di esistenti oppure Creare nuovo ambiente di runtime e collegarlo al runbook. L'elenco degli ambienti di runtime viene popolato in base al tipo di runbook selezionato nel passaggio b.

   4. Specificare la descrizione appropriata.

      

   Nota

   Per tipo di runbook di PowerShell, per la selezione verrà elencato solo l'ambiente di runtime di PowerShell. Per tipo di runbook Python, per la selezione verranno elencati solo gli ambienti di runtime Python.

4. Aggiungere tag al runbook, esaminare le impostazioni e selezionare Crea per creare un nuovo runbook.

Questo runbook è collegato all'ambiente di runtime selezionato. Tutti i pacchetti nell'ambiente di runtime scelto saranno disponibili durante l'esecuzione del runbook.

Prerequisito

• Configurare un ambiente di runtime di PowerShell e specificarlo come input per la creazione di runbook.

PUT 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runbooks/<runbookName>?api-version=2023-05-15-preview 

{ 
  "properties": { 
        "runbookType": "PowerShell", 
        "runtimeEnvironment": <runtimeEnvironmentName>, 
        "publishContentLink": { 
            "uri": "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-automation-runbook-getvms/Runbooks/Get-AzureVMTutorial.ps1" 
        } 
    }, 
   "location": "East US"
} 

1. Nell'account di Automazione, in Automazione processo selezionare Runbook.

2. Selezionare la casella di controllo per i runbook da aggiornare.

3. Selezionare Aggiorna.

4. Selezionare l'ambiente di runtime dall'elenco a discesa a cui collegare i runbook.

5. Selezionare Aggiorna per aggiornare i runbook selezionati con il nuovo ambiente di runtime.

Controllare se il runbook viene eseguito come previsto dopo l'aggiornamento. Se il runbook non riesce a fornire il risultato previsto, è possibile aggiornare nuovamente l'ambiente di runtime all'esperienza precedente seguendo i passaggi da 1 a 4.

Aggiornare l'ambiente di runtime collegato a un runbook.

PATCH 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runbooks/<runbookName>?api-version=2023-05-15-preview 
{ 
  "properties": { 
    "type": "PowerShell" 
    "runtimeEnvironment": "<runtimeEnvironmentName>" 
  } 
} 

È possibile aggiornare i runbook modificando l'ambiente di runtime collegato a tale runbook. È consigliabile testare l'esecuzione del runbook prima di pubblicare le modifiche. È necessario assicurarsi che il runbook funzioni come previsto.

Per testare l'esecuzione del runbook prima di pubblicare le modifiche all'ambiente di runtime, seguire questa procedura:

1. Passare alla pagina Runbook e selezionare il runbook per cui si vuole aggiornare l'ambiente di runtime.

   

2. Nella pagina Modifica runbook selezionare Modifica nel portale per aprire l'editor di testo.

3. Il campo Ambiente di runtime mostra la configurazione esistente. Selezionare il nuovo ambiente di runtime dall'elenco a discesa.

   

4. Selezionare il riquadro Test per testare l'esecuzione del runbook con l'ambiente di runtime aggiornato. Selezionare Avvia per avviare l'esecuzione del test.

5. Chiudere il riquadro di test e apportare le modifiche necessarie nel codice runbook o nell'ambiente di runtime, se necessario.

6. Selezionare Pubblica per aggiornare l'ambiente di runtime collegato al runbook.

7. Selezionare Sì per eseguire l'override della versione pubblicata in precedenza e confermare le modifiche.

Eseguire un processo di test per un runbook con un ambiente di runtime diverso. Questo scenario è utile quando è necessario testare un runbook con un ambiente di runtime prima dell'aggiornamento.

PUT 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runbooks/<runbookName>/draft/testJob?api-version=2023-05-15-preview 
{ 
  "properties": { 
    "runtimeEnvironment": "<runtimeEnvironmentName>" 
    "runOn": "" 
  } 
} 

Attualmente, i runbook collegati all'ambiente di runtime vengono eseguiti in Azure.

I processi ereditano l'ambiente di runtime dal runbook. Eseguire un processo cloud per un runbook pubblicato:

PUT 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/jobs/<jobName>?api-version=2023-05-15-preview 
{ 
  "properties": { 
    "runbook": { 
      "name": "<runbookName>" 
    }, 
    "runOn": "" 
  } 
}