Preparación del entorno de desarrollo en Linux

Para implementar y ejecutar aplicaciones de Azure Service Fabric en la máquina de desarrollo de Linux, instale el motor de tiempo de ejecución y el SDK común. También puede instalar SDK opcionales para el desarrollo con Java y .NET Core.

En los pasos descritos en este artículo se supone que va a instalar de forma nativa en Linux o que va a usar la imagen de contenedor de Service Fabric OneBox, es decir, mcr.microsoft.com/service-fabric/onebox:u18.

Puede administrar las entidades de Service Fabric hospedadas en la nube o en el entorno local mediante la interfaz de la línea de comandos (CLI) de Azure Service Fabric. Para más información acerca de cómo instalar la CLI, consulte Configuración de la CLI de Service Fabric.

Requisitos previos

• Asegúrese de que usa una versión de Linux compatible.

• Instale el paquete apt-transport-https:

  sudo apt-get install apt-transport-https
  

Métodos de instalación

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

sudo apt-get install servicefabricsdkcommon

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

sudo yum install servicefabricsdkcommon

Instalación de un clúster local

1. Inicie un clúster de Service Fabric local para desarrollo.

2. Abra un explorador web y vaya a Service Fabric Explorer (http://localhost:19080/Explorer). Al iniciarse el clúster, debería ver el panel de Service Fabric Explorer. El clúster puede tardar varios minutos en configurarse totalmente. Si el explorador no abre la dirección URL o si Service Fabric Explorer no muestra que el sistema está listo, espere unos minutos y vuelva a intentarlo.

   

   Ahora, puede implementar paquetes de aplicación de Service Fabric precompilados o nuevos basados en contenedores de invitado o archivos ejecutables de invitado. Para compilar nuevos servicios con los SDK de .NET Core o de Java, siga los pasos de configuración opcionales que se proporcionan en las siguientes secciones.

Configuración de la CLI de Service Fabric

La CLI de Service Fabric tiene comandos para interactuar con las entidades de Service Fabric, incluidos los clústeres y las aplicaciones. Siga las instrucciones que aparecen en la CLI de Service Fabric para instalar la CLI.

Instalación de los generadores Yeoman para los contenedores y los ejecutables invitados

Service Fabric proporciona herramientas de scaffolding que le ayudarán a crear aplicaciones de Service Fabric desde un terminal mediante los generadores de plantillas Yeoman. Siga estos pasos para configurar los generadores de plantillas de Service Fabric Yeoman:

1. Instale Node.js y NPM en la máquina.

   sudo add-apt-repository "deb https://deb.nodesource.com/node_8.x $(lsb_release -s -c) main"
   sudo apt-get update
   sudo apt-get install nodejs
   

2. Instale el generador de plantillas Yeoman en la máquina desde NPM.

   sudo npm install -g yo
   

3. Instalación del generador de contenedores Yeo de Service Fabric y el generador de ejecutables invitados desde NPM.

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

Después de instalar los generadores, cree ejecutables invitados o servicios de contenedor mediante la ejecución de yo azuresfguest o yo azuresfcontainer respectivamente.

Configuración del desarrollo con .NET Core 3.1

Instale el SDK de .NET Core 3.1 para Ubuntu para iniciar la creación de aplicaciones de Service Fabric en C#. Los paquetes de aplicaciones de Service Fabric en .NET Core se hospedan en NuGet.org.

Configuración del desarrollo de Java

Para compilar servicios de Service Fabric mediante Java, instale Gradle para ejecutar las tareas de compilación. Ejecute el siguiente comando para instalar Gradle. Las bibliotecas de Java de Service Fabric se extraen de Maven.

• Ubuntu

  curl -s https://get.sdkman.io | bash
  sdk install gradle 5.1
  

• Red Hat Enterprise Linux 7.4 (compatibilidad con la versión preliminar de Service Fabric)

  sudo yum install java-1.8.0-openjdk-devel
  curl -s https://get.sdkman.io | bash
  sdk install gradle
  

También debe instalar el generador Yeo de Service Fabric para archivos ejecutables de Java. Asegúrese de que tiene Yeoman instalado y, a continuación, ejecute el siguiente comando:

npm install -g generator-azuresfjava

Instalación del complemento de Eclipse (opcional)

El complemento de Eclipse para Service Fabric se puede instalar desde el IDE de Eclipse para desarrolladores de Java o desarrolladores de Java EE. Eclipse se puede usar para crear aplicaciones ejecutables y contenedoras de invitado de Service Fabric, además de aplicaciones Java de Service Fabric.

1. En Eclipse, asegúrese de que tanto Eclipse Neon, o posterior, como la versión 2.2.1 de Buildship, o posterior, están instalados. Para comprobar las versiones de los componentes instalados, seleccione Help>About Eclipse>Installation Details (Ayuda > Acerca de Eclipse > Detalles de instalación). Puede actualizar Buildship siguiendo las instrucciones de Eclipse Buildship: Complementos de Eclipse para Gradle.

2. Para instalar el complemento de Service Fabric, seleccione Help>Install New Software (Ayuda > Instalar nuevo software).

3. En el cuadro Work with (Trabajar con), escriba https://dl.microsoft.com/eclipse .

4. Seleccione Agregar.

   

5. Seleccione el complemento ServiceFabric y, a continuación, seleccione Siguiente.

6. Realice los pasos de instalación. Después, acepte el contrato de licencia para el usuario final.

Si el complemento de Eclipse para Service Fabric ya está instalado, asegúrese de que tiene la versión más reciente. Puede comprobarlo seleccionando Help>About Eclipse>Installation Details (Ayuda > Acerca de Eclipse > Detalles de instalación). A continuación, busque Service Fabric en la lista de complementos instalados. Seleccione Actualizar si hay disponible una versión más reciente.

Para más información, consulte Complemento de Service Fabric para el desarrollo de aplicaciones Java de Eclipse.

Actualización del SDK y del runtime

Para actualizar a la versión más reciente del SDK y el sistema en tiempo de ejecución, ejecute los siguientes comandos.

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

Para actualizar los archivos binarios del SDK de Java desde Maven, debe actualizar los detalles de la versión del archivo binario correspondiente en el archivo build.gradle para que señale a la versión más reciente. Para saber exactamente dónde debe actualizar la versión, consulte cualquier archivo build.gradle en los ejemplos de Introducción a Service Fabric.

Eliminación del SDK

Para quitar los SDK de Service Fabric, ejecute los siguientes comandos.

• Ubuntu

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

• Red Hat Enterprise Linux 7.4 (compatibilidad con la versión preliminar de Service Fabric)

  sudo yum remove servicefabric servicefabicsdkcommon
  npm uninstall -g generator-azuresfcontainer
  npm uninstall -g generator-azuresfguest
  

Pasos siguientes

• Creación e implementación de la primera aplicación de Java para Service Fabric en Linux con Yeoman
• Creación e implementación de la primera aplicación de Java para Service Fabric en Linux con el complemento de Eclipse para Service Fabric
• Creación de su primera aplicación de C# en Linux
• Prepare your development environment on OSX
• Preparación del entorno de desarrollo Linux en Windows
• Uso de la CLI de Service Fabric para administrar las aplicaciones
• Diferencias entre Service Fabric para Windows y para Linux
• Introducción a la CLI de Service Fabric