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 Java e .NET Core.

Prerequisiti

Per lo sviluppo, sono supportati i sistemi operativi seguenti:

  • Ubuntu 16.04 (Xenial Xerus)

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/ trusty 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 l'SDK per contenitori ed eseguibili guest

Dopo aver aggiornato le origini, è possibile installare l'SDK.

  1. 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-v1 select true" | sudo debconf-set-selections
    echo "servicefabricsdkcommon servicefabricsdkcommon/accepted-eula-v1 select true" | sudo debconf-set-selections
    
  2. Eseguire lo script di configurazione dell'SDK.

    sudo /opt/microsoft/sdk/servicefabric/common/sdkcommonsetup.sh
    

Al termine dell'installazione del pacchetto SDK comune, sarà possibile creare app con servizi contenitore o eseguibili guest eseguendo yo azuresfguest o yo azuresfcontainer. Potrebbe essere necessario impostare la variabile di ambiente $NODE_PATH sul percorso dei moduli Node.

    export NODE_PATH=$NODE_PATH:$HOME/.node/lib/node_modules 

Se si usa l'ambiente come radice, potrebbe essere necessario impostare la variabile con il comando seguente:

    export NODE_PATH=$NODE_PATH:/root/.node/lib/node_modules 
Suggerimento

Può essere opportuno aggiungere questi comandi al file ~/.bashrc per non dover impostare la variabile di ambiente a ogni accesso.

Configurare l'interfaccia della riga di comando XPlat per Service Fabric

L'interfaccia della riga di comando di XPlat include comandi per l'interazione con entità di Service Fabric, come cluster e applicazioni. Dato che è basata su Node.js, prima di procedere con le istruzioni riportate di seguito assicurarsi di aver installato Node.

  1. Clonare il repository GitHub nel computer di sviluppo.

    git clone https://github.com/Azure/azure-xplat-cli.git
    
  2. Passare al repository clonato e installare le dipendenze dell'interfaccia della riga di comando usando Node Package Manager (npm).

    cd azure-xplat-cli
    npm install
    
  3. Creare un collegamento simbolico dalla cartella bin/azure del repository clonato a /usr/bin/azure.

    sudo ln -s $(pwd)/bin/azure /usr/bin/azure
    
  4. Abilitare infine il completamento automatico dei comandi di Service Fabric.

    azure --completion >> ~/azure.completion.sh
    echo 'source ~/azure.completion.sh' >> ~/.bash_profile
    source ~/azure.completion.sh
    

Configurare l'interfaccia della riga di comando di Azure 2.0

In alternativa all'interfaccia della riga di comando XPlat, è ora disponibile un modulo comandi di Service Fabric incluso nell'interfaccia della riga di comando di Azure.

Per altre informazioni sull'installazione dell'interfaccia della riga di comando di Azure 2.0 e l'uso dei comandi di Service Fabric, vedere l'introduzione a Service Fabric e all'interfaccia della riga di comando di Azure 2.0.

Configurare un cluster locale

Se l'installazione ha esito positivo, 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. L'anteprima supporta solo cluster con un solo computer e più computer Linux di Azure.

Installare Java SDK (facoltativo, per usare i modelli di programmazione Java)

Java SDK offre le librerie e i modelli necessari per creare servizi di Service Fabric con Java.

  1. Installare il pacchetto Java SDK.

    sudo apt-get install servicefabricsdkjava
    
  2. Eseguire lo script di configurazione dell'SDK.

    sudo /opt/microsoft/sdk/servicefabric/java/sdkjavasetup.sh
    

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.

Nota

Java SDK è un prerequisito per l'uso del plug-in Eclipse, anche se tale uso è limitato ad applicazioni contenitore ed eseguibili guest.

  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.

Installare .NET Core SDK (facoltativo, per usare i modelli di programmazione .NET Core)

.NET Core SDK offre le librerie e i modelli necessari per creare servizi di Service Fabric con .NET Core.

  1. Installare il pacchetto .NET Core SDK.

    sudo apt-get install servicefabricsdkcsharp
    
  2. Eseguire lo script di configurazione dell'SDK.

    sudo /opt/microsoft/sdk/servicefabric/csharp/sdkcsharpsetup.sh
    

Aggiornare SDK e runtime

Per aggiornare l'SDK e il runtime alla versione più recente, eseguire questi comandi deselezionando gli SDK da non aggiornare:

sudo apt-get update
sudo apt-get install servicefabric servicefabricsdkcommon servicefabricsdkcsharp servicefabricsdkjava
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.

Passaggi successivi