Preparación del entorno de desarrollo en Windows

Para compilar y ejecutar aplicaciones de Azure Service Fabric en la máquina de desarrollo Windows, debe instalar el entorno en tiempo de ejecución de Service Fabric, el SDK y las herramientas. También es preciso que habilite la ejecución de los scripts de Windows PowerShell que se incluyen en el SDK.

Requisitos previos

Asegúrese de usar una versión de Windows compatible.

Instalación de SDK y herramientas

El Instalador de plataforma Web (WebPI) es la manera recomendada para instalar el SDK y las herramientas. Si recibe errores en tiempo de ejecución utilizando WebPI, también puede encontrar vínculos directos a los instaladores en las notas de la versión para una versión específica de Service Fabric. Las notas de la versión se pueden encontrar en los anuncios de lanzamiento en el blog del equipo de Service Fabric.

Nota

No se admiten actualizaciones locales del clúster de desarrollo de Service Fabric.

Cómo usar Visual Studio 2017 o 2019

Las herramientas de Service Fabric forman parte de la carga de trabajo de Azure Development de Visual Studio 2019 y 2017. Habilite esta carga de trabajo durante la instalación de Visual Studio. Además, debe instalar el SDK de Microsoft Azure Service Fabric y el entorno en tiempo de ejecución mediante el Instalador de plataforma web.

Para instalar solamente el SDK

Si únicamente necesita el SDK, puede instalar este paquete:

Las versiones actuales son:

  • SDK y herramientas de Service Fabric 5.2.1235
  • Entorno de ejecución de Service Fabric 8.2.1235

Para obtener una lista de las versiones admitidas, consulte Versiones de Service Fabric.

Nota

Los clústeres de máquina única (OneBox) no se admiten para las actualizaciones de aplicación o de clúster; elimine el clúster OneBox y vuelva a crearlo si necesita realizar una actualización de clúster, o tiene algún problema al realizar una actualización de la aplicación.

Habilitar la ejecución del script de PowerShell

Service Fabric usa scripts de Windows PowerShell para crear un clúster de desarrollo local e implementar aplicaciones desde Visual Studio. De forma predeterminada, Windows bloquea la ejecución de estos scripts. Para habilitarlos, debe modificar la directiva de ejecución de PowerShell. Abra PowerShell como administrador y escriba el siguiente comando:

Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Force -Scope CurrentUser

Instalar Docker (opcional)

Service Fabric es un orquestador de contenedores que implementa microservicios en un clúster de máquinas. Para ejecutar aplicaciones contenedoras de Windows en el clúster de desarrollo local, primero debe instalar Docker para Windows. Obtener Docker CE para Windows (estable). Después de instalar e iniciar Docker, haga clic con el botón derecho en el icono de la bandeja y seleccione Switch to Windows containers (Conmutar a contenedores de Windows), Este paso es necesario para ejecutar imágenes de Docker basadas en Windows.

Pasos siguientes

Ahora que ha terminado la configuración del entorno de desarrollo, puede empezar a compilar y ejecutar aplicaciones.