Preparación del entorno de desarrollo en Windows

  • Artículo

Para compilar y ejecutar aplicaciones de Azure Service Fabric en la máquina de desarrollo Windows, instale 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 que utiliza una versión de Windows compatible.

Descarga e instalación del entorno de ejecución y el SDK

Nota:

El 1 de julio de 2022, el instalador de plataforma web usado anteriormente para la instalación del SDK o de las herramientas, quedó en desuso.

El entorno de ejecución se puede instalar de forma independiente. Sin embargo, el SDK requiere el entorno de ejecución, por lo que para un entorno de desarrollo, debe instalar tanto el entorno de ejecución como el SDK. Los vínculos siguientes permiten la descarga de las versiones más recientes del entorno de ejecución y el SDK:

Paquete Versión
Instalación del entorno de ejecución de Service Fabric para Windows 10.1.1951.9590
Instalación del SDK de Service Fabric 7.1.1951

Puede encontrar vínculos directos a los instaladores para versiones anteriores en Versiones de Service Fabric.

Para conocer las versiones admitidas, consulte Versiones de Service Fabric.

Instalación de la instancia en tiempo de ejecución

El instalador del entorno de ejecución debe ejecutarse desde un shell de línea de comandos y debe usarse la marca /accepteula. Se recomienda ejecutar el shell de línea de comandos con privilegios elevados para conservar impresiones de los registros. El ejemplo siguiente está en PowerShell:

.\MicrosoftServiceFabric.<version>.exe /accepteula

Instalación del SDK

Una vez instalado el entorno de ejecución, puede instalar correctamente el SDK. Puede ejecutar el instalador desde el shell de línea de comandos o el explorador de archivos.

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.

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 y el entorno de ejecución de Microsoft Azure Service Fabric tal y como se describió anteriormente en Descarga e instalación del entorno de ejecución y el SDK.

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