Service Fabric-invoegtoepassing voor ontwikkeling van Eclipse Java-toepassingen

Eclipse is een van de meest gebruikte geïntegreerde ontwikkelomgevingen (IDE's) voor Java-ontwikkelaars. In dit artikel wordt beschreven hoe u uw Eclipse-ontwikkelomgeving instelt voor gebruik met Azure Service Fabric. Meer informatie over het installeren van de Service Fabric-invoegtoepassing, het maken van een Service Fabric-toepassing en het implementeren van uw Service Fabric-toepassing in een lokaal of extern Service Fabric-cluster in Eclipse.

Opmerking

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-plug-in installeren of bijwerken in Eclipse

U kunt een Service Fabric-invoegtoepassing installeren in Eclipse. De invoegtoepassing kan het proces van het bouwen en implementeren van Java-services vereenvoudigen.

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 niet aanbevolen om Eclipse te installeren op een bestaande installatie (en deze daarmee overschrijven). U kunt deze verwijderen voordat u het installatieprogramma uitvoert of de nieuwere versie in een andere map installeren.

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):

• Als u de versies van geïnstalleerde onderdelen wilt controleren, gaat u in Eclipse naar Help>overEclipse-installatiedetails>.
• Als u Buildship wilt bijwerken, raadpleegt u Eclipse Buildship: Eclipse-invoegtoepassingen voor Gradle.
• Als u updates voor Eclipse wilt controleren en installeren, gaat u naar Help>controleren op updates.

Installeer de Service Fabric-invoegtoepassing in Eclipse en ga naar Help Nieuwe>software installeren.

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

2. Klik op Toevoegen.

   

3. Selecteer de Service Fabric-invoegtoepassing en klik vervolgens op Volgende.

4. Voltooi de installatiestappen en accepteer vervolgens de licentievoorwaarden voor Microsoft-software.

Als u de Service Fabric-invoegtoepassing al hebt geïnstalleerd, installeert u de nieuwste versie.

1. Als u wilt controleren op beschikbare updates, gaat u naar Help>overEclipse-installatiedetails>.
2. Selecteer Service Fabric in de lijst met geïnstalleerde invoegtoepassingen en klik vervolgens op Bijwerken. Beschikbare updates worden geïnstalleerd.
3. Nadat u de Service Fabric-invoegtoepassing hebt bijgewerkt, vernieuwt u ook het Gradle-project. Klik met de rechtermuisknop op build.gradle en selecteer Vernieuwen.

Opmerking

Als het installeren of bijwerken van de Service Fabric-invoegtoepassing traag is, kan dit worden veroorzaakt door een Eclipse-instelling. Eclipse verzamelt metagegevens over alle wijzigingen in het bijwerken van sites die zijn geregistreerd bij uw Eclipse-exemplaar. Om het proces voor het controleren op en installeren van een update van een Service Fabric-invoegtoepassing te versnellen, ga naar Beschikbare softwaresites. 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/

Opmerking

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

Een Service Fabric-toepassing maken in Eclipse

1. Ga in Eclipse naar File>New>Other. Selecteer Service Fabric-project en klik vervolgens op Volgende.

   

2. Voer een naam in voor uw project en klik vervolgens op Volgende.

   

3. Selecteer Servicesjabloon in de lijst met sjablonen. Selecteer het type servicesjabloon (Actor, Stateless, Container of Guest Binary) en klik vervolgens op Volgende.

   

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

   

5. Wanneer u uw eerste Service Fabric-project maakt, klikt u in het dialoogvenster Gekoppeld perspectief openen op Ja.

   

6. Uw nieuwe project ziet er als volgt uit:

   

Een Service Fabric-toepassing bouwen in Eclipse

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

   

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

   • Als u de toepassing wilt bouwen zonder op te schonen, klikt u op Toepassing bouwen.
   • Als u een schone build van de toepassing wilt uitvoeren, klikt u op Toepassing opnieuw opbouwen.
   • Als u de toepassing van ingebouwde artefacten wilt opschonen, klikt u op Toepassing opschonen.

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 publicerende 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 publicerende 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

Een alternatieve manier om uw Service Fabric-toepassing te implementeren, is met behulp van Eclipse-uitvoeringsconfiguraties.

1. Ga in Eclipse naar Run>Configurations uitvoeren.

2. Selecteer onder Gradle Project de serviceFabricDeployer-uitvoeringsconfiguratie .

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 Werkruimte en selecteert u vervolgens de gewenste toepassing.

5. Klik op Toepassen en klik vervolgens op Uitvoeren.

Uw toepassing bouwt en implementeert binnen enkele ogenblikken. U kunt de implementatiestatus bewaken in Service Fabric Explorer.

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

Ga als volgt te werk om een Service Fabric-service toe te voegen aan een bestaande Service Fabric-toepassing:

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

   

2. Klik op Service Fabric Service toevoegen en voltooi de reeks stappen om een service aan het project toe te voegen.

3. Selecteer de servicesjabloon die u aan uw project wilt toevoegen en klik vervolgens op Volgende.

   

4. Voer de servicenaam (en andere details, indien nodig) in en klik vervolgens op de knop Service toevoegen .

   

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 Manifestversies bewerken... in de vervolgkeuzelijst van het menu. In de wizard kunt u de manifestversies bijwerken voor toepassingsmanifest, servicemanifest en de versies voor code-, configuratie - en gegevenspakketten .

Als u de optie Toepassings- en serviceversies automatisch bijwerken aanvinkt en vervolgens een versie bijwerkt, worden de manifestversies automatisch bijgewerkt. Als u een voorbeeld wilt geven, schakelt u eerst het selectievakje in en werkt u vervolgens de versie van de codeversie bij van 0.0.0 naar 0.0.1 en klikt u op Voltooien. Vervolgens wordt de versie van het servicemanifest en de versie van het toepassingsmanifest automatisch bijgewerkt naar 0.0.1.

Uw Service Fabric Java-toepassing upgraden

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

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

Als u uw toepassing wilt upgraden met behulp van Eclipse, kunt u een dubbel uitvoeringsconfiguratieprofiel maken. Gebruik deze vervolgens om uw toepassing zo nodig te upgraden.

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

Met dit proces wordt een uitvoeringsconfiguratieprofiel gemaakt en opgeslagen dat u op elk gewenst moment kunt gebruiken om uw toepassing bij te werken. Er wordt ook de meest recente bijgewerkte versie van het toepassingstype opgehaald uit het manifestbestand van de toepassing.

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

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

We hebben onlangs Service Fabric Java-bibliotheken van De Service Fabric Java SDK verplaatst naar de Maven-opslagplaats. Terwijl de nieuwe toepassingen die u genereert met behulp van Eclipse de nieuwste bijgewerkte projecten zullen genereren (die met Maven kunnen werken), kunt u uw bestaande stateless- of actortoepassingen in Java, die eerder gebruikmaakten van de Service Fabric Java SDK, bijwerken om de Service Fabric Java-afhankelijkheden van Maven te gebruiken. Volg de stappen die hier worden vermeld om ervoor te zorgen dat uw 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 Het bewaken en diagnosticeren van services in een lokale machine-ontwikkelomgeving om te leren hoe u Service Fabric-toepassingen kunt bewaken en diagnosticeren.