Créer un cluster autonome s’exécutant sur Windows Server

  • Article

Vous pouvez utiliser Azure Service Fabric pour créer des clusters Service Fabric sur toute machine virtuelle ou tout ordinateur exécutant Windows Server. Cela signifie que vous pouvez déployer et exécuter des applications Service Fabric dans n’importe quel environnement contenant un ensemble d’ordinateurs Windows Server interconnectés, que ce soit en local ou avec un fournisseur cloud. Service Fabric fournit un package d’installation pour créer des clusters Service Fabric, appelé package Windows Server autonome. Les clusters Service Fabric traditionnels sur Azure sont disponibles en tant que service managé, tandis que les clusters Service Fabric autonomes sont en libre-service. Pour en savoir plus sur les différences, consultez Comparaison entre Azure et des clusters Service Fabric autonomes.

Cet article vous guide tout au long du processus de création d’un cluster Service Fabric autonome.

Notes

Ce package de Windows Server autonome est publié gratuitement et peut être utilisé pour les déploiements de production. Ce package peut contenir de nouvelles fonctionnalités Service Fabric en version « préliminaire ». Faites défiler la section " Fonctions de prévisualisation incluses dans ce paquet " pour obtenir la liste des fonctions de prévisualisation. Vous pouvez télécharger une copie du CLUF maintenant.

Obtenir de l’aide pour le package Service Fabric pour Windows Server

Télécharger le package Service Fabric pour Windows Server

Pour créer le cluster, utilisez le package Service Fabric pour Windows Server (Windows Server 2012 R2 et versions ultérieures) disponible ici :
Lien de téléchargement - Package autonome Service Fabric - Windows Server

Plus d’informations sur le contenu du package ici.

Le package de runtime Service Fabric est automatiquement téléchargé lors de la création du cluster. En cas de déploiement à partir d’un ordinateur non connecté à Internet, téléchargez le package de runtime hors bande à partir d’ici :
Lien de téléchargement - Runtime Service Fabric - Windows Server

Recherchez des exemples de configuration de cluster autonome sous :
Exemples de configuration de cluster autonome

Créer le cluster

Plusieurs fichiers d’exemples de configuration de cluster sont installés avec le package d’installation. ClusterConfig.Unsecure.DevCluster.json correspond à la configuration de cluster la plus simple : un cluster à trois nœuds non sécurisé, s’exécutant sur un seul ordinateur. Les autres fichiers de configuration décrivent des clusters uniques ou de plusieurs ordinateurs, sécurisés à l’aide de certificats X.509 ou de la sécurité Windows. Vous n’avez pas besoin de modifier les paramètres de configuration par défaut pour ce didacticiel, mais parcourez le fichier de configuration et familiarisez-vous avec les paramètres. La section Nœuds décrit les trois nœuds du cluster : nom, adresse IP, type de nœud, domaine d’erreur et domaine de mise à niveau. La section Propriétés définit la sécurité, le niveau de fiabilité, la collecte des diagnostics et les types de nœuds pour le cluster.

Le cluster créé dans cet article n’est pas sécurisé. N’importe qui peut se connecter anonymement et effectuer des opérations de gestion. Les clusters de production doivent donc toujours être sécurisés à l’aide de certificats X.509 ou via la sécurité Windows. La sécurité peut uniquement être configurée au moment de la création du cluster et il n’est pas possible d’activer la sécurité une fois le cluster créé. La mise à jour du fichier de configuration active la sécurité par certificat ou la sécurité Windows. Lisez Sécuriser un cluster pour en savoir plus sur la sécurité du cluster Service Fabric.

Étape 1 : Créer le cluster

Scénario A : Créer un cluster de développement local non sécurisé

Service Fabric peut être déployé vers un cluster de développement avec un ordinateur à l’aide du fichier ClusterConfig.Unsecure.DevCluster.json inclus dans les exemples.

Décompressez le package autonome sur votre ordinateur, copiez l’exemple de fichier de configuration sur l’ordinateur local, puis exécutez le script CreateServiceFabricCluster.ps1 par le biais d’une session administrateur PowerShell, à partir du dossier du package autonome.

.\CreateServiceFabricCluster.ps1 -ClusterConfigFilePath .\ClusterConfig.Unsecure.DevCluster.json -AcceptEULA

Consultez la section Configuration de l’environnement sous Planifier et préparer le déploiement de cluster pour obtenir plus d’informations de dépannage.

Si vous avez fini d’exécuter les scénarios de développement, vous pouvez supprimer le cluster Service Fabric de l’ordinateur en vous reportant aux étapes de la section « Supprimer un cluster ».

Scénario B : Créer un cluster de plusieurs ordinateurs

Après avoir effectué les tâches de planification et de préparation détaillées dans Planifier et préparer le déploiement de cluster, vous êtes prêt à créer votre cluster de production à l’aide de votre fichier de configuration de cluster.

L’administrateur de cluster déployant et configurant le cluster doit disposer de privilèges d’administrateur sur l’ordinateur. Vous ne pouvez pas installer Service Fabric sur un contrôleur de domaine.

  1. Le script TestConfiguration.ps1 contenu dans le package autonome est utilisé pour analyser les meilleures pratiques, afin de vérifier si un cluster peut être déployé dans un environnement donné. La section Préparation du déploiement répertorie les conditions préalables et les exigences de l’environnement. Exécutez le script pour vérifier si vous pouvez créer le cluster de développement :

    .\TestConfiguration.ps1 -ClusterConfigFilePath .\ClusterConfig.json

    Le résultat ressemble à ce qui suit. Si le champ du bas « Passed » (Transmis) est retourné avec la valeur « True », les contrôles de validité ont réussi et le cluster semble être déployable à l’aide de la configuration d’entrée.

    Trace folder already exists. Traces will be written to existing trace folder: C:\temp\Microsoft.Azure.ServiceFabric.WindowsServer\DeploymentTraces
Running Best Practices Analyzer...
Best Practices Analyzer completed successfully.

LocalAdminPrivilege        : True
IsJsonValid                : True
IsCabValid                 : True
RequiredPortsOpen          : True
RemoteRegistryAvailable    : True
FirewallAvailable          : True
RpcCheckPassed             : True
NoConflictingInstallations : True
FabricInstallable          : True
Passed                     : True

  2. Créez le cluster : exécutez le script CreateServiceFabricCluster.ps1 pour déployer le cluster Service Fabric sur chaque ordinateur dans la configuration.

    .\CreateServiceFabricCluster.ps1 -ClusterConfigFilePath .\ClusterConfig.json -AcceptEULA

Notes

Les traces de déploiement sont écrites sur la machine virtuelle/l’ordinateur où vous avez exécuté le script PowerShell CreateServiceFabricCluster.ps1. Elles ne se trouvent pas dans le sous-dossier DeploymentTraces, situé dans le répertoire à partir duquel le script a été exécuté. Pour voir si Service Fabric a été déployé correctement sur un ordinateur, recherchez les fichiers installés dans le répertoire FabricDataRoot, comme indiqué dans la section FabricSettings du fichier de configuration du cluster (par défaut c:\ProgramData\SF). De même, vous pouvez consulter l’exécution des processus FabricHost.exe et Fabric.exe dans le Gestionnaire des tâches.

Scénario C : Créer un cluster hors connexion (déconnecté d’Internet)

Le package de runtime Service Fabric est automatiquement téléchargé lors de la création du cluster. Lorsque vous déployez un cluster sur des ordinateurs qui ne sont pas connectés à Internet, vous devrez télécharger le package de runtime Service Fabric séparément et fournir le chemin d’accès à celui-ci lors de la création du cluster. Le package de runtime peut être téléchargé séparément, à partir d’un autre ordinateur connecté à Internet, en cliquant sur le lien de téléchargement - Runtime Service Fabric - Windows Server. Copiez le package de runtime à l’endroit où vous déployez le cluster hors connexion et créez le cluster en exécutant CreateServiceFabricCluster.ps1 avec le paramètre -FabricRuntimePackagePath inclus, comme indiqué dans cet exemple :

.\CreateServiceFabricCluster.ps1 -ClusterConfigFilePath .\ClusterConfig.json -FabricRuntimePackagePath .\MicrosoftAzureServiceFabric.cab

.\ClusterConfig.json et .\MicrosoftAzureServiceFabric.cab sont, respectivement, les chemins de la configuration du cluster et du fichier .cab de runtime.

Étape 2 : Se connecter au cluster

Connectez-vous au cluster pour vérifier que le cluster est en cours d’exécution et disponible. Le module Service Fabric PowerShell est installé avec le runtime. Vous pouvez vous connecter au cluster à partir de l’un des nœuds de cluster ou d’un ordinateur distant avec le runtime Service Fabric. L’applet de commande Connect-ServiceFabricCluster établit une connexion au cluster.

Exécutez la commande PowerShell suivante pour vous connecter à un cluster non sécurisé :

Connect-ServiceFabricCluster -ConnectionEndpoint <*IPAddressofaMachine*>:<Client connection end point port>

Par exemple :

Connect-ServiceFabricCluster -ConnectionEndpoint 192.13.123.234:19000

Pour obtenir des exemples de connexion à un cluster, consultez Se connecter à un cluster sécurisé . Une fois connecté au cluster, utilisez l’applet de commande Get-ServiceFabricNode pour afficher une liste des nœuds du cluster et les informations d’état pour chaque nœud. HealthState doit être à l’état OK pour chaque nœud.

PS C:\temp\Microsoft.Azure.ServiceFabric.WindowsServer> Get-ServiceFabricNode |Format-Table

NodeDeactivationInfo NodeName IpAddressOrFQDN NodeType  CodeVersion  ConfigVersion NodeStatus NodeUpTime NodeDownTime HealthState
-------------------- -------- --------------- --------  -----------  ------------- ---------- ---------- ------------ -----------
                     vm2      localhost       NodeType2 5.6.220.9494 0                     Up 00:03:38   00:00:00              OK
                     vm1      localhost       NodeType1 5.6.220.9494 0                     Up 00:03:38   00:00:00              OK
                     vm0      localhost       NodeType0 5.6.220.9494 0                     Up 00:02:43   00:00:00              OK

Étape 3 : Visualiser votre cluster à l’aide de l’outil Service Fabric Explorer

Service Fabric Explorer est un bon outil pour visualiser votre cluster et gérer les applications. Service Fabric Explorer est un service qui s’exécute dans le cluster, auquel vous accédez à l’aide d’un navigateur en utilisant l’adresse http://localhost:19080/Explorer.

Le tableau de bord de cluster fournit une vue d’ensemble de votre cluster, y compris un résumé de l’intégrité de l’application et du nœud. L’affichage des nœuds montre la disposition physique du cluster. Vous pouvez identifier les applications ayant déployé du code sur un nœud donné.

Service Fabric Explorer

Ajouter et supprimer des nœuds

Vous pouvez ajouter des nœuds à votre cluster Service Fabric autonome ou en supprimer en fonction de l’évolution de vos besoins. Consultez l’article Ajouter ou supprimer des nœuds à/d’un cluster Service Fabric autonome pour obtenir des instructions détaillées.

Supprimer un cluster

Pour supprimer un cluster, exécutez le script PowerShell RemoveServiceFabricCluster.ps1 à partir du dossier de package et transmettez le chemin du fichier de configuration JSON. Vous pouvez éventuellement spécifier un emplacement pour le journal de la suppression.

Ce script peut être exécuté sur n’importe quel ordinateur disposant d’un accès administrateur à tous les ordinateurs qui sont répertoriés en tant que nœuds dans le fichier de configuration du cluster. L’ordinateur sur lequel ce script est exécuté ne doit pas nécessairement faire partie du cluster.

# Removes Service Fabric from each machine in the configuration
.\RemoveServiceFabricCluster.ps1 -ClusterConfigFilePath .\ClusterConfig.json -Force

# Removes Service Fabric from the current machine
.\CleanFabric.ps1

Données de télémétrie recueillies et comment se désabonner

Par défaut, le produit collecte les données de télémétrie sur l’utilisation de Service Fabric en vue de l’améliorer. Si le service n’est pas joignable, la configuration échoue, sauf si vous vous désabonnez de la télémétrie.

  1. Ce meilleur téléchargement n’a aucun impact sur la fonctionnalité de cluster. Les données de télémétrie sont envoyées uniquement à partir du nœud qui exécute le service Failover Manager principal. Aucun autre nœud n’envoie des données de télémétrie.
  2. La télémétrie se compose des éléments suivants :
  • Nombre de services
  • Nombre de ServiceTypes
  • Nombre de Applications
  • Nombre de ApplicationUpgrades
  • Nombre de FailoverUnits
  • Nombre de InBuildFailoverUnits
  • Nombre de UnhealthyFailoverUnits
  • Nombre de Replicas
  • Nombre de InBuildReplicas
  • Nombre de StandByReplicas
  • Nombre de OfflineReplicas
  • CommonQueueLength
  • QueryQueueLength
  • FailoverUnitQueueLength
  • CommitQueueLength
  • Nombre de nœuds
  • IsContextComplete : True/False
  • ClusterId : GUID généré de manière aléatoire pour chaque cluster
  • ServiceFabricVersion
  • Adresse IP de la machine virtuelle ou de l’ordinateur à partir de laquelle/duquel les données de télémétrie sont téléchargées

Pour désactiver les données de télémétrie, ajoutez ce qui suit à properties dans votre configuration de cluster : enableTelemetry: false.

Fonctionnalités préliminaires incluses dans ce package

Aucun.

Notes

À partir de la nouvelle version mise à la disposition générale du cluster autonome pour Windows Server (version 5.3.204.x), vous pouvez mettre à niveau votre cluster vers des versions ultérieures, manuellement ou automatiquement. Reportez-vous au document Mettre à niveau une version autonome du cluster Service Fabric pour plus d’informations.

Étapes suivantes