Automatizzare l'installazione del runtime di integrazione self-hosted con gli script PowerShell locali

Articolo
05/15/2024

Per automatizzare l'installazione del runtime di integrazione self-hosted in computer locali (diversi dalle macchine virtuali di Azure in cui è possibile usare il modello di Resource Manager), è possibile usare script PowerShell locali. Questo articolo illustra due script che è possibile usare.

Prerequisiti

Avviare PowerShell nel computer locale. Per eseguire gli script, è necessario scegliere Esegui come amministratore.
Scaricare il software del runtime di integrazione self-hosted. Copiare il percorso in cui si trova il file scaricato.
Per registrare il runtime di integrazione self-hosted, è necessaria anche una chiave di autenticazione.
Per automatizzare gli aggiornamenti manuali, è necessario avere un runtime di integrazione self-hosted preconfigurato.

Introduzione agli script

Nota

Questi script vengono creati con l'utilità della riga di comando documentata nel runtime di integrazione self-hosted. Se necessario, è possibile personalizzare questi script in base a specifiche esigenze di automazione. Gli script devono essere applicati per singolo nodo, quindi assicurarsi di eseguirli in tutti i nodi in caso di configurazione a disponibilità elevata (due o più nodi).

Per l'installazione automatica: installare e registrare un nuovo nodo di runtime di integrazione self-hosted usando InstallGatewayOnLocalMachine.ps1 : lo script può essere usato per installare il nodo runtime di integrazione self-hosted e registrarlo con una chiave di autenticazione. Lo script accetta due argomenti. Il primo consente di specificare il percorso del runtime di integrazione self-hosted in un disco locale, mentre il secondo consente di specificare la chiave di autenticazione per la registrazione del nodo del runtime di integrazione self-hosted.
Per automatizzare gli aggiornamenti manuali: Aggiornare il nodo del runtime di integrazione self-hosted con una versione specifica o alla versione più recente di script-update-gateway. ps1 : questo aggiornamento è supportato anche nel caso in cui sia stato disattivato l'aggiornamento automatico o si voglia avere maggiore controllo sugli aggiornamenti. È possibile usare lo script per aggiornare il nodo del runtime di integrazione self-hosted alla versione più recente o a una versione successiva specificata (il downgrade non funziona). Accetta un argomento per specificare il numero di versione, ad esempio -version 3.13.6942.1. Se non viene specificata alcuna versione, il runtime di integrazione self-hosted viene sempre aggiornato alla versione più recente disponibile nei download.

Nota

È possibile specificare solo le ultime tre versioni. Normalmente si usa per aggiornare un nodo esistente alla versione più recente. PRESUPPONE LA PRESENZA DI UN RUNTIME DI INTEGRAZIONE SELF-HOST REGISTRATO.

Esempi di utilizzo

Per automatizzare l'installazione

Scaricare il runtime di integrazione self-hosted.
Specificare il percorso in cui si trova il file MSI SHIR scaricato (file di installazione). Ad esempio, se il percorso è C:\Users\username\Downloads\IntegrationRuntime_4.7.7368.1.msi, è possibile usare l'esempio della riga di comando di PowerShell seguente per questa attività:
```
PS C:\windows\system32> C:\Users\username\Desktop\InstallGatewayOnLocalMachine.ps1 -path "C:\Users\username\Downloads\IntegrationRuntime_4.7.7368.1.msi" -authKey "[key]"
```
Nota

Sostituire [key] con la chiave di autenticazione per registrare il runtime di integrazione. Sostituire "username" con il proprio nome utente. Specificare il percorso del file "InstallGatewayOnLocalMachine.ps1" durante l'esecuzione dello script. In questo esempio è stato archiviato sul desktop.
Se nel computer è presente un solo runtime di integrazione self-hosted preinstallato, lo script lo disinstalla automaticamente e ne configura uno nuovo. Verrà visualizzata la finestra seguente visualizzata:
Al termine dell'installazione e della registrazione della chiave, nell'istanza locale di PowerShell verranno visualizzati i messaggi Succeed to install gateway (Installazione del gateway riuscita) e Succeed to register gateway (Registrazione del gateway riuscita).

Per automatizzare gli aggiornamenti manuali

Questo script viene usato per aggiornare/installare e registrare la versione più recente del runtime di integrazione self-hosted. Lo script esegue automaticamente i passaggi seguenti:

Verifica la versione corrente del runtime di integrazione self-hosted
Ottiene la versione più recente o la versione specificata dall'argomento
Se è presente una versione più recente rispetto a quella versione corrente:
- scarica il file MSI del runtime di integrazione self-hosted
- lo aggiorna

Per usare questo script, è possibile seguire questa riga di comando di esempio:

Scaricare e installare il gateway più recente:

PS C:\windows\system32> C:\Users\username\Desktop\script-update-gateway.ps1

Scaricare e installare il gateway della versione specificata:
```
PS C:\windows\system32> C:\Users\username\Desktop\script-update-gateway.ps1 -version 3.13.6942.1
```
Se la versione corrente è già quella più recente, verrà visualizzato il risultato seguente, per indicare che non è richiesto alcun aggiornamento. [

Condividi tramite