Создание изолированного кластера под управлением Windows ServerCreate a standalone cluster running on Windows Server

Azure Service Fabric позволяет создавать кластеры Service Fabric на любых виртуальных машинах или компьютерах под управлением Windows Server.You can use Azure Service Fabric to create Service Fabric clusters on any virtual machines or computers running Windows Server. Это означает, что вы сможете разворачивать и запускать приложения Service Fabric в любой среде с набором подключенных друг к другу компьютеров с Windows Server как в локальной среде, так и у любого поставщика облачных служб.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 предоставляет установочный пакет для создания кластеров Service Fabric, который называется изолированным пакетом Windows Server.Service Fabric provides a setup package to create Service Fabric clusters called the standalone Windows Server package. Традиционные кластеры Service Fabric в Azure доступны в виде управляемой службы, а изолированные являются самостоятельными.Traditional Service Fabric clusters on Azure are available as a managed service, while standalone Service Fabric clusters are self-service. Дополнительные сведения об их различиях см. статье Сравнение традиционных и изолированных кластеров Service Fabric в Azure под управлением Windows Server и Linux.For more on the differences, see Comparing Azure and standalone Service Fabric clusters.

В этой статье описывается процесс создания изолированного кластера Service Fabric.This article walks you through the steps for creating a Service Fabric standalone cluster.

Примечание

Этот изолированный пакет Windows Server сейчас доступен бесплатно и может использоваться для рабочих развертываний.This standalone Windows Server package is commercially available at no cost and may be used for production deployments. Этот пакет может содержать новые функции Service Fabric, которые находятся на этапе предварительной версии.This package may contain new Service Fabric features that are in "Preview". Прокрутите список вниз до пункта Возможности на этапе предварительной версии в этом пакете.Scroll down to "Preview features included in this package." в разделе "Возможности на этапе предварительной версии в этом пакете".section for the list of the preview features. Вы можете загрузить копию лицензионного соглашения.You can download a copy of the EULA now.

Получение поддержки для Service Fabric для пакета Windows ServerGet support for the Service Fabric for Windows Server package

Скачивание Service Fabric для пакета Windows ServerDownload the Service Fabric for Windows Server package

Чтобы создать кластер, используйте Service Fabric для пакета Windows Server (2012 R2 и более поздней версии), доступный здесь:To create the cluster, use the Service Fabric for Windows Server package (Windows Server 2012 R2 and newer) found here:
Ссылка для скачивания изолированного пакета Service Fabric для Windows ServerDownload Link - Service Fabric Standalone Package - Windows Server

Подробные сведения о содержимом пакета можно получить здесь.Find details on contents of the package here.

Пакет среды выполнения Service Fabric автоматически скачивается во время создания кластера.The Service Fabric runtime package is automatically downloaded at time of cluster creation. В случае развертывания с компьютера, не подключенного к Интернету, скачайте внешний пакет среды выполнения отсюда:If deploying from a machine not connected to the internet, please download the runtime package out of band from here:
Ссылка для скачивания среды выполнения Service Fabric для Windows ServerDownload Link - Service Fabric Runtime - Windows Server

Примеры конфигурации изолированного кластера доступны здесь:Find Standalone Cluster Configuration samples at:
Примеры конфигурации изолированного кластераStandalone Cluster Configuration Samples

Создайте кластер.Create the cluster

Некоторые примеры файлов конфигурации кластера устанавливаются с помощью пакета установки.Several sample cluster configuration files are installed with the setup package. ClusterConfig.Unsecure.DevCluster.json — это самая простая конфигурация кластера: незащищенный кластер из трех узлов, работающий на одном компьютере.ClusterConfig.Unsecure.DevCluster.json is the simplest cluster configuration: an unsecure, three-node cluster running on a single computer. Другие файлы конфигурации описывают кластеры с одним или несколькими компьютерами, защищенными с помощью системы безопасности Windows или сертификатов X.509.Other config files describe single or multi-machine clusters secured with X.509 certificates or Windows security. Для работы с этим руководством не нужно изменять параметры конфигурации по умолчанию. Просто просмотрите файл конфигурации и ознакомьтесь с параметрами.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. В разделе Узлы описываются три узла в кластере: имя, IP-адрес, а также тип узла, домен сбоя и обновления.The nodes section describes the three nodes in the cluster: name, IP address, node type, fault domain, and upgrade domain. В разделе Свойства определяются безопасность, уровень надежности, сбор диагностических сведений и типы узлов для кластера.The properties section defines the security, reliability level, diagnostics collection, and types of nodes for the cluster.

Кластер, созданный в этой статье, не защищен.The cluster created in this article is unsecure. Любой пользователь может анонимно подключиться и выполнять операции управления, поэтому рабочие кластеры нужно обязательно защищать с помощью сертификатов X.509 или средств обеспечения безопасности Windows.Anyone can connect anonymously and perform management operations, so production clusters should always be secured using X.509 certificates or Windows security. Безопасность настраивается только во время создания кластера. После этого ее невозможно включить.Security is only configured at cluster creation time and it is not possible to enable security after the cluster is created. Обновите файл конфигурации, включив в нем безопасность сертификата или безопасность Windows.Update the config file enable certificate security or Windows security. См. дополнительные сведения о безопасности кластера Service Fabric в статье о защите кластеров.Read Secure a cluster to learn more about Service Fabric cluster security.

Шаг 1. Создайте кластер.Step 1: Create the cluster

Сценарий А. Создание незащищенного локального кластера разработкиScenario A: Create an unsecured local development cluster

Service Fabric можно развернуть на кластере с одним компьютером разработки с помощью файла ClusterConfig.Unsecure.DevCluster.json из примеров.Service Fabric can be deployed to a one-machine development cluster by using the ClusterConfig.Unsecure.DevCluster.json file included in Samples.

Распакуйте изолированный пакет на свой компьютер, скопируйте пример файла конфигурации на локальный компьютер, а затем в папке изолированного пакета запустите сценарий CreateServiceFabricCluster.ps1 в сеансе PowerShell с правами администратора.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

Дополнительные сведения об устранении неполадок указаны в подразделе "Настройка среды" статьи Планирование и подготовка развертывания изолированного кластера Service Fabric.See the Environment Setup section at Plan and prepare your cluster deployment for troubleshooting details.

После завершения выполнения сценариев разработки кластер Service Fabric можно будет удалить с компьютера с помощью действий, описанных в разделе Удаление кластера.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".

Сценарий Б. Создание кластера с несколькими компьютерамиScenario B: Create a multi-machine 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.

У администратора кластера, который развертывает и настраивает кластер, должны быть привилегии администратора на компьютере.The cluster administrator deploying and configuring the cluster must have administrator privileges on the computer. Пакет Service Fabric нельзя установить на контроллере домена.You cannot install Service Fabric on a domain controller.

  1. Скрипт TestConfiguration.ps1 в изолированном пакете используется как рекомендуемый анализатор, проверяющий возможность развертывания кластера в конкретной среде.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. Здесь перечислены предварительные требования к среде при подготовке к развертыванию.Deployment preparation lists the pre-requisites and environment requirements. Выполните сценарий чтобы проверить, можно ли создать кластер разработки:Run the script to verify if you can create the development cluster:

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

    Вы должны увидеть результат, аналогичный приведенному ниже.You should see output similar to the following. Если для нижнего поля "Passed" (Выполнено) возвращено значение True, значит, проверка работоспособности пройдена и кластер готов к развертыванию на основе входной конфигурации.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. Создайте кластер: запустите сценарий CreateServiceFabricCluster.ps1 для развертывания кластера Service Fabric на каждом компьютере в конфигурации.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
    

Примечание

Трассировки развертывания записываются на компьютер или виртуальную машину, на которой запущен сценарий PowerShell CreateServiceFabricCluster.ps1.Deployment traces are written to the VM/machine on which you ran the CreateServiceFabricCluster.ps1 PowerShell script. Их можно найти во вложенной папке DeploymentTraces в каталоге, в котором был запущен сценарий.These can be found in the subfolder DeploymentTraces, based in the directory from which the script was run. Чтобы узнать, правильно ли развернут кластер Service Fabric на компьютере, найдите установленные файлы в каталоге FabricDataRoot, как описано в разделе FabricSettings файла конфигурации кластера (по умолчанию он находится в 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). Кроме того, процессы FabricHost.exe и Fabric.exe должны отображаться в диспетчере задач.As well, FabricHost.exe and Fabric.exe processes can be seen running in Task Manager.

Сценарий В. Создание кластера в автономном состоянии (не подключенного к Интернету)Scenario C: Create an offline (internet-disconnected) cluster

Пакет среды выполнения Service Fabric автоматически скачивается во время создания кластера.The Service Fabric runtime package is automatically downloaded at cluster creation. При развертывании кластера на компьютерах, не подключенных к Интернету, необходимо скачать пакет среды выполнения Service Fabric отдельно и указать путь к нему во время создания кластера.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. Пакет среды выполнения можно скачать отдельно, с другого компьютера, подключенного к Интернету, по ссылке для скачивания среды выполнения 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. Скопируйте пакет среды выполнения туда, откуда вы развертываете не подключенный к Интернету кластер, и создайте кластер, выполнив CreateServiceFabricCluster.ps1 с включенным параметром -FabricRuntimePackagePath, как показано ниже: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 и .\MicrosoftAzureServiceFabric.cab — это пути к файлу конфигурации кластера и CAB-файлу среды выполнения соответственно..\ClusterConfig.json and .\MicrosoftAzureServiceFabric.cab are the paths to the cluster configuration and the runtime .cab file respectively.

Шаг 2. Подключение к кластеруStep 2: Connect to the cluster

Подключитесь к кластеру, чтобы убедиться, что кластер запущен и доступен.Connect to the cluster to verify the cluster is running and available. Модуль PowerShell ServiceFabric устанавливается вместе со средой выполнения.The ServiceFabric PowerShell module is installed with the 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. Подключитесь к кластеру, используя командлет Connect-ServiceFabricCluster.The Connect-ServiceFabricCluster cmdlet establishes a connection to the cluster.

Для подключения к незащищенному кластеру выполните следующую команду PowerShell.To connect to an unsecure cluster, run the following PowerShell command:

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

Пример:For example:

Connect-ServiceFabricCluster -ConnectionEndpoint 192.13.123.234:19000

Примеры других способов подключения к кластеру см. в статье о безопасном подключении к кластеру.See Connect to a secure cluster for other examples of connecting to a cluster. После подключения к кластеру используйте командлет Get-ServiceFabricNode, чтобы отобразить список узлов в кластере и сведения о состоянии каждого узла.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 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

Шаг 3. Визуализация кластера с помощью Service Fabric ExplorerStep 3: Visualize the cluster using Service Fabric explorer

Service Fabric Explorer — хорошее средство для визуализации кластера и управления приложениями.Service Fabric Explorer is a good tool for visualizing your cluster and managing applications. Service Fabric Explorer — это служба, которая выполняется в кластере. Чтобы получить к ней доступ, перейдите в браузере по адресу 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.

На панели мониторинга кластера представлены общие сведения о кластере, включая общие сведения о приложении и работоспособности узла кластера.The cluster dashboard provides an overview of your cluster, including a summary of application and node health. В представлении "Узлы" отображается физическая структура кластера.The node view shows the physical layout of the cluster. Для каждого узла можно просмотреть, какие приложения были развернуты на этом узлеFor a given node, you can inspect which applications have code deployed on that node.

Service Fabric Explorer

Добавление и удаление узловAdd and remove nodes

Вы можете добавить узлы в изолированный кластер Service Fabric или удалить их из него в соответствии с изменениями потребностей компании.You can add or remove nodes to your standalone Service Fabric cluster as your business needs change. Подробные инструкции статье Добавление узлов в автономный кластер Service Fabric или удаление узлов из него .See Add or Remove nodes to a Service Fabric standalone cluster for detailed steps.

Удаление кластераRemove a cluster

Чтобы удалить кластер, запустите сценарий Powershell RemoveServiceFabricCluster.ps1 из папки пакета и передайте в него путь к файлу конфигурации 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. При необходимости можно указать расположение журнала удаления.You can optionally specify a location for the log of the deletion.

Этот сценарий может выполняться на любом компьютере, у которого есть доступ администратора ко всем компьютерам, перечисленным в качестве узлов в файле конфигурации кластера.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. Компьютер, на котором выполняется этот сценарий, может и не входить в кластер.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

Собираемые данные телеметрии и отказ от нихTelemetry data collected and how to opt out of it

По умолчанию продукт собирает данные телеметрии по использованию Service Fabric для последующего усовершенствования продукта.As a default, the product collects telemetry on the Service Fabric usage to improve the product. Анализатор соответствия рекомендациям, который запускается в рамках установки, проверяет возможность подключения к 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. Если это расположение недоступно, установку выполнить не удастся, если только вы не отказались от сбора данных телеметрии.If it is not reachable, the setup fails unless you opt out of telemetry.

  1. Конвейер телеметрии ежедневно выполняет попытку отправить указанные ниже данные по адресу https://vortex.data.microsoft.com/collect/v1.The telemetry pipeline tries to upload the following data to https://vortex.data.microsoft.com/collect/v1 once every day. Эта отправка является необходимой и не влияет на функциональные возможности кластера.It is a best-effort upload and has no impact on the cluster functionality. Данные телеметрии отправляется только с узла, на котором первоначально выполняется диспетчер отработки отказа.The telemetry is only sent from the node that runs the failover manager primary. С других узлов данные телеметрии не отправляются.No other nodes send out telemetry.
  2. Данные телеметрии включают:The telemetry consists of the following:
  • количество служб;Number of services
  • количество типов служб;Number of ServiceTypes
  • количество приложений;Number of Applications
  • количество обновлений приложений;Number of ApplicationUpgrades
  • количество единиц с отработкой отказа;Number of FailoverUnits
  • количество единиц со встроенной отработкой отказа;Number of InBuildFailoverUnits
  • количество единиц с неработоспособной отработкой отказа;Number of UnhealthyFailoverUnits
  • количество реплик;Number of Replicas
  • количество встроенных реплик;Number of InBuildReplicas
  • количество реплик в режиме ожидания;Number of StandByReplicas
  • количество автономных реплик;Number of OfflineReplicas
  • длина общей очереди;CommonQueueLength
  • длина очереди запросов;QueryQueueLength
  • длина очереди единиц с отработкой отказа;FailoverUnitQueueLength
  • длина очереди фиксаций;CommitQueueLength
  • количество узлов;Number of Nodes
  • выполнен ли контекст: значение True или FalseIsContextComplete: True/False
  • идентификатор кластера — это глобальный уникальный идентификатор, который случайным образом формируется для каждого кластера;ClusterId: This is a GUID randomly generated for each cluster
  • версия Service Fabric;ServiceFabricVersion
  • IP-адрес виртуальной машины или компьютера, с которых отправляются данные телеметрии.IP address of the virtual machine or machine from which the telemetry is uploaded

Чтобы отключить сбор данных телеметрии, добавьте следующий фрагмент кода к элементу properties в конфигурации кластера: enableTelemetry: false.To disable telemetry, add the following to properties in your cluster config: enableTelemetry: false.

Возможности на этапе предварительной версии в этом пакетеPreview features included in this package

Нет.None.

Примечание

Начиная с новой Общедоступной версии автономного кластера для Windows Server (версия 5.3.204.x), обновление кластера до будущих версий осуществляется вручную или автоматически.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. Дополнительные сведения см. в документе Upgrade a standalone Service Fabric cluster version (Обновление версии изолированного кластера Service Fabric).Refer to Upgrade a standalone Service Fabric cluster version document for details.

Дальнейшие действияNext steps