Share via

Configurare un cluster Linux Service Fabric tramite WSL2 nel computer sviluppatore Windows

  • Articolo

Questo documento illustra come configurare un cluster Linux Service Fabric locale tramite WSL2 in un computer di sviluppo Windows. La configurazione di un cluster Linux è utile per testare rapidamente le applicazioni di destinazione per i cluster Linux che sono però sviluppate su un computer Windows.

Prerequisiti

I cluster di Service Fabric basati su Linux non vengono eseguiti direttamente in Windows, ma per abilitare la prototipazione multipiattaforma sono stati forniti un modo per distribuire cluster di Service Fabric all'interno della distribuzione Linux tramite WSL2 (sottosistema Windows per Linux) per Windows.

Prima di iniziare, sono necessari:

  • Configurare WSL2 in Windows e assicurarsi che WSL 2 sia come versione predefinita
  • Configurare La distribuzione Linux di Ubuntu 18.04 da Microsoft Store durante la configurazione di WSL2

Suggerimento

Per installare WSL2 nel computer Windows, seguire la procedura descritta nella documentazione di WSL. Dopo l'installazione, verificare l'installazione di Ubuntu-18.04, renderla la distribuzione predefinita ed essere in esecuzione.

Configurare Service Fabric SDK all'interno della distribuzione Linux

Impossibile eseguire l'installazione di Service Fabric nella distribuzione Linux WSL2 nel modo in cui viene eseguita nel sistema operativo Linux standard. Poiché il sistema come PID1 non è in esecuzione all'interno della macchina virtuale e systemd come PID1 è un prerequisito per il corretto funzionamento di SF SDK. Per abilitare il sistema come PID1, systemd-genie viene usato come lavoro. Altre informazioni dettagliate su systemd-genie sono disponibili in systemd genie setup Script installazione e passaggi di installazione manuale illustrano l'installazione di systemd-genie e service fabric SDK entrambi.

Installazione con script

Per praticità, viene fornito uno script per installare l'SDK comune di Service Fabric insieme all'interfaccia della riga di comando sfctl. L'esecuzione dello script presuppone l'accettazione delle licenze di tutto il software installato. In alternativa, è possibile eseguire i passaggi di installazione manuale nella sezione successiva, che presenteranno licenze associate e i componenti installati.

Al termine dell'esecuzione dello script, è possibile passare a Configurare un cluster locale.

sudo curl -s https://raw.githubusercontent.com/Azure/service-fabric-scripts-and-templates/master/scripts/SetupServiceFabric/SetupServiceFabric.sh | sudo bash

Installazione manuale

Per l'installazione manuale del runtime e dell'SDK comune di Service Fabric, seguire il resto di questa guida.

  1. Aprire un terminale.

  2. Accedere alla distribuzione Linux WSL2

  3. Configurare systemd-genie come indicato nell'installazione di systemd genie (se systemd-genie è già configurato, è possibile passare al passaggio successivo)

  4. Immettere nello spazio dei nomi genie usando genie -s

  5. All'interno dello spazio dei nomi genie, SF SDK può anche essere installato come indicato in Installazione script o passaggi di installazione manuale in Configurare un cluster locale linux

  6. Fornire privilegi sudo all'utente corrente eseguendo una voce <USERNAME\> ALL = (ALL) NOPASSWD:ALL in /etc/sudoers

Configurare un cluster locale

Service Fabric all'interno della macchina virtuale WSL2 è consigliabile gestire dalle finestre host

  1. Installare Service Fabric SDK (versione 6.0 o successiva) nell'host Windows

  2. In Windows il cluster può essere gestito usando lo strumento ServiceFabricLocalClusterManager fornito come parte di SF SDK

  3. L'opzione per gestire il cluster locale Linux è abilitata solo quando un. La macchina virtuale WSL2 è in esecuzione, b. I pacchetti Systemd-genie, servicefabricruntime e servicefabricsdkcommon vengono installati correttamente all'interno della macchina virtuale e c. Systemd-genie è in esecuzione. È possibile configurare o passare a Cluster locale Linux da questo strumento.

  4. Un altro modo per configurare il cluster Linux consiste nel distribuire usando gli script di installazione del cluster forniti come parte di SF SDK.

  5. Aprire un Web browser e passare a Service Fabric Explorer http://localhost:19080. All'avvio del cluster viene visualizzato il dashboard di Service Fabric Explorer. Potrebbero essere necessari diversi minuti per la configurazione del cluster. Se il browser non riesce ad aprire l'URL o Service Fabric Explorer non mostra il cluster, attendere alcuni minuti e riprovare. È anche possibile visualizzare il cluster in ServiceFabricExplorer fornito in SF SDK.

  6. Una volta eseguito il cluster, è possibile connettersi al cluster locale in PowerShell e Visual Studio.

Installazione manuale con ServiceFabric personalizzato e ServieFabricSdkCommon Debian Package

Per l'installazione manuale di Service Fabric da pacchetti debian personalizzati o scaricati, seguire la parte restante di questa guida.

  1. Aprire un terminale.

  2. Accedere alla distribuzione Linux WSL2

  3. Clonare il file configurato

sudo curl -s https://raw.githubusercontent.com/Azure/service-fabric-scripts-and-templates/master/scripts/SetupServiceFabric/SetupServiceFabric.sh > SetupServiceFabric.sh
  1. Creare il file eseguibile
sudo chmod +x SetupServiceFabric.sh
  1. Eseguire lo script di configurazione con il percorso dei pacchetti Debian locali. Assicurarsi che i percorsi forniti siano validi. Di seguito è riportato un esempio:
sudo ./SetupServiceFabric.sh --servicefabricruntime=/mnt/c/Users/testuser/Downloads/servicefabric.deb --servicefabricsdk=/mnt/c/Users/testuser/Downloads/servicefabric_sdkcommon.deb

Limitazioni note

Di seguito sono riportate le limitazioni note del cluster locale in esecuzione all'interno della distribuzione Linux:

  • Attualmente la distribuzione ubuntu-18.04 è supportata solo.
  • Per avere un'esperienza semplice con Gestione cluster locale e Visual Studio, è consigliabile gestire il cluster da script di PowerShell o LocalClusterManager nell'host Windows.

Domande frequenti

  1. Quali distribuzioni linux sono supportate per la configurazione del cluster locale SF?
    Attualmente, solo Ubuntu-18.04 è supportato per il cluster locale linux.

  2. Il cluster Windows e Linux SF possono essere eseguiti in parallelo con l'installazione di WSL2?
    No, alla volta è possibile eseguire un solo cluster locale nell'host o nella macchina virtuale guest.

  3. Come distribuire un cluster locale linux di un nodo?
    È possibile distribuire un nodo o cinque cluster locali linux da Gestione cluster locale dalle opzioni di menu. Durante la distribuzione dallo script di installazione, il cluster di cinque nodi viene distribuito per impostazione predefinita e per un cluster di nodo CreateOneNodeCluster deve essere passato.

  4. Come connettersi al cluster locale Linux in PowerShell e Visual Studio?
    Se il cluster locale linux è attivo ed in esecuzione, il cmdlet connect-servicefabriccluster deve connettersi automaticamente a questo cluster. Visual Studio simile rileverà automaticamente questo cluster locale. Questo cluster può anche essere connesso fornendo l'endpoint del cluster in PowerShell o in Visual Studio.

  5. Dove si trovano i dati del cluster SF per il cluster locale linux?
    Se si usa la distribuzione Ubuntu-18.04, i dati SF si trovano in \wsl$\Ubuntu-18.04\home\sfuser\sfdevcluster dall'host Windows.

Passaggi successivi