Plug-in Service Fabric per lo sviluppo di applicazioni Java in EclipseService Fabric plug-in for Eclipse Java application development

Eclipse è uno degli ambienti di sviluppo integrato (IDE) più diffusi per sviluppatori Java.Eclipse is one of the most widely used integrated development environments (IDEs) for Java developers. Questo articolo illustra come configurare l'ambiente di sviluppo Eclipse per l'uso con Azure Service Fabric.In this article, we describe how to set up your Eclipse development environment to work with Azure Service Fabric. Spiega come installare il plug-in Service Fabric, creare un'applicazione Service Fabric e distribuire l'applicazione nel cluster di Service Fabric locale o remoto in Eclipse Neon.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 Neon.

Nota

Il plug-in per Eclipse non è attualmente supportato in Windows.The Eclipse plugin is currently not supported on Windows.

Installare o aggiornare il plug-in Service Fabric in Eclipse NeonInstall or update the Service Fabric plug-in in Eclipse Neon

È possibile installare un plug-in Service Fabric in Eclipse.You can install a Service Fabric plug-in in Eclipse. Il plug-in consente di semplificare il processo di compilazione e distribuzione di servizi Java.The plug-in can help simplify the process of building and deploying Java services.

  1. Assicurarsi di avere installato la versione più recente di Eclipse Neon e la versione più recente di Buildship (1.0.17 o versione successiva):Ensure that you have the latest version of Eclipse Neon and the latest version of Buildship (1.0.17 or a later version) installed:

    • Per verificare le versioni dei componenti installati, in Eclipse Neon scegliere Help > Installation Details (? > Dettagli installazione).To check the versions of installed components, in Eclipse Neon, go to Help > Installation Details.
    • Per aggiornare Buildship, vedere Eclipse Buildship: Eclipse Plug-ins for Gradle (Eclipse Buildship: plug-in Eclipse per Gradle).To update Buildship, see Eclipse Buildship: Eclipse Plug-ins for Gradle.
    • Per cercare e installare gli aggiornamenti di Eclipse Neon, passare a Help > Check for Updates (? > Controlla aggiornamenti).To check for and install updates for Eclipse Neon, go to Help > Check for Updates.
  2. Per installare il plug-in Service Fabric, in Eclipse Neon passare a Help > Install New Software (? > Installa nuovo software).To install the Service Fabric plug-in, in Eclipse Neon, go to Help > Install New Software.

    1. Nella casella Work with (Usa) immettere http://dl.microsoft.com/eclipseIn the Work with box, enter http://dl.microsoft.com/eclipse.
    2. Fare clic su Aggiungi.Click Add.

      Plug-in Service Fabric per Eclipse Neon

    3. Selezionare il plug-in Service Fabric e fare clic su Next (Avanti).Select the Service Fabric plug-in, and then click Next.
    4. Completare la procedura di installazione e quindi accettare le Condizioni di licenza software Microsoft.Complete the installation steps, and then accept the Microsoft Software License Terms.

Se il plug-in Service Fabric è già installato, verificare che la versione sia la più recente.If you already have the Service Fabric plug-in installed, make sure that you have the latest version. Per verificare la disponibilità di aggiornamenti, passare a Help > Installation Details (? > Dettagli installazione).To check for available updates, go to Help > Installation Details. Nell'elenco di plug-in installati selezionare Service Fabric e fare clic su Update (Aggiorna).In the list of installed plug-ins, select Service Fabric, and then click Update. Verranno installati gli aggiornamenti disponibili.Available updates will be installed.

Nota

Se l'installazione o l'aggiornamento del plug-in Service Fabric è lento, il problema potrebbe essere dovuto a un'impostazione di Eclipse.If installing or updating the Service Fabric plug-in is slow, it might be due to an Eclipse setting. Eclipse raccoglie i metadati di tutte le modifiche per aggiornare i siti registrati con l'istanza di Eclipse.Eclipse collects metadata on all changes to update sites that are registered with your Eclipse instance. Per velocizzare il processo di rilevamento e installazione di un aggiornamento del plug-in Service Fabric, passare a Available Software Sites (Siti software disponibili).To speed up the process of checking for and installing a Service Fabric plug-in update, go to Available Software Sites. Deselezionare le caselle di controllo per tutti i siti eccetto quello che punta al percorso del plug-in Service Fabric (http://dl.microsoft.com/eclipse/azure/servicefabric).Clear the check boxes for all sites except for the one that points to the Service Fabric plug-in location (http://dl.microsoft.com/eclipse/azure/servicefabric).

Nota

Se Eclipse non funziona come previsto nel Mac o deve essere eseguito come utente con privilegi avanzati, passare alla cartella ECLIPSE_INSTALLATION_PATH e alla sottocartella 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. Avviare Eclipse eseguendo ./eclipse.Start Eclipse by running ./eclipse.

Creare un'applicazione di Service Fabric in EclipseCreate a Service Fabric application in Eclipse

  1. In Eclipse Neon, passare a File > New > Other (File > Nuovo > Altro).In Eclipse Neon, go to File > New > Other. Selezionare Service Fabric Project, quindi fare clic su Next (Avanti).Select Service Fabric Project, and then click Next.

    Pagina 1 del nuovo progetto di Service Fabric

  2. Immettere un nome per il progetto e quindi fare clic su Next (Avanti).Enter a name for your project, and then click Next.

    Pagina 2 del nuovo progetto di Service Fabric

  3. Dall'elenco dei modelli selezionare Service Template (Modello di servizio).In the list of templates, select Service Template. Selezionare il tipo di modello di servizio (Actor, Stateless, Container, or Guest Binary) e quindi fare clic su Next (Avanti).Select your service template type (Actor, Stateless, Container, or Guest Binary), and then click Next.

    Pagina 3 del nuovo progetto di Service Fabric

  4. Immettere il nome e i dettagli del servizio e fare clic su Finish (Fine).Enter the service name and service details, and then click Finish.

    Pagina 4 del nuovo progetto di Service Fabric

  5. Quando si crea il primo progetto di Service Fabric, nella finestra di dialogo Open Associated Perspective (Apri prospettiva associata) fare clic su Yes.When you create your first Service Fabric project, in the Open Associated Perspective dialog box, click Yes.

    Pagina 5 del nuovo progetto di Service Fabric

  6. L'aspetto del nuovo progetto sarà simile al seguente:Your new project looks like this:

    Pagina 6 del nuovo progetto di Service Fabric

Creare e distribuire un'applicazione di Service Fabric in EclipseBuild and deploy a Service Fabric application in Eclipse

  1. Fare clic con il pulsante destro del mouse sulla nuova applicazione di Service Fabric, quindi scegliere Service Fabric.Right-click your new Service Fabric application, and then select Service Fabric.

    Menu di scelta rapida di Service Fabric

  2. Nel sottomenu selezionare l'opzione desiderata:In the submenu, select the option you want:

    • Per compilare l'applicazione senza pulizia, fare clic su Build Application (Compila applicazione).To build the application without cleaning, click Build Application.
    • Per eseguire una compilazione pulita dell'applicazione, fare clic su Rebuild Application (Ricompila applicazione).To do a clean build of the application, click Rebuild Application.
    • Per eliminare gli artefatti di compilazione dall'applicazione, fare clic su Clean Application (Pulisci applicazione).To clean the application of built artifacts, click Clean Application.
  3. Da questo menu è anche possibile distribuire, annullare la distribuzione e pubblicare l'applicazione:From this menu, you also can deploy, undeploy, and publish your application:

    • Per eseguire la distribuzione nel cluster locale, fare clic su Deploy Application (Distribuisci applicazione).To deploy to your local cluster, click Deploy Application.
    • Nella finestra di dialogo Publish Application (Pubblica applicazione) selezionare un profilo di pubblicazione:In the Publish Application dialog box, select a publish profile:

      • Local.jsonLocal.json
      • Cloud.jsonCloud.json

      Questi file JSON (JavaScript Object Notation) archiviano le informazioni necessarie per connettersi al cluster locale o nel cloud (Azure), ad esempio gli endpoint di connessione e le informazioni di sicurezza.These JavaScript Object Notation (JSON) files store information (such as connection endpoints and security information) that is required to connect to your local or cloud (Azure) cluster.

    Menu di pubblicazione di Service Fabric

Un modo alternativo per distribuire l'applicazione di Service Fabric consiste nell'usare le configurazioni di esecuzione di Eclipse.An alternate way to deploy your Service Fabric application is by using Eclipse run configurations.

  1. Passare a Run > Run Configurations (Esegui > Configurazioni di esecuzione).Go to Run > Run Configurations.
  2. In Gradle Project (Progetto Gradle) selezionare la configurazione di esecuzione ServiceFabricDeployer.Under Gradle Project, select the ServiceFabricDeployer run configuration.
  3. Nella scheda Arguments (Argomenti) del pannello destro selezionare local o cloud per publishProfile.In the right pane, on the Arguments tab, for publishProfile, select local or cloud. Il valore predefinito è local.The default is local. Per la distribuzione in un cluster remoto o cloud, selezionare cloud.To deploy to a remote or cloud cluster, select cloud.
  4. Per verificare che nei profili di pubblicazione siano inserite le informazioni corrette, modificare Local.json o Cloud.json in base alle esigenze.To ensure that the proper information is populated in the publish profiles, edit Local.json or Cloud.json as needed. È possibile aggiungere o aggiornare i dettagli degli endpoint e delle credenziali di sicurezza.You can add or update endpoint details and security credentials.
  5. Verificare che Working Directory (Directory di lavoro) punti all'applicazione da distribuire.Ensure that Working Directory points to the application you want to deploy. Per cambiare applicazione, fare clic sul pulsante Workspace (Area di lavoro) e selezionare l'applicazione.To change the application, click the Workspace button, and then select the application you want.
  6. Fare clic su Apply (Applica) e quindi su Run (Esegui).Click Apply, and then click Run.

L'applicazione verrà compilata e distribuita dopo alcuni istanti.Your application builds and deploys within a few moments. È possibile monitorare lo stato della distribuzione in Service Fabric Explorer.You can monitor the deployment status in Service Fabric Explorer.

Aggiungere un servizio di Service Fabric all'applicazione di Service FabricAdd a Service Fabric service to your Service Fabric application

Per aggiungere un servizio di Service Fabric a un'applicazione di Service Fabric esistente seguire questa procedura:To add a Service Fabric service to an existing Service Fabric application, do the following steps:

  1. Fare clic con il pulsante destro del mouse sul progetto al quale aggiungere un servizio e quindi scegliere Service Fabric.Right-click the project you want to add a service to, and then click Service Fabric.

    Pagina 1 dell'aggiunta di un servizio di Service Fabric

  2. Fare clic su Add Service Fabric Service (Aggiungi servizio di Service Fabric) e completare la procedura per aggiungere un servizio al progetto.Click Add Service Fabric Service, and complete the set of steps to add a service to the project.

  3. Selezionare il modello di servizio da aggiungere al progetto e quindi fare clic su Next (Avanti).Select the service template you want to add to your project, and then click Next.

    Pagina 2 dell'aggiunta di un servizio di Service Fabric

  4. Immettere il nome del servizio e altri eventuali dettagli necessari, quindi fare clic sul pulsante Add Service (Aggiungi servizio).Enter the service name (and other details, as needed), and then click the Add Service button.

    Pagina 3 dell'aggiunta di un servizio di Service Fabric

  5. Dopo aver aggiunto il servizio, la struttura complessiva del progetto sarà simile al progetto seguente:After the service is added, your overall project structure looks similar to the following project:

    Pagina 4 dell'aggiunta di un servizio di Service Fabric

Modifica versioni del manifesto dell'applicazione Java di Service FabricEdit Manifest versions of your Service Fabric Java application

Per modificare le versioni del manifesto, fare clic con il pulsante destro del mouse sul progetto, passare a Service Fabric e selezionare Modifica versioni del manifesto... dal menu a discesa.To edit manifest versions, right click on the project, go to Service Fabric and select Edit Manifest Versions... from the menu dropdown. Nella procedura guidata è possibile aggiornare le versioni del manifesto dell'applicazione, del manifesto del servizio e dei pacchetti di codice, configurazione e dati.In the wizard, you can update the manifest versions for application manifest, service manifest and the versions for Code, Config and Data packages.

Selezionando l'opzione Aggiorna automaticamente le versioni di applicazioni e servizi e aggiornando la versione, le versioni del manifesto verranno aggiornate automaticamente.If you check the option Automatically update application and service versions and then update a version, then the manifest versions will be automatically updated. Ad esempio, selezionare prima la casella di controllo, quindi aggiornare la versione del codice da 0.0.0 a 0.0.1 e fare clic su Fine. La versione del manifesto del servizio e del manifesto dell'applicazione verrà aggiornata automaticamente a 0.0.1.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.

Aggiornare l'applicazione Java di Service FabricUpgrade your Service Fabric Java application

In uno scenario di aggiornamento è stato ad esempio creato il progetto App1 usando il plug-in Service Fabric in Eclipse.For an upgrade scenario, say you created the App1 project by using the Service Fabric plug-in in Eclipse. Il progetto è stato distribuito con il plug-in per creare un'applicazione denominata fabric:/App1Application.You deployed it by using the plug-in to create an application named fabric:/App1Application. Il tipo di applicazione è App1AppicationType e la versione dell'applicazione è 1.0.The application type is App1AppicationType, and the application version is 1.0. Ora si vuole aggiornare l'applicazione senza interromperne la disponibilità.Now, you want to upgrade your application without interrupting availability.

Apportare prima le eventuali modifiche necessarie all'applicazione, quindi ricompilare il servizio modificato.First, make any changes to your application, and then rebuild the modified service. Aggiornare il file manifesto del servizio modificato (ServiceManifest.xml) con le versioni aggiornate del servizio e anche del codice, della configurazione o dei dati, a seconda delle esigenze.Update the modified service’s manifest file (ServiceManifest.xml) with the updated versions for the service (and Code, Config, or Data, as relevant). Modificare anche il manifesto dell'applicazione (ApplicationManifest.xml) con il numero di versione aggiornato per l'applicazione e il servizio modificato.Also, modify the application’s manifest (ApplicationManifest.xml) with the updated version number for the application and the modified service.

Per aggiornare l'applicazione usando Eclipse Neon è possibile creare un profilo di configurazione di esecuzione duplicatoTo upgrade your application by using Eclipse Neon, you can create a duplicate run configuration profile. e quindi usarlo per aggiornare l'applicazione in base alle esigenze.Then, use it to upgrade your application as needed.

  1. Passare a Run > Run Configurations (Esegui > Configurazioni di esecuzione).Go to Run > Run Configurations. Nel pannello sinistro fare clic sulla piccola freccia a sinistra di Gradle Project (Progetto Gradle).In the left pane, click the small arrow to the left of Gradle Project.
  2. Fare clic con il pulsante destro del mouse su ServiceFabricDeployer e quindi scegliere Duplicate (Duplica).Right-click ServiceFabricDeployer, and then select Duplicate. Specificare un nuovo nome per questa configurazione, ad esempio ServiceFabricUpgrader.Enter a new name for this configuration, for example, ServiceFabricUpgrader.
  3. Nella scheda Arguments (Argomenti) nel pannello destro modificare -Pconfig='deploy' in -Pconfig='upgrade' e quindi fare clic su Apply (Applica).In the right panel, on the Arguments tab, change -Pconfig='deploy' to -Pconfig='upgrade', and then click Apply.

Questo processo crea e salva un profilo di configurazione di esecuzione che può essere usato in qualsiasi momento per aggiornare l'applicazione.This process creates and saves a run configuration profile you can use at any time to upgrade your application. Recupera anche la versione più recente del tipo di applicazione dal file manifesto dell'applicazione stessa.It also gets the latest updated application type version from the application manifest file.

L'aggiornamento dell'applicazione richiede alcuni minuti.The application upgrade takes a few minutes. È possibile monitorare l'aggiornamento dell'applicazione in Service Fabric Explorer.You can monitor the application upgrade in Service Fabric Explorer.

Migrazione di applicazioni Java di Service Fabric precedenti da usare con MavenMigrating old Service Fabric Java applications to be used with Maven

Le librerie Java di Service Fabric sono state recentemente spostate da Service Fabric Java SDK al repository di Maven.We have recently moved Service Fabric Java libraries from Service Fabric Java SDK to Maven repository. Benché le nuove applicazioni generate con Eclipse genereranno i progetti aggiornati più recenti (in grado di interagire con Maven), è possibile aggiornare le applicazioni Java esistenti di Service Fabric senza stato o actor, che in precedenza usavano Service Fabric Java SDK, in modo che usino le dipendenze Java di Service Fabric da Maven.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. Seguire la procedura riportata qui per assicurare che l'applicazione precedente funzioni con Maven.Please follow the steps mentioned here to ensure your older application works with Maven.