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 scarica il file Vagrantfile contenente la configurazione della VM con il percorso da cui viene scaricata la VM.

  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
    

    In questo passaggio viene scaricata e avviata in locale l'immagine di VM preconfigurata e vi viene quindi configurato un cluster di Service Fabric locale. È probabile che questo passaggio richieda alcuni minuti. Se la configurazione ha esito positivo, nell'output verrà visualizzato un messaggio che indica che è in corso l'avvio del cluster.

    Avvio della configurazione del cluster dopo il provisioning della VM

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.

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

Uso del plug-in Service Fabric Eclipse in Mac

Assicurarsi di aver completato la procedura illustrata nella documentazione del plug-in Service Fabric Eclipse. La procedura per la creazione, la compilazione e la distribuzione di applicazioni Java di Service Fabric usando un contenitore guest Vagrant in un host Mac è molto simile a quella illustrata nella documentazione generale, a parte gli elementi seguenti:

  • Dal momento che le librerie di Service Fabric sono necessarie per l'applicazione Java di Service Fabric, il progetto Eclipse deve essere creato in un percorso condiviso. Per impostazione predefinita, il contenuto nel percorso dell'host in cui esiste Vagrantfile è condiviso con il percorso /vagrant nel guest.
  • Se Vagrantfile si trova nel percorso~/home/john/allprojects/, ad esempio, è necessario creare il progetto di Service Fabric MyActor nel percorso ~/home/john/allprojects/MyActor e il percorso dell'area di lavoro di Eclipse sarà ~/home/john/allprojects.

Passaggi successivi