Service Fabric-plugin-program för utveckling av Java-program i Eclipse

Eclipse är en av de mest använda IDE:erna (Integrated Development Environment) för Java-utvecklare. I den här artikeln beskrivs hur du kan konfigurera din Eclipse-utvecklingsmiljö för att arbeta med Azure Service Fabric. Läs om hur du installerar Service Fabric-plugin-programmet, skapar ett Service Fabric-program och distribuerar Service Fabric-programmet till ett lokalt eller fjärranslutet Service Fabric-kluster i Eclipse.

Kommentar

Eclipse-pluginprogrammet stöds för närvarande inte av Windows.

Viktigt!

Kontrollera att JDK 8 är installerat på systemet och valt i Eclipse.

Installera eller uppdatera Service Fabric-plugin-programmet i Eclipse

Du kan installera ett Service Fabric-plugin-program i Eclipse. Plugin-programmet gör det enklare att skapa och distribuera Java-tjänster.

Viktigt!

Plugin-programmet för Service Fabric kräver Eclipse Neon eller en senare version. Efter den här anteckningen följer instruktioner om hur du kontrollerar din Eclipse-version. Om du har en tidigare version av Eclipse installerad kan du hämta nyare versioner från Eclipse-webbplatsen. Vi rekommenderar inte att du installerar en ny version av Eclipse ovanpå en befintlig version (skriver över). Du kan ta bort den gamla versionen innan du kör installationsprogrammet, eller så kan du installera den nya versionen i en annan katalog.

I Ubuntu rekommenderar vi att du installerar direkt från Eclipses webbplats i stället för att använda ett installationspaket (apt eller apt-get). På så sätt kan du vara säker på att du får den senaste versionen av Eclipse.

Installera Eclipse Neon eller senare från Eclipse-webbplatsen. Installera även version 2.2.1 eller senare av Buildship (Service Fabric-plugin-programmet är inte kompatibelt med äldre versioner av Buildship):

• Du kan kontrollera vilka versioner du har av installerade komponenter genom att välja Hjälp>Om Eclipse>Installationsinformation i Eclipse.
• Om du vill uppdatera Buildship kan du läsa Eclipse Buildship: Eclipse-plugin-program för Gradle (på engelska).
• Om du vill söka efter och installera uppdateringar för Eclipse kan du navigera till Help>Check for Updates (Hjälp > Sök efter uppdateringar).

Om du vill installera Service Fabric-plugin-programmet öppnar du Help>Install New Software (Hjälp > Installera ny programvara) i Eclipse.

1. I rutan Work with (Arbeta med) skriver du https://servicefabricdownloads.blob.core.windows.net/eclipse/.

2. Klicka på Lägg till.

   

3. Välj Service Fabric-plugin-programmet och klicka sedan på Next (Nästa).

4. Slutför installationsstegen och acceptera licensvillkoren för programvara från Microsoft.

Om du redan har Service Fabric-plugin-programmet installerat ska du installera den senaste versionen.

1. Om du vill söka efter tillgängliga uppdateringar går du till Hjälp>Om Eclipse>Installationsinformation.
2. Välj Service Fabric i listan över installerade plugin-program och klicka sedan på Update (Uppdatera). Tillgängliga uppdateringar installeras.
3. När du uppdaterar Service Fabrik-plugin-programmet ska du även uppdatera Gradle-projektet. Högerklicka på build.gradle och välj Uppdatera.

Kommentar

Om installationen eller uppdateringen av Service Fabric-plugin-programmet är långsam kan det bero på en Eclipse-inställning. Eclipse samlar in metadata om alla ändringar på uppdateringsplatser som är registrerade med din Eclipse-instans. Om du vill påskynda sökningen efter och installationen av uppdateringen av Service Fabric-plugin-programmet kan du gå till Available Software Sites (Platser med tillgänglig programvara). Avmarkera kryssrutorna för alla platser förutom den som pekar på service fabric-plugin-platsen ('https://servicefabricdownloads.blob.core.windows.net/eclipse/').

Kommentar

Om Eclipse inte fungerar som förväntat på din Mac eller om du måste köra som en superanvändare) går du till mappen ECLIPSE_INSTALLATION_PATH och går till undermappen Eclipse.app/Contents/MacOS. Starta Eclipse genom att köra ./eclipse.

Skapa ett Service Fabric-program i Eclipse

1. Öppna File>New>Other (Arkiv > Nytt > Annat) i Eclipse. Välj Service Fabric Project (Service Fabric Project) och klicka sedan på Next (Nästa).

   

2. Ange ett namn för ditt projekt och klicka sedan på Next (Nästa).

   

3. Välj Service Template (Tjänstmall) i listan med mallar. Välj typ av tjänstmall (Actor (Aktör), Stateless (Tillståndslös), Container (Behållare) eller Guest Binary (Gäst, binär)) och klicka sedan på Next (Nästa).

   

4. Ange namnet på tjänsten och information om tjänsten och klicka sedan på Finish (Slutför).

   

5. När du skapar ditt första Service Fabric-projekt klickar du på Yes (Ja) i dialogrutan Open Associated Perspective (Öppna associerat perspektiv).

   

6. Det nya projektet ser ut så här:

   

Skapa ett Service Fabric-program i Eclipse

1. Högerklicka på det nya Service Fabric-programmet och välj sedan Service Fabric.

   

2. I snabbmenyn väljer du något av följande alternativ:

   • Klicka på Build Application (Bygg program) om du vill skapa programmet utan rensning.
   • Klicka på Rebuild Application (Bygg om program) om du vill skapa en rensad version av programmet.
   • Klicka på Clean Application (Rensa program) om du vill rensa bort byggda artefakter i programmet.

Distribuera ett Service Fabric-program till det lokala klustret med Eclipse

När du har skapat ditt Service Fabric-program följer du de här stegen för att distribuera det till det lokala klustret.

1. Om du inte har startat det lokala klustret följer du anvisningarna i Konfigurera ett lokalt kluster för att starta det lokala klustret och se till att det körs.

2. Högerklicka på ditt Service Fabric-program och välj sedan Service Fabric.

   

3. På snabbmenyn klickar du på Distribuera program.

4. Du kan följa förloppet för distributionsåtgärden i konsolfönstret.

5. Kontrollera att programmet körs genom att öppna Service Fabric Explorer i det lokala klustret i ett webbläsarfönster http://localhost:19080/Explorer. Expandera noden Program och kontrollera att programmet körs.

Information om hur du felsöker ditt program i Eclipse med hjälp av det lokala klustret finns i Felsöka en Java-tjänst i Eclipse.

Du kan också distribuera ditt program till det lokala klustret med kommandot Publicera program :

1. Högerklicka på ditt Service Fabric-program och välj sedan Service Fabric.

2. I snabbmenyn klickar du på Publicera program....

3. I fönstret Publicera program väljer du PublishProfiles/Local.json som målprofil och klickar på Publicera.

   

   Som standard är Local.json publiceringsprofilen konfigurerad för publicering till det lokala klustret. Mer information om de anslutnings- och slutpunktsparametrar som finns i publiceringsprofiler finns i nästa avsnitt.

Publicera ditt Service Fabric-program till Azure med Eclipse

Följ dessa steg för att publicera ditt program i molnet:

1. Om du vill publicera ditt program till ett säkert kluster i molnet behöver du ett X.509-certifikat som ska användas för att kommunicera med klustret. I test- och utvecklingsmiljöer är det certifikat som används ofta klustercertifikatet. I produktionsmiljöer ska certifikatet vara ett klientcertifikat som skiljer sig från klustercertifikatet. Du behöver både certifikatet och den privata nyckeln. Certifikatfilen (och nyckeln) måste vara PEM-formaterad. Du kan skapa en PEM-fil som innehåller certifikatet och den privata nyckeln från en PFX-fil med följande openssl-kommando:

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

   Om PFX-filen inte är lösenordsskyddad använder du --passin pass: för den sista parametern.

2. Öppna filen Cloud.json under katalogen PublishProfiles . Du måste konfigurera klusterslutpunkten och säkerhetsautentiseringsuppgifterna på rätt sätt för klustret.

   • Fältet ConnectionIPOrURL innehåller IP-adressen eller URL:en för klustret. Observera att värdet inte innehåller URL-schemat (https://).

   • Som standard ska fältet ConnectionPort vara 19080, såvida du inte uttryckligen har ändrat den här porten för klustret.

   • Fältet ClientKey ska peka på en PEM-formaterad .pem- eller .key-fil på den lokala datorn som innehåller den privata nyckeln för klienten eller klustercertifikatet.

   • Fältet ClientCert ska peka på en PEM-formaterad .pem- eller .crt-fil på den lokala datorn som innehåller certifikatdata för klienten eller klustret. intyg.

     {
         "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. Högerklicka på ditt Service Fabric-program och välj sedan Service Fabric.

4. I snabbmenyn klickar du på Publicera program....

5. I fönstret Publicera program väljer du PublishProfiles/Cloud.json som målprofil och klickar på Publicera.

   

6. Du kan följa förloppet för publiceringsåtgärden i konsolfönstret.

7. Om du vill kontrollera att programmet körs öppnar du Service Fabric Explorer i Azure-klustret i ett webbläsarfönster. I exemplet ovan skulle detta vara: https://lnxxug0tlqm5.westus.cloudapp.azure.com:19080/Explorer. Expandera noden Program och kontrollera att programmet körs.

Om ditt program innehåller Reliable Services-tjänster på säkra Linux-kluster måste du också konfigurera ett certifikat som dina tjänster kan använda för att anropa Service Fabric-runtime-API:er. Mer information finns i Konfigurera en Reliable Services-app så att den körs på Linux-kluster.

En snabb genomgång av hur du distribuerar ett Service Fabric Reliable Services-program som skrivits i Java till ett säkert Linux-kluster finns i Snabbstart: Distribuera ett Java Reliable Services-program.

Distribuera ett Service Fabric-program med hjälp av Eclipse-körningskonfigurationer

Du kan också distribuera Service Fabric-programmet med Run Configurations (Kör konfigurationer) i Eclipse.

1. I Eclipse går du till Kör>körningskonfigurationer.

2. Välj ServiceFabricDeployer under Gradle Project (Gradle-projekt).

3. I den högra rutan på fliken Argument kontrollerar du att parametrarna ip, port, clientCert och clientKey har angetts korrekt för distributionen. Som standard är parametrarna inställda på att distribueras till det lokala klustret som i följande skärmbild. Om du vill publicera din app till Azure kan du ändra parametrarna så att de innehåller slutpunktsinformation och säkerhetsautentiseringsuppgifter för ditt Azure-kluster. Mer information finns i föregående avsnitt, Publicera ditt Service Fabric-program till Azure med Eclipse.

   

4. Kontrollera att Arbetskatalogen pekar på det program som du vill distribuera. Om du vill ändra program klickar du på knappen Workspace (Arbetsyta) och väljer önskat program.

5. Klicka på Apply (Verkställ) och sedan på Run (Kör).

Ditt program skapas och distribueras efter en liten stund. Du kan övervaka distributionsstatus i Service Fabric Explorer.

Lägga till en Service Fabric-tjänst till ditt Service Fabric-program

Du kan lägga till en Service Fabric-tjänst till ett befintligt Service Fabric-program på följande sätt:

1. Högerklicka på det projekt som du vill lägga till en tjänst för och klicka sedan på Service Fabric.

   

2. Klicka på Add Service Fabric Service (Lägg till Service Fabric-tjänst) och slutför stegen för att lägga till en tjänst i projektet.

3. Välj den tjänstmall som du vill lägga till för projektet och klicka sedan på Next (Nästa).

   

4. Ange namnet på tjänsten (och andra uppgifter om det behövs) och klicka på knappen Add Service (Lägg till tjänst).

   

5. När tjänsten har lagts till ser projektstrukturen ut ungefär så här:

   

Redigera manifestversioner för Service Fabric Java-programmet

Om du vill redigera manifestversioner högerklickar du på projektet, går till Service Fabric och väljer Edit Manifest Versions (Redigera manifestversioner) från listrutan. I guiden kan du uppdatera manifestversioner för programmanifestet, tjänstmanifestet och versioner för paketen Kod, Konfig och Data.

Om du markerar alternativet Automatically update application and service versions (Uppdatera versioner av program och tjänster automatiskt) och sedan uppdaterar en version så uppdateras manifestversionerna automatiskt. Säg att du först markerar kryssrutan och sedan uppdaterar versionen Kod-versionen från 0.0.0 till 0.0.1 och klickar på Slutför. Då uppdateras tjänstemanifestversionen och programmanifestversionen automatiskt till 0.0.1.

Uppgradera ditt Service Fabric Java-program

Anta att du har ett projekt som heter App1 som du har skapat med Service Fabric-plugin-programmet i Eclipse. För att distribuera projektet skapade du ett program med namnet fabric:/App1Application med hjälp av plugin-programmet. Programtypen är App1ApplicationType och programversionen är 1.0. Nu vill du uppgradera programmet utan att det påverkar tillgängligheten.

Gör ändringar i programmet och bygg sedan den ändrade tjänsten på nytt. Uppdatera manifestfilen (ServiceManifest.xml) för den ändrade tjänsten med de uppdaterade versionerna för tjänsten (samt kod, konfig eller data, om det behövs). Ändra också programmets manifest (ApplicationManifest.xml) med det uppdaterade versionsnumret för programmet och den ändrade tjänsten.

Om du vill uppgradera programmet med Eclipse kan du skapa en duplicerad körningskonfigurationsprofil. Sedan kan du använda den för att uppgradera ditt program efter behov.

1. Välj Run>Run Configurations (Kör > Kör konfigurationer). Klicka på den lilla pilen till vänster om Gradle Project (Gradle-projekt) i den vänstra rutan.
2. Högerklicka på ServiceFabricDeployer och välj sedan Duplicate (Duplicera). Ange ett nytt namn för den här konfigurationen, till exempel ServiceFabricUpgrader.
3. På den högra panelen på fliken Argument ändrar du -Pconfig='deploy' till -Pconfig='upgrade' och klickar på Apply (Verkställ).

Därmed skapas och sparas en körningskonfigurationsprofil som du när som helst kan använda till att uppgradera programmet. Då får du också den senast uppdaterade programtypversionen från programmanifestfilen.

Det tar ett par minuter att uppgradera programmet. Du kan övervaka programuppgraderingen i Service Fabric Explorer.

Migrera gamla Service Fabric Java-program som ska användas med Maven

Vi har nyligen flyttat Service Fabric Java-bibliotek från Service Fabric Java-SDK till Maven-centrallager. De nya program som du genererar med hjälp av Eclipse genererar senast uppdaterade projekt (som fungerar med Maven), men du kan uppdatera dina befintliga Service Fabric Java tillståndslösa eller aktörsprogram, som tidigare använde Service Fabric Java SDK, för att använda Service Fabric Java-beroenden från Maven. Följ anvisningarna här för att se till att det äldre programmet fungerar med Maven.

Nästa steg

• Snabbsteg för att skapa Java Reliable-tjänstprogram och distribuera det lokalt och till Azure finns i Snabbstart: Distribuera ett Java Reliable Services-program.
• Information om hur du felsöker ett Java-program i ditt lokala kluster finns i Felsöka en Java-tjänst i Eclipse.
• Mer information om hur du övervakar och diagnostiserar Service Fabric-program finns i Övervaka och diagnostisera tjänster i en lokal datorutvecklingskonfiguration.