Configurare l'ambiente di sviluppo in Mac OS X

È possibile creare applicazioni di Service Fabric da eseguire in cluster Linux usando Mac OS X. Questo articolo illustra come configurare il computer Mac per lo sviluppo.

Prerequisiti

Service Fabric non viene eseguito in modo nativo in OS X. Per eseguire un cluster di Service Fabric locale, viene creata una macchina virtuale Ubuntu preconfigurata con Vagrant e VirtualBox. Prima di iniziare, sono necessari:

Nota

È necessario usare versioni con supporto reciproco di Vagrant e VirtualBox. Vagrant potrebbe non funzionare correttamente in una versione di VirtualBox non supportata.

Creare la VM locale

Per creare la VM locale contenente un cluster di Service Fabric a 5 nodi, seguire questa procedura:

  1. Clonare il repository Vagrantfile

    git clone https://github.com/azure/service-fabric-linux-vagrant-onebox.git
    

    Questo passaggio consente di scaricare il file Vagrantfile contenente la configurazione della VM con il percorso da cui viene scaricata la VM stessa. Il file punta a un'immagine Ubuntu predefinita.

  2. Passare al clone locale del repository

    cd service-fabric-linux-vagrant-onebox
    
  3. (Facoltativo) Modificare le impostazioni predefinite della VM

    Per impostazione predefinita, la VM locale è configurata come segue:

    • 3 GB di memoria allocati
    • Rete host privata configurata all'indirizzo IP 192.168.50.50 che consente il pass-through del traffico dall'host Mac

      È possibile modificare una di queste impostazioni o aggiungere altre opzioni di configurazione della VM in Vagrantfile. Per l'elenco completo delle opzioni di configurazione, vedere la documentazione di Vagrant .

  4. Creare la VM

    vagrant up
    
  5. Accedere alla VM e installare Service Fabric SDK

    vagrant ssh
    

    Installare l'SDK come descritto in Installare l'SDK. Lo script seguente viene fornito per praticità per l'installazione del runtime di Service Fabric e dell'SDK comune di Service Fabric insieme all'interfaccia della riga di comando sfctl. Per l'esecuzione dello script si presuppone che siano state lette e accettate le licenze di tutto il software da installare.

    sudo curl -s https://raw.githubusercontent.com/Azure/service-fabric-scripts-and-templates/master/scripts/SetupServiceFabric/SetupServiceFabric.sh | sudo bash
    
  6. Avviare il cluster di Service Fabric

    sudo /opt/microsoft/sdk/servicefabric/common/clustersetup/devclustersetup.sh
    

    Suggerimento

    Se il download della VM impiega troppo tempo, è possibile scaricarla con wget o curl oppure un browser passando al collegamento specificato da config.vm.box_url nel file Vagrantfile. Dopo averla scaricata in locale, modificare Vagrantfile in modo che punti al percorso locale in cui si è scaricata l'immagine. Se, ad esempio, si è scaricata l'immagine in /home/users/test/azureservicefabric.tp8.box, impostare config.vm.box_url su tale percorso.

  7. Verificare che il cluster sia stato configurato correttamente passando a Service Fabric Explorer all'indirizzo http://192.168.50.50:19080/Explorer, presupponendo che sia stato mantenuto l'IP predefinito della rete privata.

    Visualizzazione di Service Fabric Explorer dal Mac host

Installare gli elementi Java necessari in Vagrant per usare il modello di programmazione Java di Service Fabric

Per creare servizi di Service Fabric usando Java, assicurarsi che JDK 1.8 sia installato insieme a Gradle, usato per l'esecuzione di 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.

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

Configurare l'interfaccia della riga di comando di Service Fabric (sfctl) in un computer Mac

Per installare l'interfaccia della riga di comando di Service Fabric (sfctl) in un computer Mac, seguire le istruzioni riportate in Interfaccia della riga di comando di Azure Service Fabric. I comandi dell'interfaccia della riga di comando di Service Fabric consentono di interagire con entità come cluster, applicazioni e servizi.

Creare un'applicazione in un computer Mac con Yeoman

Service Fabric offre gli strumenti di scaffolding che consentono di creare un'applicazione Service Fabric dal terminale tramite il generatore di modelli Yeoman. Seguire questa procedura per assicurarsi che nella macchina virtuale sia disponibile il generatore di modelli Yeoman di Service Fabric.

  1. È necessario che Node.js e NPM siano installati nel computer Mac. In caso contrario, è possibile installare Node.js e NPM tramite Homebrew usando il comando seguente. Per verificare le versioni di Node.js e NPM installate nel computer Mac, è possibile usare l'opzione -v.

    brew install node
    node -v
    npm -v
    
  2. Installare il generatore di modelli Yeoman nella macchina virtuale da NPM

    npm install -g yo
    
  3. Installare il generatore Yeoman da usare, seguendo la procedura disponibile nella documentazione introduttiva. Per creare applicazioni Service Fabric tramite Yeoman, seguire questa procedura:

    npm install -g generator-azuresfjava       # for Service Fabric Java Applications
    npm install -g generator-azuresfguest      # for Service Fabric Guest executables
    npm install -g generator-azuresfcontainer  # for Service Fabric Container Applications
    
  4. Per compilare un'applicazione Java per Service Fabric nel computer Mac, è necessario che JDK 1.8 e Gradle siano installati nella macchina virtuale.

Configurare lo sviluppo .NET Core 2.0

Installare il .NET Core 2.0 SDK per Mac 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.

Installare il plug-in Service Fabric per Eclipse Neon

Service Fabric offre un plug-in per Eclipse Neon per l'ambiente IDE Java che può semplificare il processo di creazione, compilazione e distribuzione di servizi Java. È possibile seguire la procedura di installazione illustrata in questa documentazione generale sull'installazione e l'aggiornamento del plug-in Service Fabric Eclipse.

Suggerimento

Per impostazione predefinita, viene supportato l'indirizzo IP predefinito, come indicato in Vagrantfile nel fileLocal.json dell'applicazione generata. Se si modifica tale impostazione e si distribuisce Vagrant con un indirizzo IP diverso, aggiornare anche l'indirizzo IP corrispondente nel file Local.json dell'applicazione.

Passaggi successivi