Preparare l'ambiente di sviluppo in LinuxPrepare your development environment on Linux

Per distribuire ed eseguire applicazioni di Azure Service Fabric in un computer di sviluppo Linux, installare il runtime e l'SDK comune.To deploy and run Azure Service Fabric applications on your Linux development machine, install the runtime and common SDK. È anche possibile installare SDK facoltativi per lo sviluppo Java e .NET Core.You can also install optional SDKs for Java and .NET Core development.

PrerequisitiPrerequisites

Per lo sviluppo, sono supportati i sistemi operativi seguenti:The following operating system versions are supported for development:

  • Ubuntu 16.04 (Xenial Xerus)Ubuntu 16.04 (Xenial Xerus)

Metodi di installazioneInstallation Methods

1. Installazione con script1. Script installation

Per praticità viene fornito uno script per l'installazione del runtime di Service Fabric e dell'SDK comune di Service Fabric insieme all'interfaccia della riga di comando sfctl.A script is provided for convenience for installing the Service Fabric runtime and the Service Fabric common SDK along with sfctl CLI. Eseguire la procedura di installazione manuale della sezione successiva per determinare gli elementi installati e le licenze accettate.Run the manual installation steps in the next section to determine what is being installed and the licenses that are being agreed to. L'esecuzione dello script presuppone l'accettazione delle licenze di tutto il software installato.Running the script assumes you agree to the licenses for all the software that is being installed.

Al termine dell'esecuzione dello script, è possibile passare direttamente a Configurare un cluster locale.After the script is executed successfully, you can directly skip to Set up a local cluster.

sudo curl -s https://raw.githubusercontent.com/Azure/service-fabric-scripts-and-templates/master/scripts/SetupServiceFabric/SetupServiceFabric.sh | sudo bash

2. Installazione manuale2. Manual Installation

Per l'installazione manuale del runtime e dell'SDK comune di Service Fabric, seguire il resto di questa guida.For manual installation of Service Fabric runtime and common SDK, follow the rest of this guide.

Aggiornare le origini APTUpdate your APT sources

Per installare l'SDK e il pacchetto di runtime associato tramite lo strumento da riga di comando apt-get, è prima necessario aggiornare le origini APT (Advanced Packaging Tool).To install the SDK and the associated runtime package via the apt-get command-line tool, you must first update your Advanced Packaging Tool (APT) sources.

  1. Aprire un terminale.Open a terminal.
  2. Aggiungere il repository di Service Fabric all'elenco di origini.Add the Service Fabric repo to your sources list.

    sudo sh -c 'echo "deb [arch=amd64] http://apt-mo.trafficmanager.net/repos/servicefabric/ xenial main" > /etc/apt/sources.list.d/servicefabric.list'
    
  3. Aggiungere il repository dotnet all'elenco di origini.Add the dotnet repo to your sources list.

    sudo sh -c 'echo "deb [arch=amd64] https://apt-mo.trafficmanager.net/repos/dotnet-release/ xenial main" > /etc/apt/sources.list.d/dotnetdev.list'
    
  4. Aggiungere la nuova chiave Gnu Privacy Guard (GnuPG o GPG) al keyring di APT.Add the new Gnu Privacy Guard (GnuPG, or GPG) key to your APT keyring.

    sudo apt-key adv --keyserver apt-mo.trafficmanager.net --recv-keys 417A0893
    sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 417A0893
    
  5. Aggiungere la chiave GPG Docker ufficiale al keyring di APT.Add the official Docker GPG key to your APT keyring.

    sudo apt-get install curl
    sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
    
  6. Configurare il repository di Docker.Set up the Docker repository.

    sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
    
  7. Aggiornare l'elenco dei pacchetti in base ai repository appena aggiunti.Refresh your package lists based on the newly added repositories.

    sudo apt-get update
    

Installare e configurare Service Fabric SDK per la configurazione del cluster localeInstall and set up the Service Fabric SDK for local cluster setup

Dopo aver aggiornato le origini, è possibile installare l'SDK.After you have updated your sources, you can install the SDK. Installare il pacchetto Service Fabric SDK, confermare l'installazione e accettare il contratto di licenza.Install the Service Fabric SDK package, confirm the installation, and agree to the license agreement.

sudo apt-get install servicefabricsdkcommon

Suggerimento

I comandi seguenti permettono di automatizzare l'accettazione della licenza per i pacchetti di Service Fabric:The following commands automate accepting the license for Service Fabric packages:

echo "servicefabric servicefabric/accepted-eula-ga select true" | sudo debconf-set-selections
echo "servicefabricsdkcommon servicefabricsdkcommon/accepted-eula-ga select true" | sudo debconf-set-selections

Configurare un cluster localeSet up a local cluster

Al termine dell'installazione, sarà possibile avviare un cluster locale.Once the installation completes, you should be able to start a local cluster.

  1. Eseguire lo script di configurazione del cluster.Run the cluster setup script.

    sudo /opt/microsoft/sdk/servicefabric/common/clustersetup/devclustersetup.sh
    
  2. Aprire un Web browser e passare a Service Fabric Explorer.Open a web browser and go to Service Fabric Explorer. Se il cluster è stato avviato, verrà visualizzato il dashboard di Service Fabric Explorer.If the cluster has started, you should see the Service Fabric Explorer dashboard.

    Service Fabric Explorer in Linux

    A questo punto, è possibile distribuire pacchetti di applicazione di Service Fabric predefiniti o nuovi pacchetti basati su contenitori o eseguibili guest.At this point, you can deploy pre-built Service Fabric application packages or new ones based on guest containers or guest executables. Per creare nuovi servizi usando gli SDK per Java o .NET Core, seguire le procedure di configurazione facoltative riportate nelle sezioni successive.To build new services by using the Java or .NET Core SDKs, follow the optional setup steps that are provided in subsequent sections.

Nota

I cluster autonomi non sono supportati in Linux.Standalone clusters aren't supported in Linux.

Configurare l'interfaccia della riga di comando di Service FabricSet up the Service Fabric CLI

L'interfaccia della riga di comando di Service Fabric include comandi per l'interazione con entità di Service Fabric, come cluster e applicazioni.The Service Fabric CLI has commands for interacting with Service Fabric entities, including clusters and applications. Seguire le istruzioni contenute in Interfaccia della riga di comando di Service Fabric per installare l'interfaccia della riga di comando.Follow the instructions at Service Fabric CLI to install the CLI.

Configurare i generatori Yeoman per contenitori ed eseguibili guestSet up Yeoman generators for containers and guest executables

Service Fabric offre gli strumenti di scaffolding che consentono di creare applicazioni Service Fabric dal terminale tramite i generatori di modelli Yeoman.Service Fabric provides scaffolding tools that help you create Service Fabric applications from a terminal using Yeoman template generators. Per configurare i generatori di modelli Yeoman di Service Fabric, seguire questa procedura:Follow these steps to set up the Service Fabric Yeoman template generators:

  1. Installare nodejs e NPM nella macchina virtualeInstall nodejs and NPM on your machine

    sudo apt-get install npm
    sudo apt install nodejs-legacy
    
  2. Installare il generatore di modelli Yeoman nella macchina virtuale da NPMInstall Yeoman template generator on your machine from NPM

    sudo npm install -g yo
    
  3. Installare il generatore di contenitori Yeo per Service Fabric e il generatore di eseguibili guest da NPMInstall the Service Fabric Yeo container generator and guest executable generator from NPM

    sudo npm install -g generator-azuresfcontainer  # for Service Fabric container application
    sudo npm install -g generator-azuresfguest      # for Service Fabric guest executable application
    

Al termine dell'installazione dei generatori, sarà possibile creare servizi contenitore o eseguibili guest eseguendo, rispettivamente, yo azuresfcontainer o yo azuresfguest.After you have installed the generators, you should be able to create guest executable or container services by running yo azuresfguest or yo azuresfcontainer, respectively.

Configurare lo sviluppo .NET Core 2.0Set up .NET Core 2.0 development

Installare .NET Core 2.0 SDK per Ubuntu per avviare la creazione di applicazioni C# di Service Fabric.Install the .NET Core 2.0 SDK for Ubuntu to start creating C# Service Fabric applications. I pacchetti per le applicazioni .NET Core 2.0 di Service Fabric sono ospitati in NuGet.org, attualmente in anteprima.Packages for .NET Core 2.0 Service Fabric applications are hosted on NuGet.org, currently in preview.

Configurare lo sviluppo JavaSet up Java development

Per compilare servizi di Service Fabric con Java, installare JDK 1.8 e Gradle per eseguire le attività di compilazione.To build Service Fabric services using Java, install JDK 1.8 and Gradle to run build tasks. Il frammento di codice seguente installa Open JDK 1.8 insieme a Gradle.The following snippet installs Open JDK 1.8 along with Gradle. Il pull delle librerie Java per Service Fabric viene eseguito da Maven.The Service Fabric Java libraries are pulled from Maven.

sudo apt-get install openjdk-8-jdk-headless
sudo apt-get install gradle

Installare il plug-in Eclipse Neon (facoltativo)Install the Eclipse Neon plug-in (optional)

È possibile installare il plug-in Eclipse per Service Fabric dall'IDE di Eclipse per sviluppatori Java.You can install the Eclipse plug-in for Service Fabric from within the Eclipse IDE for Java Developers. È possibile usare Eclipse per creare applicazioni contenitore e applicazioni eseguibili guest di Service Fabric in aggiunta alle applicazioni Java di Service Fabric.You can use Eclipse to create Service Fabric guest executable applications and container applications in addition to Service Fabric Java applications.

  1. In Eclipse assicurarsi che sia installata l'ultima versione di Eclipse Neon e di Buildship (1.0.17 o versione successiva).In Eclipse, ensure that you have latest Eclipse Neon and the latest Buildship version (1.0.17 or later) installed. Per controllare le versioni dei componenti installati, selezionare Help > Installation Details (? > Dettagli installazione).You can check the versions of installed components by selecting Help > Installation Details. È possibile aggiornare Buildship seguendo le istruzioni riportate in Eclipse Buildship: Eclipse Plug-ins for Gradle (Eclipse Buildship: plug-in Eclipse per Gradle).You can update Buildship by using the instructions at Eclipse Buildship: Eclipse Plug-ins for Gradle.

  2. Per installare il plug-in Service Fabric, selezionare Help > Install New Software (? > Installa nuovo software).To install the Service Fabric plug-in, select Help > Install New Software.

  3. Nella casella Work with (Usa) digitare http://dl.microsoft.com/eclipse.In the Work with box, type http://dl.microsoft.com/eclipse.

  4. Fare clic su Aggiungi.Click Add.

    Pagina relativa al software disponibile

  5. Selezionare il plug-in ServiceFabric e quindi fare clic su Next (Avanti).Select the ServiceFabric plug-in, and then click Next.

  6. Completare la procedura di installazione e quindi accettare il contratto di licenza con l'utente finale.Complete the installation steps, and then accept the end-user license agreement.

Se il plug-in Eclipse per Service Fabric è già installato, verificare che la versione sia la più recente.If you already have the Service Fabric Eclipse plug-in installed, make sure that you have the latest version. Per controllare, selezionare Help > Installation Details (? > Dettagli installazione) e quindi cercare Service Fabric nell'elenco dei plug-in installati. Se è disponibile una versione più recente, selezionare Update (Aggiorna).You can check by selecting Help > Installation Details and then searching for Service Fabric in the list of installed plug-ins. If a newer version is available, select Update.

Per altre informazioni, vedere Plug-in Service Fabric per lo sviluppo di applicazioni Java in Eclipse.For more information, see Service Fabric plug-in for Eclipse Java application development.

Aggiornare SDK e runtimeUpdate the SDK and runtime

Per aggiornare l'SDK e il runtime all'ultima versione, eseguire questi comandi:To update to the latest version of the SDK and runtime, run the following commands:

sudo apt-get update
sudo apt-get install servicefabric servicefabricsdkcommon

Per aggiornare i file binari Java SDK da Maven, è necessario aggiornare i dettagli della versione del file binario corrispondente nel file build.gradle in modo che facciano riferimento alla versione più recente.To update the Java SDK binaries from Maven, you need to update the version details of the corresponding binary in the build.gradle file to point to the latest version. Per individuare esattamente il punto in cui è necessario aggiornare la versione, è possibile vedere qualsiasi file build.gradle negli esempi introduttivi di Service Fabric , disponibili qui.To know exactly where you need to update the version, you can refer to any build.gradle file in Service Fabric getting-started samples here.

Nota

L'aggiornamento dei pacchetti può causare l'arresto dell'esecuzione del cluster di sviluppo locale.Updating the packages might cause your local development cluster to stop running. Riavviare il cluster locale dopo un aggiornamento seguendo le istruzioni disponibili in questa pagina.Restart your local cluster after an upgrade by following the instructions on this page.

Rimuovere l'SDKRemove the SDK

Per rimuovere le istanze di Service Fabric SDK, eseguire questi comandi:To remove the Service Fabric SDKs, run the following:

sudo apt-get remove servicefabric servicefabicsdkcommon
sudo npm uninstall generator-azuresfcontainer
sudo npm uninstall generator-azuresfguest
sudo apt-get install -f

Passaggi successiviNext steps