Sdílet prostřednictvím

Nastavení clusteru Service Fabric s Linuxem prostřednictvím WSL2 na vývojářském počítači s Windows

  • Článek

Tento dokument popisuje, jak nastavit místní cluster Service Fabric s Linuxem prostřednictvím WSL2 na vývojovém počítači s Windows. Nastavení místního clusteru s Linuxem je užitečné k rychlému testování aplikací určených pro clustery s Linuxem, ale jsou vyvíjeny na počítači s Windows.

Požadavky

Clustery Service Fabric založené na Linuxu neběží přímo ve Windows, ale abychom umožnili vytváření prototypů napříč platformami, poskytujeme způsob, jak nasadit cluster Service Fabric uvnitř distribuce Linuxu prostřednictvím WSL2 (Subsystém Windows pro Linux) pro Windows.

Než začnete, budete potřebovat:

  • Nastavení WSL2 ve Windows a zajištění výchozí verze WSL 2
  • Nastavení distribuce Linuxu Ubuntu 18.04 z Microsoft Storu při nastavování WSL2

Tip

Pokud chcete nainstalovat WSL2 na počítač s Windows, postupujte podle pokynů v dokumentaci WSL. Po instalaci se ujistěte, že jste nainstalovali Ubuntu-18.04, nastavte ji jako výchozí distribuci a měla by být spuštěná.

Nastavení sady Service Fabric SDK v distribuci Linuxu

Instalační program Service Fabric nelze provést v distribuci WSL2 linuxu způsobem, jakým se provádí ve standardním operačním systému Linux. Vzhledem k tomu, že systém jako PID1 není spuštěný uvnitř virtuálního počítače a systémový jako PID1 je předpokladem úspěšného fungování sady SDK SF. Pokud chcete povolit systemd jako PID1, systemd-genie se používá jako alternativní řešení. Další podrobnosti o systemd-genie naleznete v systemd Genie setup Script instalace a ruční instalační kroky zahrnují instalaci systemd-genie a service fabric sdk oba.

Instalace skriptem

Pro usnadnění je k dispozici skript pro instalaci společné sady SDK Service Fabric spolu s rozhraním příkazového řádku sfctl. Spuštěním skriptu se předpokládá, že souhlasíte s licencemi pro veškerý instalovaný software. Případně můžete spustit kroky ruční instalace v další části, která bude prezentovat přidružené licence a nainstalované komponenty.

Po úspěšném spuštění skriptu můžete přeskočit k Nastavení místního clusteru.

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

Ruční instalace

Pokud chcete modul runtime a běžnou sadu SDK Service Fabric nainstalovat ručně, postupujte dále podle této příručky.

  1. Otevřete terminál.

  2. Přihlášení k distribuci WSL2 Pro Linux

  3. Nastavte systemd-genie, jak je uvedeno v nastavení systemd Genie (pokud je systemd-genie už nastavený, můžete přejít k dalšímu kroku).

  4. Zadání do oboru názvů Genie pomocí genie -s

  5. Uvnitř oboru názvů Genie je možné nainstalovat také sadu SDK SF, jak je uvedeno v části Instalace skriptu nebo ruční instalace v části Nastavení místního clusteru s Linuxem.

  6. Poskytnutí oprávnění sudo aktuálnímu uživateli provedením položky <USERNAME\> ALL = (ALL) NOPASSWD:ALL v /etc/sudoers

Nastavení místního clusteru

Service Fabric uvnitř virtuálního počítače WSL2 se doporučuje spravovat z hostitelských oken.

  1. Instalace sady Service Fabric SDK (verze 6.0 nebo vyšší) v hostiteli s Windows

  2. Ve Windows je možné cluster spravovat pomocí nástroje ServiceFabricLocalClusterManager poskytovaného jako součást sady SDK SF.

  3. Možnost správy místního clusteru s Linuxem je povolená pouze v případech, kdy existuje. Virtuální počítač WSL2 je spuštěný, b. Balíčky Systemd-Genie, servicefabricruntime a servicefabricsdkcommon jsou správně nainstalované uvnitř virtuálního počítače a c. Systemd-Genie je ve spuštěném stavu. Z tohoto nástroje můžete nastavit nebo přepnout na místní cluster s Linuxem.

  4. Dalším způsobem nastavení linuxového clusteru je nasazení pomocí skriptů nastavení clusteru poskytovaných jako součást sady SDK SF.

  5. Otevřete webový prohlížeč a přejděte do Service Fabric Exploreru http://localhost:19080. Po spuštění clusteru by se měl zobrazit řídicí panel Service Fabric Exploreru. Nastavení clusteru může trvat několik minut. Pokud se v prohlížeči nepodaří otevřít adresu URL nebo Se službou Service Fabric Explorer se cluster nezobrazí, počkejte několik minut a zkuste to znovu. Cluster můžete zobrazit také v ServiceFabricExploreru poskytovaném v sadě SDK SF.

  6. Jakmile je cluster spuštěný, můžete se připojit k místnímu clusteru v PowerShellu a sadě Visual Studio.

Ruční instalace s vlastním balíčkem ServiceFabric a ServieFabricSdkCommon Debian

Pokud chcete ručně nainstalovat Service Fabric z vlastních nebo stažených balíčků Debian, postupujte podle zbývajících pokynů v této příručce.

  1. Otevřete terminál.

  2. Přihlášení k distribuci WSL2 Pro Linux

  3. Klonování nastaveného souboru

sudo curl -s https://raw.githubusercontent.com/Azure/service-fabric-scripts-and-templates/master/scripts/SetupServiceFabric/SetupServiceFabric.sh > SetupServiceFabric.sh
  1. Nastavení souboru jako spustitelného souboru
sudo chmod +x SetupServiceFabric.sh
  1. Spusťte instalační skript s místní cestou balíčků Debian. Ujistěte se, že jsou zadané cesty platné. Níže je uveden příklad:
sudo ./SetupServiceFabric.sh --servicefabricruntime=/mnt/c/Users/testuser/Downloads/servicefabric.deb --servicefabricsdk=/mnt/c/Users/testuser/Downloads/servicefabric_sdkcommon.deb

Známá omezení

Níže jsou známá omezení místního clusteru spuštěného v linuxové distribuci:

  • Distribuce Ubuntu-18.04 se v současné době podporuje pouze.
  • Pokud chcete mít bezproblémové prostředí s místním správcem clusteru a sadou Visual Studio, doporučujeme spravovat cluster ze skriptů PowerShellu nebo LocalClusterManager v hostiteli Windows.

Nejčastější dotazy

  1. Jaké linuxové distribuce se podporují pro nastavení místního clusteru SF?
    V současné době se pro místní cluster s Linuxem podporuje jenom Ubuntu-18.04.

  2. Je možné cluster SF pro Windows a Linux spustit paralelně s nastavením WSL2?
    Ne, v jednom okamžiku je možné spustit pouze jeden místní cluster v hostiteli nebo na virtuálním počítači hosta.

  3. Jak nasadit jeden linuxový místní cluster uzlu?
    Z možností nabídky je možné nasadit jeden uzel nebo pět uzlů místního clusteru linuxového místního clusteru z místního správce clusteru. Při nasazování z instalačního skriptu je standardně nasazeno pět clusterů uzlů a pro jeden cluster uzlů CreateOneNodeCluster by se měl předat.

  4. Jak se připojit k místnímu clusteru s Linuxem v PowerShellu a sadě Visual Studio?
    Pokud je místní cluster linuxu spuštěný, měla by se k tomuto clusteru automaticky připojit rutina connect-servicefabriccluster. Podobný Visual Studio automaticky rozpozná tento místní cluster. Tento cluster je také možné připojit poskytnutím koncového bodu clusteru v PowerShellu nebo sadě Visual Studio.

  5. Kde se nacházejí data clusteru SF pro místní cluster s Linuxem?
    Pokud používáte distribuci Ubuntu-18.04, data SF se nacházejí v umístění \wsl$\Ubuntu-18.04\home\sfuser\sfdevcluster z hostitele Windows.

Další kroky