Nastavení clusteru Service Fabric s Linuxem na počítači pro vývojáře s Windows

  • Článek

Tento dokument popisuje, jak nastavit místní cluster Service Fabric s Linuxem 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ěží ve Windows, ale abychom umožnili vytváření prototypů napříč platformami, poskytli jsme kontejner Docker clusteru Service Fabric s Linuxem s jedním boxem, který je možné nasadit prostřednictvím Dockeru pro Windows.

Než začnete, budete potřebovat:

  • Minimálně 4 GB RAM
  • Nejnovější verze Dockeru pro Windows
  • Docker musí být spuštěný v režimu kontejnerů Linuxu.

Tip

Pokud chcete do počítače s Windows nainstalovat Docker, postupujte podle pokynů v dokumentaci k Dockeru. Po dokončení instalaci ověřte.

Vytvoření místního kontejneru a nastavení Service Fabric

Pokud chcete nastavit místní kontejner Dockeru a mít na něm spuštěný cluster Service Fabric, spusťte následující kroky:

  1. Následujícím způsobem aktualizujte konfiguraci démona Dockeru na hostiteli a potom démon Dockeru restartujte:

    {
  "ipv6": true,
  "fixed-cidr-v6": "2001:db8:1::/64"
}

    Doporučený způsob, jak aktualizovat, je přejít na:

    • Docker Icon > Settings > Docker Engine
    • Přidání nových polí uvedených výše
    • Použít a restartovat – restartujte proces démona Dockeru, aby se změny projevily.

  2. Spusťte cluster přes PowerShell.
    Ubuntu 20.04 LTS:

    docker run --name sftestcluster -d -v /var/run/docker.sock:/var/run/docker.sock -p 19080:19080 -p 19000:19000 -p 25100-25200:25100-25200 mcr.microsoft.com/service-fabric/onebox:u20

    Ubuntu 18.04 LTS:

    docker run --name sftestcluster -d -v /var/run/docker.sock:/var/run/docker.sock -p 19080:19080 -p 19000:19000 -p 25100-25200:25100-25200 mcr.microsoft.com/service-fabric/onebox:u18

    Tip

    Ve výchozím nastavení se tím přetáhne image s nejnovější verzí Service Fabric. Konkrétní revize najdete na stránce Service Fabric Oneboxu v Docker Hubu.

  3. Volitelné: Sestavte rozšířenou image Service Fabric.

    V novém adresáři vytvořte soubor volaný Dockerfile pro sestavení přizpůsobené image:

    Poznámka:

    Výše uvedenou image můžete přizpůsobit souborem Dockerfile a přidat do kontejneru další programy nebo závislosti. Například přidáním RUN apt-get install nodejs -y se povolí podpora aplikací nodejs jako spustitelných souborů typu Host.

    FROM mcr.microsoft.com/service-fabric/onebox:u18
RUN apt-get install nodejs -y
EXPOSE 19080 19000 80 443
WORKDIR /home/ClusterDeployer
CMD ["./ClusterDeployer.sh"]

    Tip

    Ve výchozím nastavení se tím přetáhne image s nejnovější verzí Service Fabric. Konkrétní revize najdete na stránce Docker Hubu.

    Pokud chcete vytvořit opakovaně použitelnou image z Dockerfileterminálu, otevřete terminál a cd přímo podržením a spusťte Dockerfile :

    docker build -t mysfcluster .

    Poznámka:

    Tato operace nějakou dobu trvá, ale stačí ji provést jenom jednou.

    Teď můžete rychle spustit místní kopii Service Fabric, kdykoli ji potřebujete, spuštěním tohoto příkazu:

    docker run --name sftestcluster -d -v /var/run/docker.sock:/var/run/docker.sock -p 19080:19080 -p 19000:19000 -p 25100-25200:25100-25200 mysfcluster

    Tip

    Zadejte název instance kontejneru, aby s ní šlo pracovat srozumitelněji.

    Pokud vaše aplikace naslouchá na konkrétních portech, musí se zadat pomocí dalších značek -p. Pokud například aplikace naslouchá na portu 8080, přidejte následující značku -p:

    docker run -itd -p 19000:19000 -p 19080:19080 -p 8080:8080 --name sfonebox mcr.microsoft.com/service-fabric/onebox:u18

  4. Spuštění clusteru bude chvíli trvat. Pomocí následujícího příkazu můžete zobrazit protokoly nebo můžete přejít na řídicí panel na adrese http://localhost:19080 a zobrazit stav clusteru:

    docker logs sftestcluster

  5. Po úspěšném nasazení clusteru, jak je uvedeno v kroku 4, můžete přejít z http://localhost:19080 počítače s Windows a najít řídicí panel Service Fabric Exploreru. V tomto okamžiku se k tomuto clusteru můžete připojit pomocí nástrojů z vývojářského počítače s Windows a nasadit aplikace cílené na clustery Service Fabric s Linuxem.

    Poznámka:

    Modul plug-in Eclipse se v systému Windows aktuálně nepodporuje.

  6. Až to budete hotovi, pomocí tohoto příkazu kontejner zastavte a vyčistíte:

    docker rm -f sftestcluster

Známá omezení

Následující seznam uvádí známá omezení pro místní cluster spuštěný v kontejneru pro Mac:

  • Služba DNS se nespustí a v kontejneru se v současné době nepodporuje. Problém č. 132
  • Spouštění aplikací založených na kontejnerech vyžaduje spuštění SF na hostiteli s Linuxem. Vnořené kontejnerové aplikace se v současné době nepodporují.

Další kroky