Příprava vývojového prostředí v Linuxu

Článek
05/13/2021
8 min ke čtení

Pokud chcete sestavovat a spouštět aplikace Azure Service Fabric na vývojovém počítači s Linuxem, musíte nainstalovat modul runtime a běžnou sadu SDK. Můžete také nainstalovat volitelné sady SDK pro vývoj v Javě a .NET Core.

Kroky v tomto článku předpokládají, že nakonfigurujete nativně na Linux nebo použijete Image kontejneru Service Fabric OneBox, tj. mcr.microsoft.com/service-fabric/onebox:u18 .

Service Fabric entit hostovaných v cloudu nebo v místním prostředí můžete spravovat pomocí rozhraní příkazového řádku (CLI) Azure Service Fabric. Informace o instalaci rozhraní příkazového řádku najdete v tématu Nastavení rozhraní příkazového řádku Service Fabric.

Požadavky

Ujistěte se, že používáte podporovanou verzi systému Linux.

Nainstalujte apt-transport-https balíček:

sudo apt-get install apt-transport-https

Aktualizace zdrojů APT

Pokud chcete nainstalovat sadu SDK a přidružený balíček modulu runtime pomocí nástroje pro příkazový řádek apt-get, musíte nejprve aktualizovat zdroje APT (Advanced Packaging Tool).

Instalace skriptem

Pro usnadnění práce je k dispozici skript pro instalaci Service Fabric runtime a Service Fabric společnou sadu SDK společně 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, kde se budou vyskytovat přidružené licence a také součásti, které jsou nainstalovány.

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.

Otevřete terminál.

Přidejte dotnet úložiště do seznamu zdroje, který odpovídá vaší distribuci.

wget -q https://packages.microsoft.com/config/ubuntu/$(lsb_release -rs)/packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb

Přidejte nový klíč programu MS Open Tech GNU Privacy Guard (GnuPG nebo GPG) do svého APTového prstence.
```
sudo curl -fsSL https://packages.microsoft.com/keys/msopentech.asc | sudo apt-key add -
```

Přidejte do své klíčenky APT oficiální klíč GPG Dockeru.

sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

Nastavte úložiště Dockeru.

sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

Přidejte klíč JDK Azul do svého správce klíčů APT a nastavte jeho úložiště.

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 0xB1998361219BD9C9
sudo apt-add-repository "deb http://repos.azul.com/azure-only/zulu/apt stable main"

Obnovte seznamy balíčků na základě nově přidaných úložišť.
```
sudo apt-get update
```

Instalace a nastavení sady Service Fabric SDK pro místní cluster

Po aktualizaci vašich zdrojů můžete nainstalovat sadu SDK. Nainstalujte balíček sady Service Fabric SDK, potvrďte instalaci a přijměte licenční smlouvu.

Ubuntu

sudo apt-get install servicefabricsdkcommon

Tip

Následující příkazy automatizují přijetí licence pro balíčky Service Fabric:

echo "servicefabric servicefabric/accepted-eula-ga select true" | sudo debconf-set-selections
echo "servicefabricsdkcommon servicefabricsdkcommon/accepted-eula-ga select true" | sudo debconf-set-selections

Aktualizace úložišť Yumu

Chcete-li nainstalovat sadu SDK a přidružený balíček modulu runtime pomocí nástroje příkazového řádku Yumu, je nutné nejprve aktualizovat zdroje balíčků.

Ruční instalace (RHEL)

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

Otevřete terminál.

Stáhněte a nainstalujte dodatečné balíčky pro Enterprise Linux (EPEL).

wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
sudo yum install epel-release-latest-7.noarch.rpm

Přidejte do svého systému úložiště balíčků EfficiOS RHEL7.

sudo wget -P /etc/yum.repos.d/ https://packages.efficios.com/repo.files/EfficiOS-RHEL7-x86-64.repo

Naimportujte podpisový klíč balíčku EfficiOS do místní klíčenky GPG.
```
sudo rpmkeys --import https://packages.efficios.com/rhel/repo.key
```

Přidejte do svého systému úložiště Microsoft RHEL.

curl https://packages.microsoft.com/config/rhel/7.4/prod.repo > ./microsoft-prod.repo
sudo cp ./microsoft-prod.repo /etc/yum.repos.d/

Instalace a nastavení sady Service Fabric SDK pro místní cluster (RHEL)

Po aktualizaci vašich zdrojů můžete nainstalovat sadu SDK. Nainstalujte balíček sady Service Fabric SDK, potvrďte instalaci a přijměte licenční smlouvu.

sudo yum install servicefabricsdkcommon

Zahrnuté balíčky

Modul runtime Service Fabric, který je součástí instalace sady SDK, obsahuje balíčky uvedené v následující tabulce.

	DotNetCore	Java	Python	NodeJS
Ubuntu	2.0.7	AzulJDK 1,8	Implicitně převzato z npm	nejnovější
RHEL	-	OpenJDK 1.8	Implicitně převzato z npm	nejnovější

Nastavení místního clusteru

Spusťte místní Cluster Service Fabric pro vývoj.

Místní cluster založený na kontejneru
Místní cluster

Spusťte clusterový Service Fabric OneBox založený na kontejneru.

Nainstalujte Moby, abyste mohli nasazovat kontejnery Docker.
```
sudo apt-get install moby-engine moby-cli -y
```
Aktualizujte konfiguraci démona Docker na hostiteli s následujícím nastavením a restartujte démona Docker. Podrobnosti: Povolení podpory protokolu IPv6
```
{
    "ipv6": true,
    "fixed-cidr-v6": "fd00::/64"
}
```

Spusťte cluster.
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

Ubuntu 16,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:u16

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.

Po instalaci sady SDK pomocí výše uvedených kroků spusťte místní cluster.

Spusťte instalační skript clusteru.

sudo /opt/microsoft/sdk/servicefabric/common/clustersetup/devclustersetup.sh

Otevřete webový prohlížeč a přejdete na Service Fabric Explorer ( http://localhost:19080/Explorer ). Po spuštění clusteru by se měl zobrazit řídicí panel Service Fabric Exploreru. Úplné nastavení clusteru může trvat několik minut. Pokud se v prohlížeči nepodaří otevřít adresu URL nebo pokud se v Service Fabric Exploreru nezobrazí připravený systém, počkejte několik minut a zkuste to znovu.

Teď můžete nasadit předem sestavené balíčky aplikací Service Fabric nebo nové balíčky založené na kontejnerech nebo spustitelných souborech hostů. Pokud chcete sestavit nové služby pomocí sad Java SDK nebo .NET Core SDK, postupujte podle pokynů k instalaci uvedených v dalších částech.

Poznámka

Samostatné clustery nejsou podporované v systému Linux.

Tip

Pokud je dostupný disk SSD, pro zajištění špičkového výkonu se doporučuje předat cestu ke složce SSD pomocí --clusterdataroot s devclustersetup.sh.

Nastavení rozhraní příkazového řádku Service Fabric

Rozhraní příkazového řádku Service Fabric obsahuje příkazy pro komunikaci s entitami služby Service Fabric, včetně clusterů a aplikací. Při instalaci rozhraní příkazového řádku postupujte podle pokynů v tématu Service Fabric CLI.

Nastavení generátorů Yeoman pro kontejnery a spustitelné soubory hosta

Service Fabric nabízí nástroje pro generování uživatelského rozhraní, které vám pomohou vytvářet aplikace Service Fabric z terminálu s využitím generátorů šablon Yeoman. Podle těchto pokynů nastavte generátory šablon Service Fabric Yeoman:

Nainstalujte si na počítač Node.js a npm.

sudo add-apt-repository "deb https://deb.nodesource.com/node_8.x $(lsb_release -s -c) main"
sudo apt-get update
sudo apt-get install nodejs

Nainstalujte na svém počítači generátor šablon Yeoman z npm.
```
sudo npm install -g yo
```

Nainstalujte generátory pro kontejnery a spustitelné soubory hosta Service Fabric Yeo z npm.

sudo npm install -g generator-azuresfcontainer  # for Service Fabric container application
sudo npm install -g generator-azuresfguest      # for Service Fabric guest executable application

Po nainstalování generátorů vytvořte spustitelné soubory hosta nebo služby kontejneru spuštěním příkazu yo azuresfguest nebo yo azuresfcontainer.

Nastavení vývoje .NET Core 3,1

Pokud chcete začít vytvářet aplikace Service Fabric C#, nainstalujte sadu .NET Core 3,1 SDK pro Ubuntu . Balíčky pro aplikace .NET Core Service Fabric se hostují na NuGet.org.

Nastavení pro vývoj v Javě

Chcete-li vytvořit služby Service Fabric pomocí jazyka Java, nainstalujte Gradle a spusťte úlohy sestavení. Spusťte následující příkaz pro instalaci Gradle. Knihovny Service Fabric Java se berou z Mavenu.

Ubuntu

curl -s https://get.sdkman.io | bash
sdk install gradle 5.1

Red Hat Enterprise Linux 7.4 (podpora Service Fabric ve verzi Preview)

sudo yum install java-1.8.0-openjdk-devel
curl -s https://get.sdkman.io | bash
sdk install gradle

Potřebujete také nainstalovat generátor Service Fabric Yeo pro spustitelné soubory Java. Ověřte, že máte nainstalovaný Yeoman, a potom spusťte následující příkaz:

npm install -g generator-azuresfjava

Instalace modulu plug-in Eclipse (volitelné)

Modul plug-in Eclipse pro Service Fabric můžete nainstalovat z integrovaného vývojového prostředí Eclipse pro vývojáře v Javě nebo v Javě EE. Mimo aplikací Service Fabric v Javě můžete k vytvoření aplikací spustitelných souborů hosta a aplikací kontejneru Service Fabric použít Eclipse.

Důležité

Modul plug-in Service Fabric vyžaduje verzi Eclipse Neon nebo novější. Návod k ověření verze Eclipse najdete v pokynech pod touto poznámkou. Pokud máte nainstalovanou starší verzi Eclipse, můžete si stáhnout novější verzi z webu Eclipse. Instalace přes stávající instalaci Eclipse (její přepsání) se nedoporučuje. Před spuštěním instalačního programu ji odeberte nebo nainstalujte novou verzi do jiného adresáře.

V Ubuntu doporučujeme provést instalaci přímo z webu Eclipse, a nepoužívat instalační program balíčků (apt nebo apt-get). Tím zajistíte, že budete mít nejnovější verzi Eclipse. Můžete nainstalovat integrované vývojové prostředí Eclipse pro vývojáře v Javě nebo v Javě EE.

V Eclipse se ujistěte, že máte nainstalovanou verzi Eclipse Neon nebo novější a Buildship verze 2.2.1 nebo novější. Verze nainstalovaných komponent zkontrolujete tak, že vyberete nápovědu > o > podrobnostech instalace na zatmění. Buildship můžete aktualizovat pomocí pokynů v článku Eclipse Buildship: Eclipse Plug-ins for Gradle (Eclipse Buildship: Moduly plug-in Eclipse pro Gradle).
Pokud chcete nainstalovat modul plug-in Service Fabric, vyberte help > instalovat nový software.
Do pole work with (pracovat s ) zadejte https: / /dl.Microsoft.com/Eclipse.
Vyberte Přidat.
Vyberte modul plug-in ServiceFabric a potom klikněte na Next (Další).
Proveďte kroky instalace. Potom přijměte licenční smlouvu s koncovým uživatelem.

Pokud už máte modul plug-in Service Fabric Eclipse nainstalovaný, ověřte, že používáte nejnovější verzi. Vyberte nápovědu > o > podrobnostech instalace zatmění. Pak vyhledejte Service Fabric v seznamu nainstalovaných modulů plug-in. Pokud je k dispozici novější verze, vyberte aktualizovat .

Další informace najdete v tématu Modul plug-in Service Fabric pro vývoj aplikací v Eclipse Javě.

Aktualizace sady SDK a modulu runtime

Pokud chcete aktualizovat sadu SDK a modul runtime na nejnovější verze, spusťte následující příkazy.

sudo apt-get update
sudo apt-get install servicefabric servicefabricsdkcommon

Pokud chcete aktualizovat binární soubory sady Java SDK z Mavenu, je potřeba aktualizovat podrobnosti o verzi příslušného binárního souboru v souboru build.gradle tak, aby odkazovaly na nejnovější verzi. Abyste přesně zjistili, kde potřebujete aktualizovat verzi, můžete se podívat na jakýkoli soubor build.gradle v úvodních příkladech Service Fabric.

Poznámka

Aktualizace balíčků může způsobit zastavení místního vývojového clusteru. Po provedení upgradu restartujte místní cluster podle pokynů v tomto článku.

Odebrání sady SDK

Pokud chcete odebrat sady Service Fabric SDK, spusťte následující příkazy.

Ubuntu

sudo apt-get remove servicefabric servicefabicsdkcommon
npm uninstall -g generator-azuresfcontainer
npm uninstall -g generator-azuresfguest
sudo apt-get install -f

Red Hat Enterprise Linux 7.4 (podpora Service Fabric ve verzi Preview)

sudo yum remove servicefabric servicefabicsdkcommon
npm uninstall -g generator-azuresfcontainer
npm uninstall -g generator-azuresfguest

Příprava vývojového prostředí v Linuxu

Ohodnoťte vaše zkušenosti

Požadavky

Metody instalace

Aktualizace zdrojů APT

Instalace skriptem

Ruční instalace

Instalace a nastavení sady Service Fabric SDK pro místní cluster

Ubuntu

Zahrnuté balíčky

Nastavení místního clusteru

Nastavení rozhraní příkazového řádku Service Fabric

Nastavení generátorů Yeoman pro kontejnery a spustitelné soubory hosta

Nastavení vývoje .NET Core 3,1

Nastavení pro vývoj v Javě

Instalace modulu plug-in Eclipse (volitelné)

Aktualizace sady SDK a modulu runtime

Odebrání sady SDK

Další kroky