Préparer votre environnement de développement sur Windows

  • Article

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

Veillez à utiliser une version de Windows prise en charge.

Télécharger et installer le runtime et le Kit de développement logiciel (SDK)

Remarque

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

Le runtime peut être installé indépendamment. Toutefois, le Kit de développement logiciel (SDK) nécessite le runtime. Par conséquent, pour un environnement de développement, vous devez installer à la fois le runtime et le Kit de développement logiciel (SDK). Les liens suivants sont téléchargés pour les dernières versions du runtime et du Kit de développement logiciel (SDK) :

Package Version
Installer le runtime Service Fabric pour Windows 10.1.1951.9590
Installer le SDK Service Fabric 7.1.1951

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

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

Installer le runtime

Le programme d’installation du runtime doit être exécuté à partir d’un interpréteur de ligne de commandes, et vous devez utiliser l’indicateur /accepteula. Nous vous recommandons d’exécuter votre interpréteur de ligne de commandes avec des privilèges élevés pour conserver les sorties de journalisation. L’exemple suivant est utilisé dans PowerShell :

.\MicrosoftServiceFabric.<version>.exe /accepteula

Installer le SDK

Une fois le runtime installé, vous pouvez correctement installer le Kit de développement logiciel (SDK). Vous pouvez exécuter le programme d’installation à partir de l’interpréteur de ligne de commandes ou de votre explorateur de fichiers.

Remarque

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 Kit de développement logiciel (SDK) et le runtime Microsoft Azure Service Fabric, comme décrit dans Télécharger et installer le runtime et le Kit de développement logiciel (SDK) ci-dessus.

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, faites un clic droit sur l’icône de la barre d’état, puis sélectionnez 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, vous pouvez commencer à créer et à exécuter des applications.