Modul plug-in Service Fabric pro vývoj aplikací v Eclipse Javě

Eclipse je jedním z nejčastěji používaných integrovaných vývojových prostředí (IDE) pro vývojáře v jazyce Java. V tomto článku probereme možnosti nastavení vývojového prostředí Eclipse pro práci s Azure Service Fabric. Zjistíte, jak v Eclipse nainstalovat modul plug-in Service Fabric, vytvořit aplikaci Service Fabric a nasadit ji do místního nebo vzdáleného clusteru Service Fabric.

Poznámka

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

Důležité

Ujistěte se, že je v systému nainstalovaná sada JDK 8 a vybraná v Eclipse.

Instalace a aktualizace modulu plug-in Service Fabric v Eclipse

Modul plug-in Service Fabric můžete nainstalovat do Eclipse. Tento modul plug-in může zjednodušit proces vytváření a nasazování služeb v Javě.

Důležité

Modul plug-in Service Fabric vyžaduje Eclipse Neon nebo novější verzi. 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 můžete odebrat nebo můžete novou verzi nainstalovat 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.

Nainstalujte Eclipse Neon nebo novější verzi z webu Eclipse. Nainstalujte také Buildship verze 2.2.1 nebo novější (modul plug-in Service Fabric není kompatibilní se staršími verzemi Buildshipu):

• Pokud chcete zkontrolovat verze nainstalovaných komponent, přejděte v Eclipse do nápovědy> kpodrobnostem o instalaciEclipse>.
• Pokud chcete aktualizovat Buildship, přečtěte si téma Eclipse Buildship: Moduly plug-in Eclipse pro Gradle.
• Pokud chcete vyhledat a nainstalovat aktualizace pro Eclipse, přejděte do nápovědy>ke kontrole Aktualizace.

Nainstalujte modul plug-in Service Fabric. V Eclipse přejděte na Nápovědu> kinstalaci nového softwaru.

1. Do pole Work with (Pracovat s) zadejte https://servicefabricdownloads.blob.core.windows.net/eclipse/.

2. Klikněte na Přidat.

   

3. Vyberte modul plug-in Service Fabric a potom klikněte na Další.

4. Dokončete instalaci a přijměte licenční podmínky pro software společnosti Microsoft.

Pokud už máte modul plug-in Service Fabric nainstalovaný, nainstalujte nejnovější verzi.

1. Pokud chcete vyhledat dostupné aktualizace, přejděte do nápovědy>Podrobnosti o instalaci Eclipse>.
2. V seznamu nainstalovaných modulů plug-in vyberte Service Fabric a potom klikněte na Aktualizovat. Nainstalují se dostupné aktualizace.
3. Jakmile aktualizujete modul plug-in Service Fabric, aktualizujte také projekt Gradle. Klikněte pravým tlačítkem na build.gradle a vyberte Aktualizovat.

Poznámka

Pokud je instalace nebo aktualizace modulu plug-in Service Fabric pomalá, může být důvodem nastavení Eclipse. Eclipse shromažďuje metadata o všech změnách, aby aktualizoval weby, které jsou registrované pro vaši instanci Eclipse. Pokud chcete proces vyhledávání a instalace aktualizace modulu plug-in Service Fabric urychlit, přejděte k části Available Software Sites (Dostupné softwarové servery). Zrušte zaškrtnutí políček u všech webů s výjimkou toho, který odkazuje na umístění modulu plug-in Service Fabric ('https://servicefabricdownloads.blob.core.windows.net/eclipse/').

Poznámka

Pokud Eclipse nefunguje na vašem počítači Mac podle očekávání nebo vyžaduje spuštění od superuživatele, přepněte se do složky ECLIPSE_INSTALLATION_PATH a přejděte do podsložky Eclipse.app/Contents/MacOS. Spusťte Eclipse spuštěním příkazu ./eclipse.

Vytvoření aplikace Service Fabric pomocí Eclipse

1. V Eclipse přejděte na Nový soubor>>– Jiný. Vyberte Service Fabric Project (Projekt Service Fabric) a klikněte na Next (Další).

   

2. Zadejte název pro svůj projekt a potom klikněte na Next (Další).

   

3. V seznamu šablon vyberte Service Template (Šablona služby). Vyberte typ šablony služby (Actor, Stateless, Container nebo Guest Binary) a potom klikněte na Next (Další).

   

4. Zadejte název a podrobnosti služby a potom klikněte na Finish (Dokončit).

   

5. Když vytvoříte svůj první projekt Service Fabric, v dialogovém okně Open Associated Perspective Otevřít přidruženou perspektivu) klikněte na Yes (Ano).

   

6. Nový projekt vypadá takto:

   

Sestavení aplikace Service Fabric v Eclipse

1. Klikněte na novou aplikaci Service Fabric pravým tlačítkem a potom vyberte Service Fabric.

   

2. V místní nabídce vyberte jednu z následujících možností:

   • Build Application (Sestavit aplikaci) sestaví aplikaci bez vyčištění.
   • Rebuild Application (Znovu sestavit aplikaci) provede vyčištění a nové sestavení aplikace.
   • Clean Application (Vyčistit aplikaci) vyčistí aplikaci od artefaktů sestavení.

Nasazení aplikace Service Fabric do místního clusteru pomocí Eclipse

Po vytvoření aplikace Service Fabric ji podle těchto kroků nasaďte do místního clusteru.

1. Pokud jste místní cluster nespustili, podle pokynů v tématu Nastavení místního clusteru spusťte místní cluster a ujistěte se, že je spuštěný.

2. Klikněte pravým tlačítkem na aplikaci Service Fabric a pak vyberte Service Fabric.

   

3. V místní nabídce klikněte na Nasadit aplikaci.

4. Průběh operace nasazení můžete sledovat v okně Konzola.

5. Pokud chcete ověřit, že je vaše aplikace spuštěná, otevřete Service Fabric Explorer v místním clusteru v okně http://localhost:19080/Explorerprohlížeče . Rozbalte uzel Aplikace a ujistěte se, že je vaše aplikace spuštěná.

Informace o ladění aplikace v Eclipse pomocí místního clusteru najdete v tématu Ladění služby Java v Eclipse.

Aplikaci můžete také nasadit do místního clusteru pomocí příkazu Publish Application (Publikovat aplikaci ):

1. Klikněte pravým tlačítkem na aplikaci Service Fabric a pak vyberte Service Fabric.

2. V místní nabídce klikněte na Publikovat aplikaci....

3. V okně Publish Application (Publikovat aplikaci) zvolte PublishProfiles/Local.json jako Target Profile (Cílový profil) a klikněte na Publish (Publikovat).

   

   Ve výchozím nastavení je profil publikování Local.json nastavený tak, aby se publikoval do místního clusteru. Další informace o parametrech připojení a koncového bodu v profilech publikování najdete v další části.

Publikování aplikace Service Fabric do Azure pomocí Eclipse

Pokud chcete publikovat aplikaci do cloudu, postupujte takto:

1. Pokud chcete publikovat aplikaci do zabezpečeného clusteru v cloudu, potřebujete ke komunikaci s clusterem certifikát X.509. V testovacím a vývojovém prostředí se často používá certifikát clusteru. V produkčních prostředích by měl být certifikátem klientský certifikát, který se liší od certifikátu clusteru. Potřebujete certifikát i privátní klíč. Soubor certifikátu (a klíče) musí být formátovaný PEM. Pomocí následujícího příkazu openssl můžete vytvořit soubor PEM, který obsahuje certifikát a privátní klíč ze souboru PFX:

   openssl pkcs12 -in your-cert-file.pfx -out your-cert-file.pem -nodes -passin pass:your-pfx-password
   

   Pokud soubor PFX není chráněný heslem, jako poslední parametr použijte --passin pass: .

2. Otevřete soubor Cloud.json v adresáři PublishProfiles . Musíte správně nakonfigurovat koncový bod clusteru a přihlašovací údaje zabezpečení pro váš cluster.

   • Pole ConnectionIPOrURL obsahuje IP adresu nebo adresu URL vašeho clusteru. Všimněte si, že hodnota neobsahuje schéma adresy URL (https://).

   • Ve výchozím nastavení ConnectionPort by pole mělo být 19080, pokud jste explicitně nezměnili tento port pro váš cluster.

   • Pole ClientKey by mělo odkazovat na soubor .pem nebo .key ve formátu PEM na místním počítači, který obsahuje privátní klíč pro váš klientský certifikát nebo certifikát clusteru.

   • Pole ClientCert by mělo odkazovat na soubor .pem nebo .crt ve formátu PEM na místním počítači, který obsahuje data certifikátu pro vašeho klienta nebo clusteru. Certifikát.

     {
         "ClusterConnectionParameters":
         {
            "ConnectionIPOrURL": "lnxxug0tlqm5.westus.cloudapp.azure.com",
            "ConnectionPort": "19080",
            "ClientKey": "[path_to_your_pem_file_on_local_machine]",
            "ClientCert": "[path_to_your_pem_file_on_local_machine]"
         }
     }
     

3. Klikněte pravým tlačítkem na aplikaci Service Fabric a pak vyberte Service Fabric.

4. V místní nabídce klikněte na Publikovat aplikaci....

5. V okně Publikovat aplikaci jako Cílový profil zvolte PublishProfiles/Cloud.json a klikněte na Publikovat.

   

6. Průběh operace publikování můžete sledovat v okně konzoly.

7. Pokud chcete ověřit, že je vaše aplikace spuštěná, otevřete Service Fabric Explorer v clusteru Azure v okně prohlížeče. Ve výše uvedeném příkladu by to bylo: https://lnxxug0tlqm5.westus.cloudapp.azure.com:19080/Explorer. Rozbalte uzel Aplikace a ujistěte se, že je vaše aplikace spuštěná.

Pokud vaše aplikace na zabezpečených clusterech s Linuxem obsahuje služby Reliable Services, budete také muset nakonfigurovat certifikát, který můžou vaše služby používat k volání rozhraní API modulu runtime Service Fabric. Další informace najdete v tématu Konfigurace aplikace Reliable Services pro spuštění v clusterech s Linuxem.

Rychlý návod, jak nasadit aplikaci Service Fabric Reliable Services napsanou v Javě do zabezpečeného clusteru s Linuxem, najdete v tématu Rychlý start: Nasazení aplikace Java Reliable Services.

Nasazení aplikace Service Fabric pomocí konfigurací spuštění Eclipse

Existuje alternativní způsob nasazení aplikace Service Fabric pomocí konfigurací spuštění Eclipse.

1. V Eclipse přejděte na Spustit>konfigurace spuštění.

2. Vyberte konfiguraci spuštění ServiceFabricDeployer v části Gradle Project (Projekt Gradle).

3. V pravém podokně se na kartě Argumenty ujistěte, že jsou parametry IP, port, clientCert a clientKey nastavené správně pro vaše nasazení. Ve výchozím nastavení jsou parametry nastavené tak, aby se nasazoval do místního clusteru jako na následujícím snímku obrazovky. Pokud chcete publikovat aplikaci do Azure, můžete upravit parametry tak, aby obsahovaly podrobnosti o koncovém bodu a přihlašovací údaje zabezpečení pro váš cluster Azure. Další informace najdete v předchozí části Publikování aplikace Service Fabric do Azure pomocí Eclipse.

   

4. Ujistěte se, že pracovní adresář odkazuje na aplikaci, kterou chcete nasadit. Pokud chcete aplikaci změnit, stačí kliknout na Workspace (Pracovní prostor) a vybrat požadovanou aplikaci.

5. Klikněte na Apply (Použít) a potom na Run (Spustit).

Vaše aplikace se během chvilky sestaví a nasadí. Stav nasazení můžete sledovat v Service Fabric Exploreru.

Přidání služby Service Fabric do aplikace Service Fabric

Přidat službu Service Fabric do stávající aplikace Service Fabric je možné pomocí následujících kroků:

1. Klikněte pravým tlačítkem na projekt, ke kterému chcete přidat službu, a potom klikněte na Service Fabric.

   

2. Klikněte na Add Service Fabric Service (Přidat službu Service Fabric) a dokončete kroky pro přidání služby k tomuto projektu.

3. Vyberte šablonu služby, kterou chcete přidat do projektu, a potom klikněte na Next (Další).

   

4. Zadejte název služby (a další podrobnosti podle potřeby) a potom klikněte na Add Service (Přidat službu).

   

5. Celková struktura projektu po přidání služby vypadá podobně jako u tohoto projektu:

   

Úprava verzí manifestu aplikace Service Fabric v jazyce Java

Pokud chcete upravit verze manifestu, klikněte pravým tlačítkem na projekt, přejděte na Service Fabric a z rozevírací nabídky vyberte Upravit verze manifestu.... V průvodci můžete aktualizovat verze manifestu pro manifest aplikace, manifest služby a verze pro balíčky Code, Config a Data.

Pokud zaškrtnete políčko Automaticky aktualizovat verze aplikací a služeb a pak aktualizujete verzi, verze manifestu se zaktualizují automaticky. Když například nejprve zaškrtnete toto políčko a pak zaktualizujete verzi pro verzi Code z 0.0.0 na 0.0.1 a klikněte na Dokončit, verze manifestu služby a verze manifestu aplikace se automaticky aktualizují na 0.0.1.

Upgrade aplikace Service Fabric v Javě

Pro scénář upgradu předpokládejme, že jste pomocí modulu plug-in Service Fabric v Eclipse vytvořili projekt App1. Pomocí modulu plug-in jste ho nasadili a vytvořili aplikaci s názvem fabric: / App1Application. Typ aplikace je App1ApplicationType a verze aplikace je 1.0. Nyní chcete provést upgrade této aplikace bez přerušení dostupnosti.

Nejdřív proveďte úpravy aplikace a znovu sestavte upravenou službu. Aktualizujte soubor manifestu upravené služby (ServiceManifest.xml) s použitím aktualizovaných verzí pro službu (a podle potřeby i verzí kódu, konfigurace nebo dat). Dál upravte manifest aplikace (ApplicationManifest.xml) s použitím čísla aktualizované verze pro aplikaci a upravenou službu.

Pokud chcete k upgradu aplikace použít Eclipse, můžete vytvořit duplicitní profil konfigurace spuštění. Potom ho podle potřeby využijte k upgradu vaší aplikace.

1. Přejděte na Spustit>konfigurace spuštění. v levém podokně klikněte na malou šipku nalevo od možnosti Gradle Project (Projekt Gradle).
2. Klikněte pravým tlačítkem na ServiceFabricDeployer a potom vyberte Duplicate (Duplikovat). Zadejte nový název pro tuto konfiguraci, třeba ServiceFabricUpgrader.
3. Na pravém panelu na kartě Arguments (Argumenty) změňte -Pconfig='deploy' na -Pconfig=upgrade a potom klikněte na Apply (Použít).

Tento proces vytvoří a uloží profil konfigurace spuštění, který můžete kdykoliv použít k upgradu vaší aplikace. Postará se také o získání nejnovější aktualizované verze typu aplikace ze souboru manifestu aplikace.

Upgrade aplikace trvá několik minut. Průběh upgradu aplikace můžete monitorovat pomocí Service Fabric Exploreru.

Migrace starých aplikací Service Fabric Java pro použití s Mavenem

Nedávno jsme přesunuli knihovny Service Fabric Java ze sady Service Fabric Java SDK do úložiště Maven. Zatímco nové aplikace, které vygenerujete pomocí Eclipse, vygenerují nejnovější aktualizované projekty (které budou moct pracovat s Mavenem), můžete vaše stávající bezstavové aplikace nebo aplikace objektu actor v Javě pro Service Fabric, které dřív používali sadu Service Fabric Java SDK, aktualizovat tak, aby používaly závislosti Service Fabric Java z Mavenu. Abyste zajistili fungování starších aplikací s Mavenem, postupujte podle kroků uvedených tady.

Další kroky

• Rychlé kroky k vytvoření aplikace spolehlivé služby Java a jejímu nasazení místně a do Azure najdete v tématu Rychlý start: Nasazení aplikace Java Reliable Services.
• Informace o ladění aplikace v Javě v místním clusteru najdete v tématu Ladění služby Java v Eclipse.
• Informace o monitorování a diagnostice aplikací Service Fabric najdete v tématu Monitorování a diagnostika služeb v nastavení vývoje místního počítače.