Service Fabric-invoegtoepassing voor de ontwikkeling van Eclipse Java-toepassingen

Eclipse is een van de meest gebruikte Integrated Development Environments (IDE's) voor Java-ontwikkelaars. In dit artikel wordt beschreven hoe u een Eclipse-ontwikkelomgeving instelt voor gebruik met Azure Service Fabric. Ontdek hoe u de Service Fabric-invoegtoepassing installeert en een Service Fabric-toepassing implementeert in een lokaal of extern Service Fabric-cluster in Eclipse.

Notitie

De Eclipse-invoegtoepassing wordt momenteel niet ondersteund in Windows.

Belangrijk

Zorg ervoor dat JDK 8 is geïnstalleerd op het systeem en is geselecteerd in Eclipse.

De Service Fabric-invoegtoepassing installeren of bijwerken in Eclipse

U kunt een Service Fabric-invoegtoepassing in Eclipse installeren. De invoegtoepassing vereenvoudigt het proces voor het maken en implementeren van Java-services.

Belangrijk

Voor de Service Fabric-invoegtoepassing is Eclipse Neon of een hogere versie vereist. Zie de instructies na deze opmerking voor het controleren van uw Eclipse-versie. Als er een oudere versie van Eclipse is geïnstalleerd, kunt u een nieuwere versie downloaden van de site van Eclipse. Het wordt afgeraden een oudere versie van Eclipse te overschrijven met een nieuwere versie. Verwijder de oudere versie voordat u het installatieprogramma uitvoert of installeer de nieuwe versie in een andere map.

Voor Ubuntu wordt u aangeraden de installatie rechtstreeks vanaf de site van Eclipse uit te voeren en niet door middel van een installatieprogramma voor pakketten (apt of apt-get). Daardoor weet u zeker dat u de meest recente versie van Eclipse hebt.

Installeer Eclipse Neon of hoger vanaf de Eclipse-site. Installeer ook versie 2.2.1 of hoger van Buildship (de Service Fabric-invoegtoepassing is niet compatibel met oudere versies van Buildship):

• U kunt de versies van geïnstalleerde onderdelen controleren door in Eclipse Help>About Eclipse>Installation Details te kiezen.
• Zie Eclipse Buildship: Eclipse Plug-ins for Gradle (Eclipse Buildship: Eclipse-invoegtoepassingen voor Gradle) als u Buildship wilt bijwerken.
• Als u updates voor Eclipse wilt zoeken en installeren, gaat u naar Help>Check for Updates.

Als u de Service Fabric-invoegtoepassing wilt installeren, gaat u in Eclipse naar Help>Install New Software.

1. In het vak Work with voert u https://servicefabricdownloads.blob.core.windows.net/eclipse/ in.

2. Klik op Toevoegen.

   

3. Selecteer de Fabric Service-invoegtoepassing en klik op Next.

4. Voer de installatiestappen uit en accepteer de licentievoorwaarden voor Microsoft-software.

Als u de Service Fabric-invoegtoepassing al hebt geïnstalleerd, zorgt u ervoor dat u de meest recente versie hebt geïnstalleerd.

1. Ga naar Help>About Eclipse>Installation Details om te controleren of er updates beschikbaar zijn.
2. Selecteer Service Fabric in de lijst met geïnstalleerde invoegtoepassingen en klik op Update. Beschikbare updates worden geïnstalleerd.
3. Als u de Service Fabric-invoegtoepassing bijwerkt, moet u ook het Gradle-project vernieuwen. Klik met de rechtermuisknop op build.gradle en selecteer vervolgens Vernieuwen.

Notitie

Als de installatie of update van de Service Fabric-invoegtoepassing traag verloopt, kan dit het gevolg zijn van een instelling in Eclipse. Eclipse verzamelt metagegevens over alle wijzigingen in updatesites die zijn geregistreerd bij uw exemplaar van Eclipse. Als u het proces voor het controleren op en installeren van updates van Service Fabric-invoegtoepassingen wilt versnellen, gaat u naar Available Software Sites. Schakel de selectievakjes voor alle sites uit, met uitzondering van de site die verwijst naar de locatie van de Service Fabric-invoegtoepassing ('').https://servicefabricdownloads.blob.core.windows.net/eclipse/

Notitie

Als Eclipse op uw Mac niet werkt zoals u verwacht of als u het moet uitvoeren als supergebruiker), gaat u naar de map ECLIPSE_INSTALLATION_PATH en vervolgens naar de submap Eclipse.app/Contents/MacOS. Start Eclipse door ./eclipse uit te voeren.

Een Service Fabric-toepassing maken in Eclipse

1. Ga in Eclipse naar File>New>Other. Selecteer Fabric Service Project en klik op Next.

   

2. Voer een naam in voor het project en klik op Next.

   

3. Selecteer Service Template in de lijst met sjablonen. Selecteer het type servicesjabloon (Actor, Stateless, Container of Guest Binary) en klik op Next.

   

4. Voer de servicenaam en servicegegevens in en klik op Finish.

   

5. Wanneer u uw eerste Service Fabric-project maakt, klikt u in het dialoogvenster Open Associated Perspective op Yes.

   

6. Het nieuwe project ziet er als volgt uit:

   

Een Service Fabric-toepassing bouwen in Eclipse

1. Klik met de rechtermuisknop op de nieuwe Service Fabric-toepassing en selecteer Service Fabric.

   

2. Selecteer in het contextmenu een van de volgende opties:

   • Klik op Build Application als u de toepassing wilt maken zonder op te schonen.
   • Klik op Rebuild Application als u een schone build van de toepassing wilt maken.
   • Klik op Clean Application als u de gebouwde artefacts uit de toepassing wilt verwijderen.

Een Service Fabric-toepassing implementeren in het lokale cluster met Eclipse

Nadat u uw Service Fabric-toepassing hebt gemaakt, volgt u deze stappen om deze te implementeren in het lokale cluster.

1. Als u het lokale cluster nog niet hebt gestart, volgt u de instructies in Een lokaal cluster instellen om uw lokale cluster te starten en ervoor te zorgen dat het wordt uitgevoerd.

2. Klik met de rechtermuisknop op uw Service Fabric-toepassing en selecteer Vervolgens Service Fabric.

   

3. Klik in het contextmenu op Toepassing implementeren.

4. U kunt de voortgang van de implementatiebewerking volgen in het consolevenster.

5. Als u wilt controleren of uw toepassing wordt uitgevoerd, opent u Service Fabric Explorer op uw lokale cluster in een browservenster http://localhost:19080/Explorer. Vouw het knooppunt Toepassingen uit en controleer of uw toepassing wordt uitgevoerd.

Zie Fouten opsporen in een Java-service in Eclipse voor meer informatie over het opsporen van fouten in uw toepassing in Eclipse met behulp van het lokale cluster.

U kunt uw toepassing ook implementeren in het lokale cluster met de opdracht Toepassing publiceren:

1. Klik met de rechtermuisknop op uw Service Fabric-toepassing en selecteer Vervolgens Service Fabric.

2. Klik in het contextmenu op Toepassing publiceren....

3. Kies In het venster Toepassing publiceren de optie PublishProfiles/Local.json als doelprofiel en klik op Publiceren.

   

   Het Local.json publicatieprofiel is standaard ingesteld om te publiceren naar het lokale cluster. Zie de volgende sectie voor meer informatie over de verbindings- en eindpuntparameters die aanwezig zijn in publicatieprofielen.

Uw Service Fabric-toepassing publiceren naar Azure met Eclipse

Voer de volgende stappen uit om uw toepassing naar de cloud te publiceren:

1. Als u uw toepassing wilt publiceren naar een beveiligd cluster in de cloud, hebt u een X.509-certificaat nodig om te communiceren met uw cluster. In test- en ontwikkelomgevingen is het gebruikte certificaat vaak het clustercertificaat. In productieomgevingen moet het certificaat een clientcertificaat zijn dat verschilt van het clustercertificaat. U hebt zowel het certificaat als de persoonlijke sleutel nodig. Het certificaatbestand (en sleutelbestand) moet zijn geformatteerd met PEM. U kunt een PEM-bestand maken dat het certificaat en de persoonlijke sleutel van een PFX-bestand bevat met de volgende openssl-opdracht:

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

   Als het PFX-bestand niet met een wachtwoord is beveiligd, gebruikt --passin pass: u dit voor de laatste parameter.

2. Open het Cloud.json bestand onder de map PublishProfiles . U moet het clustereindpunt en de beveiligingsreferenties op de juiste wijze configureren voor uw cluster.

   • Het ConnectionIPOrURL veld bevat het IP-adres of de URL van uw cluster. Houd er rekening mee dat de waarde het URL-schema (https://) niet bevat.

   • Het veld moet standaard ConnectionPort zijn 19080, tenzij u deze poort expliciet voor uw cluster hebt gewijzigd.

   • Het ClientKey veld moet verwijzen naar een PEM-bestand met PEM-indeling of .key bestand op uw lokale computer met de persoonlijke sleutel voor uw client- of clustercertificaat.

   • Het ClientCert veld moet verwijzen naar een PEM- of CRT-bestand met PEM-indeling op uw lokale computer met de certificaatgegevens voor uw client of cluster. certificaat.

     {
         "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. Klik met de rechtermuisknop op uw Service Fabric-toepassing en selecteer Vervolgens Service Fabric.

4. Klik in het contextmenu op Toepassing publiceren....

5. Kies In het venster Toepassing publiceren de optie PublishProfiles/Cloud.json als doelprofiel en klik op Publiceren.

   

6. U kunt de voortgang van de publicatiebewerking volgen in het consolevenster.

7. Als u wilt controleren of uw toepassing wordt uitgevoerd, opent u Service Fabric Explorer in uw Azure-cluster in een browservenster. In het bovenstaande voorbeeld is dit: https://lnxxug0tlqm5.westus.cloudapp.azure.com:19080/Explorer. Vouw het knooppunt Toepassingen uit en controleer of uw toepassing wordt uitgevoerd.

Als uw toepassing Reliable Services-services bevat, moet u op beveiligde Linux-clusters ook een certificaat configureren dat uw services kunnen gebruiken om Service Fabric Runtime-API's aan te roepen. Zie Een Reliable Services-app configureren voor uitvoering op Linux-clusters voor meer informatie.

Zie quickstart: Een Java Reliable Services-toepassing implementeren die is geschreven in Java voor een beknopt overzicht van het implementeren van een Service Fabric Reliable Services-toepassing die in Java is geschreven in een beveiligd Linux-cluster.

Een Service Fabric-toepassing implementeren met behulp van Eclipse-uitvoeringsconfiguraties

U kunt de Service Fabric-toepassing ook implementeren met behulp van Eclipse-uitvoerconfiguraties.

1. Ga in Eclipse naar Run>Configurations uitvoeren.

2. Selecteer onder Gradle Project de uitvoerconfiguratie ServiceFabricDeployer.

3. Controleer in het rechterdeelvenster op het tabblad Argumenten of de parameters IP, poort, clientCert en clientKey op de juiste wijze zijn ingesteld voor uw implementatie. Standaard worden de parameters ingesteld om te implementeren in het lokale cluster, zoals in de volgende schermopname. Als u uw app naar Azure wilt publiceren, kunt u de parameters wijzigen zodat deze de eindpuntgegevens en beveiligingsreferenties voor uw Azure-cluster bevatten. Zie de vorige sectie, Uw Service Fabric-toepassing publiceren naar Azure met Eclipse voor meer informatie.

   

4. Zorg ervoor dat Werkmap verwijst naar de toepassing die u wilt implementeren. Als u de toepassing wilt wijzigen, klikt u op de knop Workspace en selecteert u de gewenste toepassing.

5. Klik op Apply en vervolgens op Run.

De toepassing is binnen enkele ogenblikken gemaakt en geïmplementeerd. U kunt de implementatiestatus controleren in Service Fabric Explorer.

Een Service Fabric-service toevoegen aan uw Service Fabric-toepassing

Voer de volgende stappen uit als u een Service Fabric-service aan een bestaande Service Fabric-toepassing wilt toevoegen:

1. Klik met de rechtermuisknop op het project waaraan u een service wilt toevoegen en klik vervolgens op Service Fabric.

   

2. Klik op Add Service Fabric Service en voer de stappen uit om een service aan het project toe te voegen.

3. Selecteer de servicesjabloon die u aan het project wilt toevoegen en klik op Next.

   

4. Voer de servicenaam (en andere gevraagde informatie) in en klik op de knop Add Service.

   

5. Nadat de service is toegevoegd, ziet de algehele projectstructuur er ongeveer als volgt uit:

   

Manifestversies van uw Service Fabric Java-toepassing bewerken

Als u manifestversies wilt bewerken, klikt u met de rechtermuisknop op het project, gaat u naar Service Fabric en selecteert u Edit Manifest Versions... in de vervolgkeuzelijst. In de wizard kunt u de manifestversies bijwerken voor het toepassingsmanifest, servicemanifest en de versies voor de pakketten Code, Config en Data.

Als u de optie Automatically update application and service versions inschakelt en vervolgens een versie bijwerkt, worden de manifestversies automatisch bijgewerkt. Als u bijvoorbeeld eerst het selectievakje inschakelt, vervolgens de versie van Code bijwerkt van 0.0.0 naar 0.0.1 en op Finish klikt, worden de versies van het servicemanifest en toepassingsmanifest automatisch bijgewerkt naar 0.0.1.

Uw Service Fabric Java-toepassing upgraden

Stel dat u voor een upgradescenario het project App1 hebt gemaakt met behulp van de Service Fabric-invoegtoepassing in Eclipse. U hebt dit vervolgens met behulp van de invoegtoepassing geïmplementeerd om een toepassing met de naam fabric:/App1Application te maken. Het toepassingstype is App1ApplicationType en de toepassingsversie is 1.0. Nu wilt u een toepassingsupgrade uitvoeren zonder de beschikbaarheid van de toepassing te onderbreken.

Breng eerst eventuele wijzigingen aan in de toepassing en bouw vervolgens de gewijzigde service opnieuw op. Werk het manifestbestand van de gewijzigde service (ServiceManifest.xml) bij met de bijgewerkte versies voor de service (en code, configuratie of gegevens, indien van toepassing). Wijzig ook het toepassingsmanifest (ApplicationManifest.xml) met het bijgewerkte versienummer voor de toepassing en de gewijzigde service.

Als u de toepassingsupgrade wilt uitvoeren met behulp van Eclipse, kunt u een dubbel uitvoerconfiguratieprofiel maken. Vervolgens gebruikt u dit om de toepassingsupgrade uit te voeren.

1. Ga naar Run>Run Configurations. Klik in het linkerdeelvenster op de kleine pijl, links van Gradle Project.
2. Klik met de rechtermuisknop op ServiceFabricDeployer en selecteer Duplicate. Voer een nieuwe naam in voor deze configuratie, bijvoorbeeld ServiceFabricUpgrader.
3. Ga in het rechterdeelvenster naar het tabblad Arguments en wijzig -Pconfig='deploy' in -Pconfig=upgrade. Klik vervolgens op Apply.

Met dit proces wordt een uitvoerconfiguratieprofiel gemaakt en opgeslagen dat u op elk gewenst moment kunt gebruiken om een upgrade van uw toepassing uit te voeren. Hiermee wordt ook de laatst bijgewerkte versie van het toepassingstype opgehaald uit het manifest-bestand van de toepassing.

De toepassingsupgrade duurt enkele minuten. U kunt de upgrade van de toepassing bewaken in Service Fabric Explorer.

Oude Service Fabric Java-toepassingen migreren die moeten worden gebruikt met Maven

We hebben onlangs de bibliotheken van Java Service Fabric verplaatst van de Service Fabric Java SDK naar de Maven-opslagplaats. De nieuwe toepassingen die u genereert met behulp van Eclipse produceren projecten die u zonder problemen kunt gebruiken met Maven. Uw bestaande stateless Service Fabric- of Java-actortoepassingen zult u echter moeten bijwerken om ze te laten werken met de Service Fabric Java-afhankelijkheden van Maven. Deze oudere toepassingen maken namelijk nog gebruik van de Service Fabric Java SDK. Volg deze stappen om te controleren of een oudere toepassing werkt met Maven.

Volgende stappen

• Zie quickstart: Een Java Reliable Services-toepassing implementeren voor snelle stappen voor het bouwen van een Java Reliable-servicetoepassing en het lokaal implementeren ervan in Azure.
• Zie Fouten opsporen in een Java-service in Eclipse voor meer informatie over het opsporen van fouten in een Java-toepassing in uw lokale cluster.
• Zie Service Fabric-toepassingen bewaken en diagnosticeren in een installatie voor het ontwikkelen van lokale machines voor meer informatie over het bewaken en diagnosticeren van services.