Service Fabric-Plug-In für die Entwicklung von Eclipse-Java-AnwendungenService Fabric plug-in for Eclipse Java application development

Eclipse ist eine der am häufigsten genutzten IDEs (Integrated Development Environments) für Java-Entwickler.Eclipse is one of the most widely used integrated development environments (IDEs) for Java developers. In diesem Artikel wird beschrieben, wie Sie Ihre Eclipse-Entwicklungsumgebung für Azure Service Fabric einrichten.In this article, we describe how to set up your Eclipse development environment to work with Azure Service Fabric. Hier erfahren Sie, wie Sie das Service Fabric-Plug-In installieren, eine Service Fabric-Anwendung erstellen und Ihre Service Fabric-Anwendung in einem lokalen Service Fabric-Cluster oder Service Fabric-Remotecluster in Eclipse bereitstellen.Learn how to install the Service Fabric plug-in, create a Service Fabric application, and deploy your Service Fabric application to a local or remote Service Fabric cluster in Eclipse.

Hinweis

Das Eclipse-Plug-In wird unter Windows aktuell nicht unterstützt.The Eclipse plugin is currently not supported on Windows.

Wichtig

Stellen Sie sicher, dass JDK 8 auf dem System installiert und in Eclipse ausgewählt ist.Be sure JDK 8 is installed on the system and selected in Eclipse.

Installieren oder Aktualisieren des Service Fabric-Plug-Ins in EclipseInstall or update the Service Fabric plug-in in Eclipse

Sie können ein Service Fabric-Plug-In in Eclipse installieren.You can install a Service Fabric plug-in in Eclipse. Das Plug-In kann dazu beitragen, den Prozess der Erstellung und Bereitstellung von Java-Diensten zu vereinfachen.The plug-in can help simplify the process of building and deploying Java services.

Wichtig

Für das Service Fabric-Plug-In ist Eclipse Neon oder eine höhere Version erforderlich.The Service Fabric plug-in requires Eclipse Neon or a later version. Wie Sie Ihre Version von Eclipse überprüfen, erfahren Sie in der Anleitung im Anschluss an diesen Hinweis.See the instructions that follow this note for how to check your version of Eclipse. Falls Sie eine ältere Version von Eclipse installiert haben, können Sie neuere Versionen von der Eclipse-Website herunterladen.If you have an earlier version of Eclipse installed, you can download more recent versions from the Eclipse site. Es wird davon abgeraten, eine bereits vorhandene Installation von Eclipse durch eine neue Installation zu überschreiben.It is not recommended that you install on top of (overwrite) an existing installation of Eclipse. Entfernen Sie entweder die ältere Version, bevor Sie das Installationsprogramm ausführen, oder installieren Sie die neuere Version in einem anderen Verzeichnis.You can either remove it before running the installer or install the newer version in a different directory.

Unter Ubuntu sollten Sie die Installation direkt über die Eclipse-Website ausführen, anstatt ein Paketinstallationsprogramm (apt oder apt-get) zu verwenden.On Ubuntu, we recommend installing directly from the Eclipse site rather than using a package installer (apt or apt-get). Dadurch wird sichergestellt, dass Sie die neueste Version von Eclipse erhalten.Doing so ensures that you get the most current version of Eclipse.

Installieren Sie Eclipse Neon oder eine höhere Version (erhältlich auf der Eclipse-Website).Install Eclipse Neon or later from the Eclipse site. Installieren Sie außerdem mindestens Version 2.2.1 von Buildship. (Das Service Fabric-Plug-In ist mit älteren Versionen von Buildship nicht kompatibel.)Also install version 2.2.1 or later of Buildship (the Service Fabric plug-in is not compatible with older versions of Buildship):

  • Die Versionen der installierten Komponenten können Sie in Eclipse unter Hilfe > Über Eclipse > Installationsdetails überprüfen.To check the versions of installed components, in Eclipse, go to Help > About Eclipse > Installation Details.
  • Informationen zum Aktualisieren von Buildship finden Sie unter Eclipse Buildship: Eclipse-Plug-Ins für Gradle.To update Buildship, see Eclipse Buildship: Eclipse Plug-ins for Gradle.
  • Unter Hilfe > Nach Updates suchen können Sie nach Updates für Eclipse suchen und diese installieren.To check for and install updates for Eclipse, go to Help > Check for Updates.

Installieren Sie das Service Fabric-Plug-In. Navigieren Sie hierzu in Eclipse zu Hilfe > Install New Software (Neue Software installieren).Install the Service Fabric plug-in, in Eclipse, go to Help > Install New Software.

  1. Geben Sie im Feld Arbeiten Sie mit die URL http://dl.microsoft.com/eclipse ein.In the Work with box, enter https://dl.microsoft.com/eclipse.

  2. Klicken Sie auf Hinzufügen.Click Add.

    Service Fabric-Plug-In für Eclipse

  3. Wählen Sie das Service Fabric-Plug-In aus, und klicken Sie auf Weiter.Select the Service Fabric plug-in, and then click Next.

  4. Führen Sie die Schritte für die Installation aus, und akzeptieren Sie die Microsoft-Software-Lizenzbedingungen.Complete the installation steps, and then accept the Microsoft Software License Terms.

Falls Sie das Service Fabric-Plug-In bereits installiert haben, installieren Sie die aktuelle Version.If you already have the Service Fabric plug-in installed, install the latest version.

  1. Unter Hilfe > Über Eclipse > Installationsdetails können Sie prüfen, ob Updates verfügbar sind.To check for available updates, go to Help > About Eclipse > Installation Details.
  2. Wählen Sie in der Liste mit den installierten Plug-Ins die Option „Service Fabric“, und klicken Sie auf Aktualisieren.In the list of installed plug-ins, select Service Fabric, and then click Update. Die verfügbaren Updates werden installiert.Available updates will be installed.
  3. Aktualisieren Sie nach der Aktualisierung des Service Fabric-Plug-Ins auch das Gradle-Projekt.Once you update the Service Fabric plug-in, also refresh the Gradle project. Klicken Sie mit der rechten Maustaste auf build.gradle, und klicken Sie auf Aktualisieren.Right click build.gradle, then select Refresh.

Hinweis

Wenn das Installieren oder Aktualisieren des Service Fabric-Plug-Ins lange dauert, kann dies an einer Eclipse-Einstellung liegen.If installing or updating the Service Fabric plug-in is slow, it might be due to an Eclipse setting. In Eclipse werden Metadaten zu allen Änderungen von Updatewebsites gesammelt, die für Ihre Eclipse-Instanz registriert sind.Eclipse collects metadata on all changes to update sites that are registered with your Eclipse instance. Navigieren Sie zu Available Software Sites (Verfügbare Softwarestandorte), um das Vorhandensein eines Updates für das Service Fabric-Plug-In zu prüfen und das Update zu installieren.To speed up the process of checking for and installing a Service Fabric plug-in update, go to Available Software Sites. Deaktivieren Sie die Kontrollkästchen für alle Websites, mit Ausnahme des Kontrollkästchens, das auf den Speicherort des Service Fabric-Plug-Ins (http://dl.microsoft.com/eclipse/azure/servicefabric) verweist.Clear the check boxes for all sites except for the one that points to the Service Fabric plug-in location (https://dl.microsoft.com/eclipse/azure/servicefabric).

Hinweis

Sollte Eclipse auf Ihrem Mac nicht wie erwartet funktioniert oder die Ausführung als Administrator voraussetzen, navigieren Sie zum Ordner ECLIPSE_INSTALLATION_PATH und dort zum Unterordner Eclipse.app/Contents/MacOS.If Eclipse isn't working as expected on your Mac, or needs you run as super user), go to the ECLIPSE_INSTALLATION_PATH folder and navigate to the subfolder Eclipse.app/Contents/MacOS. Führen Sie ./eclipse aus, um Eclipse zu starten.Start Eclipse by running ./eclipse.

Erstellen einer Service Fabric-Anwendung in EclipseCreate a Service Fabric application in Eclipse

  1. Navigieren Sie in Eclipse zu Datei > Neu > Other (Andere).In Eclipse, go to File > New > Other. Wählen Sie die Option Service Fabric-Projekt, und klicken Sie dann auf Weiter.Select Service Fabric Project, and then click Next.

    Service Fabric – Neues Projekt – Seite 1

  2. Geben Sie einen Namen für Ihr Projekt ein, und klicken Sie auf Weiter.Enter a name for your project, and then click Next.

    Service Fabric – Neues Projekt – Seite 2

  3. Wählen Sie in der Liste mit den Vorlagen die Option Dienstvorlage.In the list of templates, select Service Template. Wählen Sie den Typ der Dienstvorlage (Akteur, Zustandslos, Container oder Binäre Gastdatei), und klicken Sie auf Weiter.Select your service template type (Actor, Stateless, Container, or Guest Binary), and then click Next.

    Service Fabric – Neues Projekt – Seite 3

  4. Geben Sie den Dienstnamen und die Dienstdetails ein, und klicken Sie auf Fertig stellen.Enter the service name and service details, and then click Finish.

    Service Fabric – Neues Projekt – Seite 4

  5. Klicken Sie beim Erstellen Ihres ersten Service Fabric-Projekts im Dialogfeld Open Associated Perspective (Zugeordnete Perspektive öffnen) auf Ja.When you create your first Service Fabric project, in the Open Associated Perspective dialog box, click Yes.

    Service Fabric – Neues Projekt – Seite 5

  6. Das neue Projekt sieht wie folgt aus:Your new project looks like this:

    Service Fabric – Neues Projekt – Seite 6

Erstellen einer Service Fabric-Anwendung in EclipseBuild a Service Fabric application in Eclipse

  1. Klicken Sie mit der rechten Maustaste auf Ihre neue Service Fabric-Anwendung, und wählen Sie dann die Option Service Fabric.Right-click your new Service Fabric application, and then select Service Fabric.

    Service Fabric-Kontextmenü

  2. Wählen Sie im Kontextmenü eine der folgenden Optionen aus:In the context menu, select one of the following options:

    • Klicken Sie auf Build Application (Anwendung erstellen), um die Anwendung ohne Bereinigung zu erstellen.To build the application without cleaning, click Build Application.
    • Klicken Sie auf Rebuild Application (Anwendung erneut erstellen), um eine bereinigte Erstellung der Anwendung durchzuführen.To do a clean build of the application, click Rebuild Application.
    • Klicken Sie auf Clean Application (Anwendung bereinigen), um die Anwendung in Bezug auf die Buildartefakte zu bereinigen.To clean the application of built artifacts, click Clean Application.

Bereitstellen einer Service Fabric-Anwendung im lokalen Cluster mit EclipseDeploy a Service Fabric application to the local cluster with Eclipse

Nachdem Sie Ihre Service Fabric-Anwendung erstellt haben, gehen Sie folgendermaßen vor, um sie im lokalen Cluster bereitzustellen.After you have built your Service Fabric application, follow these steps to deploy it to the local cluster.

  1. Wenn Sie den lokalen Cluster nicht gestartet haben, befolgen Sie die Anweisungen in Einrichten eines lokalen Clusters, um Ihren lokalen Cluster zu starten und sicherzustellen, dass er ausgeführt wird.If you haven't started the local cluster, follow the instructions in Set up a local cluster to start your local cluster and make sure that it is running.

  2. Klicken Sie mit der rechten Maustaste auf Ihre Service Fabric-Anwendung, und wählen Sie dann die Option Service Fabric aus.Right-click your Service Fabric application, and then select Service Fabric.

    Service Fabric-Kontextmenü

  3. Klicken Sie im Kontextmenü auf Anwendung bereitstellen.From the context menu, click Deploy Application.

  4. Sie können den Fortschritt des Bereitstellungsvorgangs im Konsolenfenster verfolgen.You can follow the progress of the deploy operation in the Console window.

  5. Um sicherzustellen, dass Ihre Anwendung ausgeführt wird, öffnen Sie den Service Fabric Explorer in Ihrem lokalen Cluster in einem Browserfenster http://localhost:19080/Explorer.To verify that your application is running, open Service Fabric Explorer on your local cluster in a browser window http://localhost:19080/Explorer. Erweitern Sie den Knoten Anwendungen, und stellen Sie sicher, dass die Anwendung ausgeführt wird.Expand the Applications node and make sure your application is running.

Wie Sie Ihre Anwendung in Eclipse mit dem lokalen Cluster debuggen, lernen Sie unter Debuggen eines Java-Diensts in Eclipse.To learn how to debug your application in Eclipse using the local cluster, see Debug a Java service in Eclipse.

Sie können Ihre Anwendung auch mit dem Befehl Anwendung veröffentlichen im lokalen Cluster bereitstellen:You can also deploy your application to the local cluster with the Publish Application command:

  1. Klicken Sie mit der rechten Maustaste auf Ihre Service Fabric-Anwendung, und wählen Sie dann die Option Service Fabric aus.Right-click your Service Fabric application, and then select Service Fabric.

  2. Klicken Sie im Kontextmenü auf Anwendung veröffentlichen...From the context menu, click Publish Application....

  3. Wählen Sie im Fenster Anwendung veröffentlichen als Zielprofil PublishProfiles/Local.json aus, und klicken Sie auf Veröffentlichen.In the Publish Application window, choose PublishProfiles/Local.json as the Target Profile and click Publish.

    Lokales Dialogfeld „Veröffentlichen“

    Standardmäßig wird das Veröffentlichungsprofil „Local.json“ zur Veröffentlichung im lokalen Cluster eingerichtet.By default, the Local.json publishing profile is set up to publish to the local cluster. Weitere Informationen zu den Verbindungs- und Endpunktparametern in Veröffentlichungsprofilen finden Sie im nächsten Abschnitt.For more information about the connection and endpoint parameters present in publishing profiles, see the next section.

Veröffentlichen Ihrer Service Fabric-Anwendung in Azure mit EclipsePublish your Service Fabric application to Azure with Eclipse

Um Ihre Anwendung in der Cloud zu veröffentlichen, führen Sie diese Schritte aus:To publish your application to the cloud, follow these steps:

  1. Um Ihre Anwendung in einem sicheren Cluster in der Cloud zu veröffentlichen, benötigen Sie ein X.509-Zertifikat für die Kommunikation mit Ihrem Cluster.To publish your application to a secure cluster in the cloud, you need an X.509 certificate to use to communicate with your cluster. In Test- und Entwicklungsumgebungen wird häufig das Clusterzertifikat verwendet.In test and development environments, the certificate used is often the cluster certificate. In Produktionsumgebungen sollte das Zertifikat ein Clientzertifikat sein, das sich vom Clusterzertifikat unterscheidet.In production environments, the certificate should be a client certificate that is distinct from the cluster certificate. Sie benötigen sowohl das Zertifikat als auch den privaten Schlüssel.You need both the certificate and the private key. Die Zertifikatdatei (und Schlüsseldatei) muss im PEM-Format vorliegen.The certificate (and key) file must be PEM-formatted. Sie können eine PEM-Datei, die das Zertifikat und den privaten Schlüssel aus einer PFX-Datei enthält, mit dem folgenden openssl-Befehl erstellen:You can create a PEM file that contains the certificate and private key from a PFX file with the following openssl command:

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

    Wenn die PFX-Datei nicht kennwortgeschützt ist, verwenden Sie --passin pass: für den letzten Parameter.If the PFX file is not password protected, use --passin pass: for the last parameter.

  2. Öffnen Sie die Cloud.json-Datei im PublishProfiles-Verzeichnis.Open the Cloud.json file under the PublishProfiles directory. Sie müssen den Clusterendpunkt und die Sicherheitsanmeldeinformationen Ihrem Cluster gemäß konfigurieren.You need to configure the cluster endpoint and security credentials appropriately for your cluster.

    • Die ConnectionIPOrURL-Feld enthält die IP-Adresse oder URL Ihres Clusters.The ConnectionIPOrURL field contains the IP address or URL of your cluster. Beachten Sie, dass der Wert nicht das URL-Schema enthält (https://).Note that the value does not contain the URL scheme (https://).

    • Standardmäßig sollte das ConnectionPort-Feld 19080 sein, es sei denn, Sie haben diesen Port explizit für Ihren Cluster geändert.By default the ConnectionPort field should be 19080, unless you explicitly have changed this port for your cluster.

    • Das ClientKey-Feld sollte auf eine PEM- oder KEY-Datei im PEM-Format auf Ihrem lokalen Computer verweisen, die den privaten Schlüssel für Ihr Client- oder Clusterzertifikat enthält.The ClientKey field should point to a PEM-formatted .pem or .key file on your local machine that contains the private key for your client or cluster certificate.

    • Das ClientCert-Feld sollte auf eine PEM- oder CRT-Datei im PEM-Format auf Ihrem lokalen Computer verweisen, die die Zertifikatdaten für Ihr Client- oderThe ClientCert field should point to a PEM-formatted .pem or .crt file on your local machine that contains the certificate data for your client or cluster. Clusterzertifikat enthält.certificate.

      {
          "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. Klicken Sie mit der rechten Maustaste auf Ihre Service Fabric-Anwendung, und wählen Sie dann die Option Service Fabric aus.Right-click your Service Fabric application, and then select Service Fabric.

  4. Klicken Sie im Kontextmenü auf Anwendung veröffentlichen...From the context menu, click Publish Application....

  5. Wählen Sie im Fenster Anwendung veröffentlichen als Zielprofil PublishProfiles/Cloud.json aus, und klicken Sie auf Veröffentlichen.In the Publish Application window, choose PublishProfiles/Cloud.json as the Target Profile and click Publish.

    Clouddialogfeld „Veröffentlichen“

  6. Sie können den Fortschritt des Veröffentlichungsvorgangs im Konsolenfenster verfolgen.You can follow the progress of the publish operation in the Console window.

  7. Um sicherzustellen, dass Ihre Anwendung ausgeführt wird, öffnen Sie den Service Fabric Explorer in Ihrem Azure-Cluster in einem Browserfenster.To verify that your application is running, open Service Fabric Explorer on your Azure cluster in a browser window. Für das obige Beispiel wäre dies: https://lnxxug0tlqm5.westus.cloudapp.azure.com:19080/Explorer.For the example above, this would be: https://lnxxug0tlqm5.westus.cloudapp.azure.com:19080/Explorer. Erweitern Sie den Knoten Anwendungen, und stellen Sie sicher, dass die Anwendung ausgeführt wird.Expand the Applications node and make sure your application is running.

Wenn Ihre Anwendung Reliable Services-Dienste enthält, müssen Sie in sicheren Linux-Clustern auch ein Zertifikat konfigurieren, mit denen Ihre Dienste Service Fabric-Runtime-APIs aufrufen können.On secure Linux clusters, if your application contains Reliable Services services, you will also need to configure a certificate that your services can use to call Service Fabric runtime APIs. Weitere Informationen finden Sie unter Konfigurieren einer Reliable Services-App zur Ausführung in Linux-Clustern.To learn more, see Configure a Reliable Services app to run on Linux clusters.

Eine schnelle Einführung in die Bereitstellung einer in Java geschriebenen Service Fabric-Reliable Services-Anwendung in einem sicheren Linux-Cluster finden Sie unter Schnellstart: Bereitstellen einer Java Reliable Services-Anwendung in Service Fabric.For a quick walk through of how to deploy a Service Fabric Reliable Services application written in Java to a secure Linux cluster, see Quickstart: Deploy a Java Reliable Services application.

Bereitstellen einer Service Fabric-Anwendung mit Eclipse-AusführungskonfigurationenDeploy a Service Fabric application by using Eclipse run configurations

Eine andere Möglichkeit zum Bereitstellen Ihrer Service Fabric-Anwendung ist die Verwendung von Eclipse-Ausführungskonfigurationen.An alternate way to deploy your Service Fabric application is by using Eclipse run configurations.

  1. Navigieren Sie in Eclipse zu Run (Ausführen) > Run Configurations (Ausführungskonfigurationen).In Eclipse, go to Run > Run Configurations.

  2. Wählen Sie unter Gradle Project (Gradle-Projekt) die Ausführungskonfiguration ServiceFabricDeployer aus.Under Gradle Project, select the ServiceFabricDeployer run configuration.

  3. Stellen Sie im rechten Bereich auf der Registerkarte Arguments (Argumente) sicher, dass die Parameter ip, port, clientCert und clientKey für Ihre Bereitstellung richtig festgelegt sind.In the right pane, on the Arguments tab, make sure the ip, port, clientCert, and clientKey parameters are set appropriately for your deployment. Standardmäßig werden die Parameter für die Bereitstellung im lokalen Cluster festgelegt, wie im folgenden Screenshot dargestellt.By default, the parameters are set to deploy to the local cluster as in the following screenshot. Zum Veröffentlichen Ihrer App in Azure können Sie die Parameter so ändern, dass sie die Endpunktdetails und Sicherheitsanmeldeinformationen für Ihren Azure-Cluster enthalten.To publish your app to Azure you can modify the parameters to contain the endpoint details and security credentials for your Azure cluster. Weitere Informationen finden Sie im vorherigen Abschnitt, Veröffentlichen Ihrer Service Fabric-Anwendung in Azure mit Eclipse.For more information, see the previous section, Publish your Service Fabric application to Azure with Eclipse.

    Dialogfeld „Run Configurations“ (Ausführungskonfigurationen)

  4. Stellen Sie sicher, dass Working Directory (Arbeitsverzeichnis) auf die Anwendung verweist, die Sie bereitstellen möchten.Make sure that Working Directory points to the application you want to deploy. Klicken Sie zum Ändern der Anwendung auf die Schaltfläche Arbeitsbereich, und wählen Sie die gewünschte Anwendung aus.To change the application, click the Workspace button, and then select the application you want.

  5. Klicken Sie auf Übernehmen und anschließend auf Ausführen.Click Apply, and then click Run.

Ihre Anwendung wird innerhalb weniger Augenblicke erstellt und bereitgestellt.Your application builds and deploys within a few moments. Sie können den Bereitstellungsstatus in Service Fabric Explorer überwachen.You can monitor the deployment status in Service Fabric Explorer.

Hinzufügen eines Service Fabric-Diensts zur Service Fabric-AnwendungAdd a Service Fabric service to your Service Fabric application

Führen Sie die folgenden Schritte aus, um einer vorhandenen Service Fabric-Anwendung einen Service Fabric-Dienst hinzuzufügen:To add a Service Fabric service to an existing Service Fabric application, do the following steps:

  1. Klicken Sie mit der rechten Maustaste auf das Projekt, dem Sie einen Dienst hinzufügen möchten, und klicken Sie anschließend auf Service Fabric.Right-click the project you want to add a service to, and then click Service Fabric.

    Service Fabric – Dienst hinzufügen – Seite 1

  2. Klicken Sie auf Add Service Fabric Service (Service Fabric-Dienst hinzufügen), und führen Sie die Schritte zum Hinzufügen eines Diensts zum Projekt aus.Click Add Service Fabric Service, and complete the set of steps to add a service to the project.

  3. Wählen Sie die Dienstvorlage aus, die Sie dem Projekt hinzufügen möchten, und klicken Sie auf Weiter.Select the service template you want to add to your project, and then click Next.

    Service Fabric – Dienst hinzufügen – Seite 2

  4. Geben Sie den Dienstnamen (und bei Bedarf weitere Details) ein, und klicken Sie anschließend auf die Schaltfläche Dienst hinzufügen.Enter the service name (and other details, as needed), and then click the Add Service button.

    Service Fabric – Dienst hinzufügen – Seite 3

  5. Nachdem der Dienst hinzugefügt wurde, sieht die Gesamtstruktur des Projekts in etwa wie im folgenden Projekt aus:After the service is added, your overall project structure looks similar to the following project:

    Service Fabric – Dienst hinzufügen – Seite 4

Bearbeiten von Manifestversionen Ihrer Service Fabric-Java-AnwendungEdit Manifest versions of your Service Fabric Java application

Klicken Sie zum Bearbeiten von Manifestversionen mit der rechten Maustaste auf das Projekt, navigieren Sie zu Service Fabric, und wählen Sie in der Dropdownliste des Menüs die Option Manifestversionen bearbeiten... .To edit manifest versions, right click on the project, go to Service Fabric and select Edit Manifest Versions... from the menu dropdown. Im Assistenten können Sie die Manifestversionen für das Anwendungsmanifest, das Dienstmanifest und die Versionen für die Pakete Code, Config und Data aktualisieren.In the wizard, you can update the manifest versions for application manifest, service manifest and the versions for Code, Config and Data packages.

Wenn Sie die Option Anwendung und Dienstversionen automatisch aktualisieren aktivieren und dann eine Version aktualisieren, werden die Manifestversionen automatisch aktualisiert.If you check the option Automatically update application and service versions and then update a version, then the manifest versions will be automatically updated. Beispiel: Sie aktivieren zuerst das Kontrollkästchen und aktualisieren dann die Version von Code von 0.0.0 auf 0.0.1 und klicken auf Fertig stellen. Die Versionen des Dienstmanifests und des Anwendungsmanifests werden dann automatisch auf 0.0.1 aktualisiert.To give an example, you first select the check-box, then update the version of Code version from 0.0.0 to 0.0.1 and click on Finish, then service manifest version and application manifest version will be automatically updated to 0.0.1.

Aktualisieren der Service Fabric-Java-AnwendungUpgrade your Service Fabric Java application

Angenommen, Sie haben für ein Upgradeszenario das Projekt App1 erstellt, indem Sie das Service Fabric-Plug-In in Eclipse verwendet haben.For an upgrade scenario, say you created the App1 project by using the Service Fabric plug-in in Eclipse. Sie haben es bereitgestellt, indem Sie mit dem Plug-In eine Anwendung mit dem Namen fabric:/App1Application erstellt haben.You deployed it by using the plug-in to create an application named fabric:/App1Application. Der Anwendungstyp lautet App1ApplicationType, und die Anwendungsversion ist 1.0.The application type is App1ApplicationType, and the application version is 1.0. Nun möchten Sie die Anwendung aktualisieren, ohne die Verfügbarkeit zu unterbrechen.Now, you want to upgrade your application without interrupting availability.

Nehmen Sie zuerst Änderungen an Ihrer Anwendung vor, und erstellen Sie den geänderten Dienst anschließend neu.First, make any changes to your application, and then rebuild the modified service. Aktualisieren Sie die Manifestdatei des geänderten Diensts (ServiceManifest.xml) mit den aktualisierten Versionen für den Dienst (und ggf. mit aktualisiertem Code, aktualisierter Konfiguration oder aktualisierten Daten).Update the modified service’s manifest file (ServiceManifest.xml) with the updated versions for the service (and Code, Config, or Data, as relevant). Passen Sie auch das Manifest der Anwendung (ApplicationManifest.xml) mit der aktualisierten Versionsnummer für die Anwendung und dem geänderten Dienst an.Also, modify the application’s manifest (ApplicationManifest.xml) with the updated version number for the application and the modified service.

Wenn Sie mithilfe von Eclipse ein Upgrade für Ihre Anwendung durchführen möchten, können Sie ein dupliziertes Profil einer Ausführungskonfiguration erstellen.To upgrade your application by using Eclipse, you can create a duplicate run configuration profile. Verwenden Sie es anschließend, um die Anwendung wie gewünscht zu aktualisieren.Then, use it to upgrade your application as needed.

  1. Navigieren Sie zu Ausführen > Run Configurations (Ausführungskonfigurationen).Go to Run > Run Configurations. Klicken Sie im linken Bereich auf den kleinen Pfeil links neben Gradle Project (Gradle-Projekt).In the left pane, click the small arrow to the left of Gradle Project.
  2. Klicken Sie mit der rechten Maustaste auf ServiceFabricDeployer, und wählen Sie die Option Duplizieren.Right-click ServiceFabricDeployer, and then select Duplicate. Geben Sie einen neuen Namen für diese Konfiguration ein, z.B. ServiceFabricUpgrader.Enter a new name for this configuration, for example, ServiceFabricUpgrader.
  3. Ändern Sie im rechten Bereich auf der Registerkarte Argumente den Wert -Pconfig='deploy' in -Pconfig=upgrade, und klicken Sie dann auf Übernehmen.In the right panel, on the Arguments tab, change -Pconfig='deploy' to -Pconfig='upgrade', and then click Apply.

Mit diesem Prozess wird ein Profil für die Ausführungskonfiguration erstellt und gespeichert, das Sie jederzeit zum Aktualisieren Ihrer Anwendung verwenden können.This process creates and saves a run configuration profile you can use at any time to upgrade your application. Bei diesem Vorgang wird außerdem die aktuelle Version mit aktualisiertem Anwendungstyp aus der Anwendungsmanifestdatei abgerufen.It also gets the latest updated application type version from the application manifest file.

Das Upgrade der Anwendung dauert einige Minuten.The application upgrade takes a few minutes. Sie können die Anwendungsaktualisierung mit Service Fabric Explorer überwachen.You can monitor the application upgrade in Service Fabric Explorer.

Migrieren alter Service Fabric-Java-Anwendungen für die Verwendung mit MavenMigrating old Service Fabric Java applications to be used with Maven

Vor Kurzem wurden Service Fabric-Java-Bibliotheken aus dem Service Fabric Java SDK in das Maven-Repository verschoben.We have recently moved Service Fabric Java libraries from Service Fabric Java SDK to Maven repository. Die neuen mit Eclipse erstellten Anwendungen generieren aktuelle Projekte (die mit Maven verwendet werden können). Sie können Ihre vorhandenen zustandslosen oder akteurbasierten Service Fabric-Java-Anwendungen, die zuvor das Service Fabric Java SDK verwendet haben, aktualisieren, sodass sie die Service Fabric-Java-Abhängigkeiten von Maven nutzen.While the new applications you generate using Eclipse, will generate latest updated projects (which will be able to work with Maven), you can update your existing Service Fabric stateless or actor Java applications, which were using the Service Fabric Java SDK earlier, to use the Service Fabric Java dependencies from Maven. Führen Sie die hier aufgeführten Schritte aus, um sicherzustellen, dass Ihre älteren Anwendung mit Maven verwendet werden können.Please follow the steps mentioned here to ensure your older application works with Maven.

Nächste SchritteNext steps