Créer un cluster autonome s’exécutant sur Windows ServerCreate a standalone cluster running on Windows Server

Vous pouvez utiliser Azure Service Fabric pour créer des clusters Service Fabric sur toute machine virtuelle ou tout ordinateur exécutant Windows Server.You can use Azure Service Fabric to create Service Fabric clusters on any virtual machines or computers running 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.This means you can deploy and run Service Fabric applications in any environment that contains a set of interconnected Windows Server computers, be it on premises or with any cloud provider. Service Fabric fournit un package d’installation pour créer des clusters Service Fabric, appelé package Windows Server autonome.Service Fabric provides a setup package to create Service Fabric clusters called the standalone Windows Server package. 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.Traditional Service Fabric clusters on Azure are available as a managed service, while standalone Service Fabric clusters are self-service.

Cet article vous guide tout au long du processus de création d’un cluster Service Fabric autonome.This article walks you through the steps for creating a Service Fabric standalone cluster.

Notes

Ce package de Windows Server autonome est publié gratuitement et peut être utilisé pour les déploiements de production.This standalone Windows Server package is commercially available at no cost and may be used for production deployments. Ce package peut contenir de nouvelles fonctionnalités Service Fabric en version « préliminaire ».This package may contain new Service Fabric features that are in "Preview". Faites défiler jusqu’à la section « Fonctionnalités préliminaires incluses dans ce package. »Scroll down to "Preview features included in this package." pour obtenir la liste des fonctionnalités préliminaires.section for the list of the preview features. Vous pouvez télécharger une copie du CLUF maintenant.You can download a copy of the EULA now.

Obtenir de l’aide pour le package Service Fabric pour Windows ServerGet support for the Service Fabric for Windows Server package

Télécharger le package Service Fabric pour Windows ServerDownload the Service Fabric for Windows Server package

Pour créer le cluster, utilisez le package Service Fabric pour Windows Server (Windows Server 2012 R2 et versions ultérieures) disponible ici :To create the cluster, use the Service Fabric for Windows Server package (Windows Server 2012 R2 and newer) found here:
Lien de téléchargement - Package autonome Service Fabric - Windows ServerDownload Link - Service Fabric Standalone Package - Windows Server

Plus d’informations sur le contenu du package ici.Find details on contents of the package here.

Le package de runtime Service Fabric est automatiquement téléchargé lors de la création du cluster.The Service Fabric runtime package is automatically downloaded at time of cluster creation. En cas de déploiement à partir d’un ordinateur non connecté à Internet, téléchargez le package de runtime hors bande à partir d’ici :If deploying from a machine not connected to the internet, please download the runtime package out of band from here:
Lien de téléchargement - Runtime Service Fabric - Windows ServerDownload Link - Service Fabric Runtime - Windows Server

Recherchez des exemples de configuration de cluster autonome sous :Find Standalone Cluster Configuration samples at:
Exemples de configuration de cluster autonomeStandalone Cluster Configuration Samples

Création du clusterCreate the cluster

Plusieurs fichiers d’exemples de configuration de cluster sont installés avec le package d’installation.Several sample cluster configuration files are installed with the setup package. 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.ClusterConfig.Unsecure.DevCluster.json is the simplest cluster configuration: an unsecure, three-node cluster running on a single computer. 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.Other config files describe single or multi-machine clusters secured with X.509 certificates or Windows security. 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.You don't need to modify any of the default config settings for this tutorial, but look through the config file and get familiar with the settings. 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.The nodes section describes the three nodes in the cluster: name, IP address, node type, fault domain, and upgrade domain. 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.The properties section defines the security, reliability level, diagnostics collection, and types of nodes for the cluster.

Le cluster créé dans cet article n’est pas sécurisé.The cluster created in this article is unsecure. 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.Anyone can connect anonymously and perform management operations, so production clusters should always be secured using X.509 certificates or Windows security. 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éé.Security is only configured at cluster creation time and it is not possible to enable security after the cluster is created. La mise à jour du fichier de configuration active la sécurité par certificat ou la sécurité Windows.Update the config file enable certificate security or Windows security. Lisez Sécuriser un cluster pour en savoir plus sur la sécurité du cluster Service Fabric.Read Secure a cluster to learn more about Service Fabric cluster security.

Étape 1 : Création du clusterStep 1: Create the cluster

Scénario A : Créer un cluster de développement local non sécuriséScenario A: Create an unsecured local development cluster

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.Service Fabric can be deployed to a one-machine development cluster by using the ClusterConfig.Unsecure.DevCluster.json file included in Samples.

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.Unpack the standalone package to your machine, copy the sample config file to the local machine, then run the CreateServiceFabricCluster.ps1 script through an administrator PowerShell session, from the standalone package folder.

.\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.See the Environment Setup section at Plan and prepare your cluster deployment for troubleshooting details.

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 ».If you're finished running development scenarios, you can remove the Service Fabric cluster from the machine by referring to steps in section "Remove a cluster".

Scénario B : Créer un cluster de plusieurs ordinateursScenario B: Create a multi-machine cluster

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.After you have gone through the planning and preparation steps detailed at Plan and prepare your cluster deployment, you are ready to create your production cluster using your cluster configuration file.

L’administrateur de cluster déployant et configurant le cluster doit disposer de privilèges d’administrateur sur l’ordinateur.The cluster administrator deploying and configuring the cluster must have administrator privileges on the computer. Vous ne pouvez pas installer Service Fabric sur un contrôleur de domaine.You cannot install Service Fabric on a domain controller.

  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é.The TestConfiguration.ps1 script in the standalone package is used as a best practices analyzer to validate whether a cluster can be deployed on a given environment. La section Préparation du déploiement répertorie les conditions préalables et les exigences de l’environnement.Deployment preparation lists the pre-requisites and environment requirements. Exécutez le script pour vérifier si vous pouvez créer le cluster de développement :Run the script to verify if you can create the development cluster:

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

    Le résultat ressemble à ce qui suit.You should see output similar to the following. 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.If the bottom field "Passed" is returned as "True", sanity checks have passed and the cluster looks to be deployable based on the input configuration.

    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éer le cluster : exécutez le script CreateServiceFabricCluster.ps1 pour déployer le cluster Service Fabric sur chaque ordinateur dans la configuration.Create the cluster: Run the CreateServiceFabricCluster.ps1 script to deploy the Service Fabric cluster across each machine in the 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.Deployment traces are written to the VM/machine on which you ran the CreateServiceFabricCluster.ps1 PowerShell script. Elles ne se trouvent pas dans le sous-dossier DeploymentTraces, situé dans le répertoire à partir duquel le script a été exécuté.These can be found in the subfolder DeploymentTraces, based in the directory from which the script was run. 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).To see if Service Fabric was deployed correctly to a machine, find the installed files in the FabricDataRoot directory, as detailed in the cluster configuration file FabricSettings section (by default 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.As well, FabricHost.exe and Fabric.exe processes can be seen running in Task Manager.

Scénario C : Créer un cluster hors connexion (déconnecté d’Internet)Scenario C: Create an offline (internet-disconnected) cluster

Le package de runtime Service Fabric est automatiquement téléchargé lors de la création du cluster.The Service Fabric runtime package is automatically downloaded at cluster creation. 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.When deploying a cluster to machines not connected to the internet, you will need to download the Service Fabric runtime package separately, and provide the path to it at cluster creation. 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.The runtime package can be downloaded separately, from another machine connected to the internet, at Download Link - Service Fabric Runtime - 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 :Copy the runtime package to where you are deploying the offline cluster from, and create the cluster by running CreateServiceFabricCluster.ps1 with the -FabricRuntimePackagePath parameter included, as shown in this example:

.\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..\ClusterConfig.json and .\MicrosoftAzureServiceFabric.cab are the paths to the cluster configuration and the runtime .cab file respectively.

Étape 2 : Connexion au clusterStep 2: Connect to the cluster

Connectez-vous au cluster pour vérifier que le cluster est en cours d’exécution et disponible.Connect to the cluster to verify the cluster is running and available. Le module Service Fabric PowerShell est installé avec le runtime.The ServiceFabric PowerShell module is installed with the 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.You can connect to the cluster from one of the cluster nodes or from a remote computer with the Service Fabric runtime. L’applet de commande Connect-ServiceFabricCluster établit une connexion au cluster.The Connect-ServiceFabricCluster cmdlet establishes a connection to the cluster.

Exécutez la commande PowerShell suivante pour vous connecter à un cluster non sécurisé :To connect to an unsecure cluster, run the following PowerShell command:

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

Par exemple :For example:

Connect-ServiceFabricCluster -ConnectionEndpoint 192.13.123.2345:19000

Pour obtenir des exemples de connexion à un cluster, consultez Se connecter à un cluster sécurisé .See Connect to a secure cluster for other examples of connecting to a cluster. 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.After connecting to the cluster, use the Get-ServiceFabricNode cmdlet to display a list of nodes in the cluster and status information for each node. HealthState doit être à l’état OK pour chaque nœud.HealthState should be OK for each node.

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 ExplorerStep 3: Visualize the cluster using Service Fabric explorer

Service Fabric Explorer est un bon outil pour visualiser votre cluster et gérer les applications.Service Fabric Explorer is a good tool for visualizing your cluster and managing 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.Service Fabric Explorer is a service that runs in the cluster, which you access using a browser by navigating to 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.The cluster dashboard provides an overview of your cluster, including a summary of application and node health. L’affichage des nœuds montre la disposition physique du cluster.The node view shows the physical layout of the cluster. Vous pouvez identifier les applications ayant déployé du code sur un nœud donné.For a given node, you can inspect which applications have code deployed on that node.

Service Fabric Explorer

Ajouter et supprimer des nœudsAdd and remove nodes

Vous pouvez ajouter des nœuds à votre cluster Service Fabric autonome ou en supprimer en fonction de l’évolution de vos besoins.You can add or remove nodes to your standalone Service Fabric cluster as your business needs change. Consultez l’article Ajouter ou supprimer des nœuds à/d’un cluster Service Fabric autonome pour obtenir des instructions détaillées.See Add or Remove nodes to a Service Fabric standalone cluster for detailed steps.

Supprimer un clusterRemove a 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.To remove a cluster, run the RemoveServiceFabricCluster.ps1 PowerShell script from the package folder and pass in the path to the JSON configuration file. Vous pouvez éventuellement spécifier un emplacement pour le journal de la suppression.You can optionally specify a location for the log of the deletion.

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.This script can be run on any machine that has administrator access to all the machines that are listed as nodes in the cluster configuration file. L’ordinateur sur lequel ce script est exécuté ne doit pas nécessairement faire partie du cluster.The machine that this script is run on does not have to be part of the 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ésabonnerTelemetry data collected and how to opt out of it

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.As a default, the product collects telemetry on the Service Fabric usage to improve the product. L’outil Best Practice Analyzer qui s’exécute dans le cadre de l’installation contrôle la connectivité à https://vortex.data.microsoft.com/collect/v1.The Best Practice Analyzer that runs as a part of the setup checks for connectivity to https://vortex.data.microsoft.com/collect/v1. Si le service n’est pas joignable, la configuration échoue, sauf si vous vous désabonnez de la télémétrie.If it is not reachable, the setup fails unless you opt out of telemetry.

  1. Le pipeline de télémétrie tente de charger les données suivantes vers https://vortex.data.microsoft.com/collect/v1 une fois par jour.The telemetry pipeline tries to upload the following data to https://vortex.data.microsoft.com/collect/v1 once every day. Ce meilleur téléchargement n’a aucun impact sur la fonctionnalité de cluster.It is a best-effort upload and has no impact on the cluster functionality. Les données de télémétrie sont envoyées uniquement à partir du nœud qui exécute le service Failover Manager principal.The telemetry is only sent from the node that runs the failover manager primary. Aucun autre nœud n’envoie des données de télémétrie.No other nodes send out telemetry.
  2. La télémétrie se compose des éléments suivants :The telemetry consists of the following:
  • Nombre de servicesNumber of services
  • Nombre de ServiceTypesNumber of ServiceTypes
  • Nombre de ApplicationsNumber of Applications
  • Nombre de ApplicationUpgradesNumber of ApplicationUpgrades
  • Nombre de FailoverUnitsNumber of FailoverUnits
  • Nombre de InBuildFailoverUnitsNumber of InBuildFailoverUnits
  • Nombre de UnhealthyFailoverUnitsNumber of UnhealthyFailoverUnits
  • Nombre de ReplicasNumber of Replicas
  • Nombre de InBuildReplicasNumber of InBuildReplicas
  • Nombre de StandByReplicasNumber of StandByReplicas
  • Nombre de OfflineReplicasNumber of OfflineReplicas
  • CommonQueueLengthCommonQueueLength
  • QueryQueueLengthQueryQueueLength
  • FailoverUnitQueueLengthFailoverUnitQueueLength
  • CommitQueueLengthCommitQueueLength
  • Nombre de nœudsNumber of Nodes
  • IsContextComplete : True/FalseIsContextComplete: True/False
  • ClusterId : GUID généré de manière aléatoire pour chaque clusterClusterId: This is a GUID randomly generated for each cluster
  • ServiceFabricVersionServiceFabricVersion
  • 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éesIP address of the virtual machine or machine from which the telemetry is uploaded

Pour désactiver les données de télémétrie, ajoutez ce qui suit à properties dans votre configuration de cluster : enableTelemetry: false.To disable telemetry, add the following to properties in your cluster config: enableTelemetry: false.

Fonctionnalités préliminaires incluses dans ce packagePreview features included in this package

Aucune.None.

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.Starting with the new GA version of the standalone cluster for Windows Server (version 5.3.204.x), you can upgrade your cluster to future releases, manually or automatically. Reportez-vous au document Mettre à niveau une version autonome du cluster Service Fabric pour plus d’informations.Refer to Upgrade a standalone Service Fabric cluster version document for details.

Étapes suivantesNext steps