Preparare l'ambiente di sviluppo in Linux

Per distribuire ed eseguire applicazioni di Azure Service Fabric in un computer di sviluppo Linux, installare il runtime e l'SDK comune. È anche possibile installare SDK facoltativi per lo sviluppo Java e .NET Core.

Prerequisiti

Per lo sviluppo, sono supportati i sistemi operativi seguenti:

  • Ubuntu 16.04 (Xenial Xerus)

Metodi di installazione

1. Installazione con script

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. Eseguire la procedura di installazione manuale della sezione successiva per determinare gli elementi installati e le licenze accettate. L'esecuzione dello script presuppone l'accettazione delle licenze di tutto il software installato.

Al termine dell'esecuzione dello script, è possibile passare direttamente a Configurare un cluster locale.

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

2. Installazione manuale

Per l'installazione manuale del runtime e dell'SDK comune di Service Fabric, seguire il resto di questa guida.

Aggiornare le origini APT

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

  1. Aprire un terminale.
  2. Aggiungere il repository di Service Fabric all'elenco di origini.

    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.

    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.

    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.

    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.

    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.

    sudo apt-get update
    

Installare e configurare Service Fabric SDK per la configurazione del cluster locale

Dopo aver aggiornato le origini, è possibile installare l'SDK. Installare il pacchetto Service Fabric SDK, confermare l'installazione e accettare il contratto di licenza.

sudo apt-get install servicefabricsdkcommon

Suggerimento

I comandi seguenti permettono di automatizzare l'accettazione della licenza per i pacchetti di Service Fabric:

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 locale

Al termine dell'installazione, sarà possibile avviare un cluster locale.

  1. Eseguire lo script di configurazione del cluster.

    sudo /opt/microsoft/sdk/servicefabric/common/clustersetup/devclustersetup.sh
    
  2. Aprire un Web browser e passare a Service Fabric Explorer. Se il cluster è stato avviato, verrà visualizzato il dashboard di Service Fabric Explorer.

    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. Per creare nuovi servizi usando gli SDK per Java o .NET Core, seguire le procedure di configurazione facoltative riportate nelle sezioni successive.

Nota

I cluster autonomi non sono supportati in Linux.

Configurare l'interfaccia della riga di comando di Service Fabric

L'interfaccia della riga di comando di Service Fabric include comandi per l'interazione con entità di Service Fabric, come cluster e applicazioni. Seguire le istruzioni contenute in Interfaccia della riga di comando di Service Fabric per installare l'interfaccia della riga di comando.

Configurare i generatori Yeoman per contenitori ed eseguibili guest

Service Fabric offre strumenti di scaffolding che consentono di creare applicazioni di Service Fabric da un terminale usando i generatori di modelli Yeoman. Per configurare i generatori di modelli Yeoman di Service Fabric, seguire questa procedura:

  1. Installare nodejs e NPM nella macchina virtuale

    sudo apt-get install npm
    sudo apt install nodejs-legacy
    
  2. Installare il generatore di modelli Yeoman nella macchina virtuale da NPM

    sudo npm install -g yo
    
  3. Installare il generatore di contenitori Yeo per Service Fabric e il generatore di eseguibili guest da 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.

Configurare lo sviluppo .NET Core 2.0

Installare .NET Core 2.0 SDK per Ubuntu per avviare la creazione di applicazioni C# di Service Fabric. I pacchetti per le applicazioni .NET Core 2.0 di Service Fabric sono ospitati in NuGet.org, attualmente in anteprima.

Configurare lo sviluppo Java

Per compilare servizi di Service Fabric con Java, installare JDK 1.8 e Gradle per eseguire le attività di compilazione. Il frammento di codice seguente installa Open JDK 1.8 insieme a Gradle. Il pull delle librerie Java per Service Fabric viene eseguito da Maven.

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

Installare il plug-in Eclipse Neon (facoltativo)

È possibile installare il plug-in Eclipse per Service Fabric dall'IDE di Eclipse per sviluppatori Java. È possibile usare Eclipse per creare applicazioni contenitore e applicazioni eseguibili guest di Service Fabric in aggiunta alle applicazioni Java di Service Fabric.

  1. In Eclipse assicurarsi che sia installata l'ultima versione di Eclipse Neon e di Buildship (1.0.17 o versione successiva). Per controllare le versioni dei componenti installati, selezionare Help > Installation Details (? > Dettagli installazione). È possibile aggiornare Buildship seguendo le istruzioni riportate in Eclipse Buildship: Eclipse Plug-ins for Gradle (Eclipse Buildship: plug-in Eclipse per Gradle).

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

  3. Nella casella Work with (Usa) digitare http://dl.microsoft.com/eclipse.

  4. Fare clic su Aggiungi.

    Pagina relativa al software disponibile

  5. Selezionare il plug-in ServiceFabric e quindi fare clic su Next (Avanti).

  6. Completare la procedura di installazione e quindi accettare il contratto di licenza con l'utente finale.

Se il plug-in Eclipse per Service Fabric è già installato, verificare che la versione sia la più recente. 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).

Per altre informazioni, vedere Plug-in Service Fabric per lo sviluppo di applicazioni Java in Eclipse.

Aggiornare SDK e runtime

Per aggiornare l'SDK e il runtime all'ultima versione, eseguire questi comandi:

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

Nota

L'aggiornamento dei pacchetti può causare l'arresto dell'esecuzione del cluster di sviluppo locale. Riavviare il cluster locale dopo un aggiornamento seguendo le istruzioni disponibili in questa pagina.

Rimuovere l'SDK

Per rimuovere le istanze di Service Fabric SDK, eseguire questi comandi:

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

Passaggi successivi