Delen via

Een Linux Service Fabric-cluster instellen via WSL2 op uw Windows-ontwikkelcomputer

  • Artikel

In dit document wordt beschreven hoe u een lokaal Linux Service Fabric-cluster instelt via WSL2 op een Windows-ontwikkelcomputer. Het instellen van een lokaal Linux-cluster is handig om snel toepassingen te testen die zijn gericht op Linux-clusters, maar zijn ontwikkeld op een Windows-computer.

Vereisten

Service Fabric-clusters op basis van Linux worden niet rechtstreeks op Windows uitgevoerd, maar om platformoverschrijdende prototypen mogelijk te maken, hebben we een manier geboden om Service Fabric-cluster te implementeren in Linux-distributie via WSL2 (Windows-subsysteem voor Linux) voor Windows.

Voordat u aan de slag gaat, hebt u het volgende nodig:

  • WSL2 instellen in Windows en ervoor zorgen dat WSL 2 als standaardversie wordt gebruikt
  • Ubuntu 18.04 Linux-distributie vanuit de Microsoft Store instellen tijdens het instellen van WSL2

Tip

Volg de stappen in de WSL-documentatie om WSL2 op uw Windows-computer te installeren. Zorg er na de installatie van Ubuntu-18.04 voor dat deze uw standaarddistributie is en moet actief zijn.

Service Fabric SDK instellen in Linux-distributie

Service Fabric Setup kan niet worden uitgevoerd in WSL2 Linux Distribution zoals dit wordt gedaan in het standaard Linux-besturingssysteem. Omdat systemd as PID1 niet wordt uitgevoerd binnen de VM en als PID1 is een vereiste voor SF SDK om succesvol te werken. Om systeem als PID1 in te schakelen, wordt systemd-genie gebruikt als work-around. Meer informatie over systemd-genie vindt u in systemd genie setup Script installation en handmatige installatie stappen voor installatie van systemd-genie en service fabric SDK beide.

Installatie van script

Voor het gemak wordt een script verstrekt voor het installeren van de algemene Service Fabric-SDK, samen met de sfctl CLI. Als u het script uitvoert, wordt ervan uitgegaan dat u akkoord gaat met de licenties voor alle software die wordt geïnstalleerd. U kunt ook de handmatige installatiestappen uitvoeren in de volgende sectie, waarin gekoppelde licenties en de onderdelen worden geïnstalleerd.

Nadat het script is uitgevoerd, kunt u verdergaan met Een lokaal cluster instellen.

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

Handmatige installatie

Volg de rest van deze handleiding voor handmatige installatie van de Service Fabric-runtime en de algemene SDK.

  1. Open een terminal.

  2. Aanmelden bij WSL2 Linux-distributie

  3. Systemd-genie instellen zoals vermeld in systemd genie setup (als systemd-genie al is ingesteld, kunt u naar de volgende stap gaan)

  4. Enter into genie namespace using genie -s

  5. Binnen genie-naamruimte kan SF SDK ook worden geïnstalleerd zoals vermeld onder Scriptinstallatie of Handmatige installatiestappen in Een lokaal Linux-cluster instellen

  6. Geef sudo-bevoegdheden aan de huidige gebruiker door een vermelding <USERNAME\> ALL = (ALL) NOPASSWD:ALL te maken in /etc/sudoers

Een lokaal cluster instellen

Service Fabric binnen WSL2 VM wordt aanbevolen om te beheren vanuit hostvensters

  1. Service Fabric SDK (versie 6.0 of hoger) installeren in Windows-host

  2. In Windows kan het cluster worden beheerd met het hulpprogramma ServiceFabricLocalClusterManager dat is opgegeven als onderdeel van SF SDK

  3. Optie voor het beheren van lokaal Linux-cluster is alleen ingeschakeld wanneer a. WSL2-VM wordt uitgevoerd, b. Systemd-genie-, servicefabricruntime- en servicefabricsdkcommon-pakketten zijn correct geïnstalleerd in VM en c. Systemd-genie heeft de status Actief. U kunt vanuit dit hulpprogramma instellen of overschakelen naar een lokaal Linux-cluster.

  4. Een andere manier om een Linux-cluster in te stellen, is het implementeren met behulp van clusterinstallatiescripts die zijn opgegeven als onderdeel van de SF SDK.

  5. Open een webbrowser en ga naar Service Fabric Explorer http://localhost:19080. Wanneer het cluster is gestart, ziet u het Service Fabric Explorer-dashboard. Het kan enkele minuten duren voordat het cluster is ingesteld. Als de URL niet kan worden geopend in uw browser, wordt het cluster niet weergegeven in Service Fabric Explorer, wacht u enkele minuten en probeert u het opnieuw. U kunt het cluster ook zien in ServiceFabricExplorer die is opgegeven in SF SDK.

  6. Zodra het cluster actief is, kunt u verbinding maken met een lokaal cluster in PowerShell en Visual Studio.

Handmatige installatie met custom ServiceFabric en ServieFabricSdkCommon Debian Package

Volg de rest van deze handleiding voor handmatige installatie van de Service Fabric van aangepaste of gedownloade Debian-pakketten.

  1. Open een terminal.

  2. Aanmelden bij WSL2 Linux-distributie

  3. Set-upbestand klonen

sudo curl -s https://raw.githubusercontent.com/Azure/service-fabric-scripts-and-templates/master/scripts/SetupServiceFabric/SetupServiceFabric.sh > SetupServiceFabric.sh
  1. Het bestand uitvoerbaar maken
sudo chmod +x SetupServiceFabric.sh
  1. Voer het installatiescript uit met het pad naar lokale debian-pakketten. Zorg ervoor dat de opgegeven paden geldig zijn. Hieronder ziet u een voorbeeld:
sudo ./SetupServiceFabric.sh --servicefabricruntime=/mnt/c/Users/testuser/Downloads/servicefabric.deb --servicefabricsdk=/mnt/c/Users/testuser/Downloads/servicefabric_sdkcommon.deb

Bekende beperkingen

Hier volgen bekende beperkingen van het lokale cluster dat wordt uitgevoerd in Linux-distributie:

  • Momenteel wordt ubuntu-18.04-distributie alleen ondersteund.
  • Als u een naadloze ervaring wilt hebben met Lokaal clusterbeheer en Visual Studio, is het raadzaam om het cluster te beheren vanuit PowerShell-scripts of LocalClusterManager in Windows-host.

Veelgestelde vragen

  1. Welke Linux-distributies worden ondersteund voor het instellen van een lokaal SF-cluster?
    Momenteel wordt alleen Ubuntu-18.04 ondersteund voor lokaal Linux-cluster.

  2. Kan windows- en Linux SF-cluster parallel worden uitgevoerd met WSL2-installatie?
    Nee, tegelijkertijd kan slechts één lokaal cluster worden uitgevoerd op de host of in de gast-VM.

  3. Hoe implementeer ik één lokaal Linux-cluster?
    Het lokale Linux-cluster met één knooppunt of vijf knooppunten kan worden geïmplementeerd vanuit Lokaal clusterbeheer via de menuopties. Tijdens de implementatie vanuit het installatiescript wordt standaard vijf knooppuntclusters geïmplementeerd en moet voor één knooppuntcluster CreateOneNodeCluster worden doorgegeven.

  4. Verbinding maken met lokaal Linux-cluster in PowerShell en Visual Studio
    Als het lokale Linux-cluster actief is, moet de cmdlet connect-servicefabriccluster automatisch verbinding maken met dit cluster. In Vergelijkbare Visual Studio wordt dit lokale cluster automatisch gedetecteerd. Dit cluster kan ook worden verbonden door het clustereindpunt op te geven in PowerShell of Visual Studio.

  5. Waar bevinden sf-clustergegevens zich voor het lokale Linux-cluster?
    Als u Ubuntu-18.04-distributie gebruikt, bevinden SF-gegevens zich op \wsl$\Ubuntu-18.04\home\sfuser\sfdevcluster van windows-host.

Volgende stappen