Préparer votre environnement de développement sur Windows

Pour générer et exécuter des applications Azure Service Fabric sur votre machine de développement Windows, installez le runtime, le Kit de développement logiciel (SDK) et les outils Service Fabric. Vous devez également activer l’exécution des scripts Windows PowerShell inclus dans le Kit de développement logiciel (SDK).

Prérequis

Vérifiez que vous utilisez une version de Windows prise en charge.

Installer le Kit de développement logiciel (SDK) et les outils

Notes

WebPI utilisé précédemment pour l’installation du SDK/des outils a été déprécié le 1er juillet 2022

Pour obtenir la dernière version du runtime et du SDK, vous pouvez télécharger à partir d’ici :

Package Version
Installer le runtime Service Fabric pour Windows 9.1.1436
Installer le SDK Service Fabric 6.1.1436

Vous trouverez des liens directs vers les programmes d’installation pour les versions précédentes sur Versions de Service Fabric

Pour les versions prises en charge, consultez Versions de Service Fabric.

Notes

Les clusters de machine unique (OneBox) ne sont pas pris en charge pour les mises à niveau d’Application ou de Cluster. Si vous avez besoin d’effectuer une mise à niveau de Cluster ou rencontrez des problèmes de mise à niveau d’Application, supprimez le cluster OneBox, puis recréez-le.

Pour utiliser Visual Studio 2017 ou 2019

Les outils Service Fabric Tools font partie de la charge de travail de développement Azure dans Visual Studio 2019 et 2017. Activez cette charge de travail dans le cadre de votre installation de Visual Studio. En outre, vous devez installer le SDK et le runtime Microsoft Azure Service Fabric, comme décrit ci-dessus : Installer le SDK et les outils

Activer l'exécution du script PowerShell

Service Fabric utilise des scripts Windows PowerShell pour créer un cluster de développement local et déployer des applications à partir de Visual Studio. Par défaut, Windows bloque l’exécution de ces scripts. Pour les activer, vous devez modifier votre stratégie d'exécution PowerShell. Ouvrez PowerShell en tant qu'administrateur et entrez la commande suivante :

Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Force -Scope CurrentUser

Installer Docker (facultatif)

Service Fabric est un orchestrateur de conteneurs qui permet de déployer des microservices sur un cluster de machines. Pour exécuter des applications de conteneur Windows sur votre cluster de développement local, vous devez d’abord installer Docker pour Windows. Obtenez Docker CE pour Windows (stable). Après l’installation et le démarrage de Docker, cliquez avec le bouton droit de la souris sur l’icône de la barre d’état, puis sélectionnez Switch to Windows containers (Basculer vers les conteneurs Windows). Cette étape est nécessaire pour exécuter des images Docker basées sur Windows.

Étapes suivantes

Maintenant que vous avez fini de configurer votre environnement de développement, commencez à créer et à exécuter des applications.