Criar um cluster autônomo em execução no Windows ServerCreate a standalone cluster running on Windows Server

Você pode usar o Azure Service Fabric para criar clusters do Service Fabric em qualquer máquina virtual ou computador que estiver executando o Windows Server.You can use Azure Service Fabric to create Service Fabric clusters on any virtual machines or computers running Windows Server. Isso significa que você pode implantar e executar os aplicativos do Service Fabric em qualquer ambiente que tenha um conjunto de computadores com o Windows Server interconectados, seja localmente ou em qualquer provedor de nuvem.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. O Service Fabric fornece um pacote de instalação para criar os clusters do Service Fabric denominado pacote do Windows Server autônomo.Service Fabric provides a setup package to create Service Fabric clusters called the standalone Windows Server package. Os clusters tradicionais do Service Fabric no Azure estão disponíveis como um serviço gerenciado, enquanto os clusters autônomos do Service Fabric são de autoatendimento.Traditional Service Fabric clusters on Azure are available as a managed service, while standalone Service Fabric clusters are self-service. Para obter mais informações, consulte Comparando clusters do Service Fabric autônomos e do Azure.For more on the differences, see Comparing Azure and standalone Service Fabric clusters.

Este artigo guia você pelas etapas para criação de um cluster do Service Fabric.This article walks you through the steps for creating a Service Fabric standalone cluster.

Observação

Este pacote autônomo do Windows Server está disponível para venda e pode ser usado gratuitamente para implantações de produção.This standalone Windows Server package is commercially available at no cost and may be used for production deployments. Este pacote pode conter novos recursos do Service Fabric que estão em “Visualização”.This package may contain new Service Fabric features that are in "Preview". Role para baixo até “Recursos de visualização incluídos neste pacote”.Scroll down to "Preview features included in this package." para obter uma lista dos recursos da visualização.section for the list of the preview features. Você pode baixar uma cópia do EULA agora.You can download a copy of the EULA now.

Obter suporte para o pacote do Service Fabric para Windows ServerGet support for the Service Fabric for Windows Server package

Baixar o pacote do Service Fabric para Windows ServerDownload the Service Fabric for Windows Server package

Para criar o cluster, use o pacote do Service Fabric para Windows Server (Windows Server 2012 R2 e mais recente) encontrado aqui:To create the cluster, use the Service Fabric for Windows Server package (Windows Server 2012 R2 and newer) found here:
Link de Download – pacote autônomo do Service Fabric – Windows ServerDownload Link - Service Fabric Standalone Package - Windows Server

Encontre detalhes sobre o conteúdo do pacote aqui.Find details on contents of the package here.

O pacote de runtime do Service Fabric é baixado automaticamente no momento da criação do cluster.The Service Fabric runtime package is automatically downloaded at time of cluster creation. Se for implantar de um computador não conectado à Internet, baixe o pacote de runtime fora de banda aqui:If deploying from a machine not connected to the internet, please download the runtime package out of band from here:
Link de Download – Runtime do Service Fabric – Windows ServerDownload Link - Service Fabric Runtime - Windows Server

Encontre amostras de configuração de cluster autônomo em:Find Standalone Cluster Configuration samples at:
Amostras de configuração de cluster autônomoStandalone Cluster Configuration Samples

Criar o clusterCreate the cluster

Vários arquivos de configuração de cluster de exemplo são instalados com o pacote de instalação.Several sample cluster configuration files are installed with the setup package. ClusterConfig.Unsecure.DevCluster.json é a configuração de cluster mais simples: um cluster não seguro de três nós em execução em um único computador.ClusterConfig.Unsecure.DevCluster.json is the simplest cluster configuration: an unsecure, three-node cluster running on a single computer. Outros arquivos de configuração descrevem clusters únicos ou vários computadores protegidos com certificados x. 509 ou com a segurança do Windows.Other config files describe single or multi-machine clusters secured with X.509 certificates or Windows security. Você não precisa modificar nenhuma definição de configuração padrão para este tutorial, mas examine o arquivo config e familiarizar-se com as configurações.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. A seção Nós descreve os três nós no cluster: nome, endereço IP, tipo de nó, domínio de falha e domínio de atualização.The nodes section describes the three nodes in the cluster: name, IP address, node type, fault domain, and upgrade domain. A seção Propriedades define a segurança, nível de confiabilidade, coleta de diagnóstico e tipos de nós para o cluster.The properties section defines the security, reliability level, diagnostics collection, and types of nodes for the cluster.

O cluster criado neste artigo não é seguro.The cluster created in this article is unsecure. Qualquer pessoa pode conectar-se anonimamente e realizar operações de gerenciamento, portanto, os clusters de produção sempre devem ser protegidos usando os certificados x.509 ou a segurança do Windows.Anyone can connect anonymously and perform management operations, so production clusters should always be secured using X.509 certificates or Windows security. A segurança só é configurada no momento de criação do cluster e não é possível habilitar a segurança após a criação dele.Security is only configured at cluster creation time and it is not possible to enable security after the cluster is created. Atualize o arquivo de configuração para habilitar a segurança de certificado ou a segurança do Windows.Update the config file enable certificate security or Windows security. Leia Proteger um cluster para saber mais sobre a segurança do cluster do Service Fabric.Read Secure a cluster to learn more about Service Fabric cluster security.

Etapa 1: Criar o clusterStep 1: Create the cluster

Cenário A: Criar um cluster de desenvolvimento local desprotegidoScenario A: Create an unsecured local development cluster

O Service Fabric pode ser implantado em um cluster de desenvolvimento de um computador usando o arquivo ClusterConfig.Unsecure.DevCluster.json incluído em Amostras.Service Fabric can be deployed to a one-machine development cluster by using the ClusterConfig.Unsecure.DevCluster.json file included in Samples.

Descompacte o pacote autônomo no seu computador, copie o arquivo de configuração de exemplo para o computador local, execute o script CreateServiceFabricCluster.ps1 por meio de uma sessão do PowerShell do administrador, da pasta de pacote autônomo.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

Consulte a seção Configuração do ambiente em Planejar e preparar a implantação do cluster para obter detalhes de solução de problemas.See the Environment Setup section at Plan and prepare your cluster deployment for troubleshooting details.

Se você concluiu a execução de cenários de desenvolvimento, poderá remover o cluster do Service Fabric do computador consultando as etapas na seção “Remover um 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".

Cenário B: Criar um cluster com vários computadoresScenario B: Create a multi-machine cluster

Depois que tiver verificado o planejamento e etapas de preparação detalhadas em Planejar e preparar a implantação do cluster, você estará pronto para criar seu cluster de produção usando o arquivo de configuração do 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.

O administrador do cluster que implanta e configura o cluster deve ter privilégios de administrador no computador.The cluster administrator deploying and configuring the cluster must have administrator privileges on the computer. Você não pode instalar o Service Fabric em um controlador de domínio.You cannot install Service Fabric on a domain controller.

  1. O script TestConfiguration.ps1 no pacote autônomo é usado como um analisador de práticas recomendadas para validar se um cluster pode ser implantado em um ambiente específico.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. A preparação para implantação lista os pré-requisitos e requisitos do ambiente.Deployment preparation lists the pre-requisites and environment requirements. Execute o script para verificar se você pode criar o cluster de desenvolvimento:Run the script to verify if you can create the development cluster:

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

    Você deve ver saídas semelhantes às seguintes.You should see output similar to the following. Se o campo inferior "Passed" é retornado como "True", as verificações de integridade são aprovadas e o cluster parece estar pronto para implantação com base na configuração de entrada.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. Crie o cluster: Execute o script CreateServiceFabricCluster.ps1 para implantar o cluster do Service Fabric em cada computador na configuração.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
    

Observação

Rastreamentos de implantação são gravados na VM/computador em que você executou o script do PowerShell CreateServiceFabricCluster.ps1.Deployment traces are written to the VM/machine on which you ran the CreateServiceFabricCluster.ps1 PowerShell script. Eles podem ser encontrados na subpasta DeploymentTraces, com base no diretório do qual o script foi executado.These can be found in the subfolder DeploymentTraces, based in the directory from which the script was run. Para ver se o Service Fabric foi implantado corretamente em um computador, localize os arquivos instalados no diretório FabricDataRoot, conforme detalhado na seção FabricSettings do arquivo de configuração de cluster (por padrão, 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). Além disso, processos FabricHost.exe e Fabric.exe podem ser vistos em execução no Gerenciador de Tarefas.As well, FabricHost.exe and Fabric.exe processes can be seen running in Task Manager.

Cenário C: Criar um cluster offline (desconectado da Internet)Scenario C: Create an offline (internet-disconnected) cluster

O pacote de runtime do Service Fabric é baixado automaticamente durante a criação do cluster.The Service Fabric runtime package is automatically downloaded at cluster creation. Ao implantar um cluster em computadores que não estão conectados à Internet, você precisará baixar o pacote de runtime do Service Fabric separadamente e fornecer o caminho para ele durante a criação do 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. O pacote de runtime pode ser baixado separadamente, em outro computador conectado à Internet, em Link de Download – Runtime do 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. Copie o pacote de runtime para o local de origem da implantação do cluster offline e crie o cluster executando CreateServiceFabricCluster.ps1 com o parâmetro -FabricRuntimePackagePath incluído, conforme mostrado neste exemplo: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 e .\MicrosoftAzureServiceFabric.cab são os caminhos para a configuração do cluster e o arquivo .cab de runtime, respectivamente..\ClusterConfig.json and .\MicrosoftAzureServiceFabric.cab are the paths to the cluster configuration and the runtime .cab file respectively.

Etapa 2: Conectar-se ao clusterStep 2: Connect to the cluster

Conecte-se ao cluster para verificar se o cluster está em execução e disponível.Connect to the cluster to verify the cluster is running and available. O módulo ServiceFabric do PowerShell é instalado no runtime.The ServiceFabric PowerShell module is installed with the runtime. Você pode se conectar ao cluster de um dos nós do cluster ou de um computador remoto com o runtime do Service Fabric.You can connect to the cluster from one of the cluster nodes or from a remote computer with the Service Fabric runtime. O cmdlet Connect-ServiceFabricCluster estabelece uma conexão com o cluster.The Connect-ServiceFabricCluster cmdlet establishes a connection to the cluster.

Para se conectar a um cluster não seguro, execute o seguinte comando do PowerShell:To connect to an unsecure cluster, run the following PowerShell command:

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

Por exemplo:For example:

Connect-ServiceFabricCluster -ConnectionEndpoint 192.13.123.234:19000

Confira Conectar-se a um cluster seguro para obter outros exemplos de como se conectar a um cluster.See Connect to a secure cluster for other examples of connecting to a cluster. Depois de se conectar ao cluster, use o script Get-ServiceFabricNode para exibir uma lista de nós de cluster e informações de status para cada nó.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 deve ser OK para cada nó.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

Etapa 3: Visualizar o cluster usando o Service Fabric ExplorerStep 3: Visualize the cluster using Service Fabric explorer

O Service Fabric Explorer é uma boa ferramenta para visualizar o cluster e gerenciar os aplicativos.Service Fabric Explorer is a good tool for visualizing your cluster and managing applications. O Service Fabric Explorer é um serviço executado no cluster, que você acessa usando um navegador, acessando 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.

O painel do cluster fornece uma visão geral do cluster, incluindo um resumo do aplicativo e a integridade do nó.The cluster dashboard provides an overview of your cluster, including a summary of application and node health. A exibição de nós mostra o layout físico do cluster.The node view shows the physical layout of the cluster. Para um nó específico, você pode inspecionar quais aplicativos têm código implantado naquele nó.For a given node, you can inspect which applications have code deployed on that node.

Service Fabric Explorer

Adicionar e remover nósAdd and remove nodes

Você pode adicionar ou remover os nós do cluster do Service Fabric autônomo quando seu negócio precisa mudar.You can add or remove nodes to your standalone Service Fabric cluster as your business needs change. Confira Adicionar ou remover nós de um cluster do Service Fabric autônomo para ver as etapas detalhadas.See Add or Remove nodes to a Service Fabric standalone cluster for detailed steps.

Remover um clusterRemove a cluster

Para remover um cluster, execute o script do PowerShell RemoveServiceFabricCluster.ps1 da pasta do pacote e transmita o caminho para o arquivo de configuração 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. Como alternativa, você pode especificar um local para o log de exclusão.You can optionally specify a location for the log of the deletion.

Esse script pode ser executado em qualquer computador que tenha o acesso de administrador para todos os computadores listados como nós no arquivo de configuração do 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. O computador no qual este script é executado não precisa fazer parte do 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

Dados de telemetria coletados e como recusá-losTelemetry data collected and how to opt out of it

Por padrão, o produto coleta a telemetria sobre o uso do Service Fabric para aprimorar o produto.As a default, the product collects telemetry on the Service Fabric usage to improve the product. O Analisador de Melhores Práticas executado como parte da instalação verifica a conectividade para 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. Se ele não estiver acessível, a instalação falhará, a menos que você recuse a telemetria.If it is not reachable, the setup fails unless you opt out of telemetry.

  1. O pipeline de telemetria tenta carregar os dados a seguir para https://vortex.data.microsoft.com/collect/v1 uma vez por dia.The telemetry pipeline tries to upload the following data to https://vortex.data.microsoft.com/collect/v1 once every day. É um upload de melhor esforço e não causa nenhum impacto sobre a funcionalidade do cluster.It is a best-effort upload and has no impact on the cluster functionality. A telemetria é enviada somente do nó que executa o gerenciador de failover primário.The telemetry is only sent from the node that runs the failover manager primary. Nenhum outro nó envia telemetria.No other nodes send out telemetry.
  2. A Telemetria consiste no seguinte:The telemetry consists of the following:
  • Número de serviçosNumber of services
  • Número de ServiceTypesNumber of ServiceTypes
  • Número de AplicativosNumber of Applications
  • Número de ApplicationUpgradesNumber of ApplicationUpgrades
  • Número de FailoverUnitsNumber of FailoverUnits
  • Número de InBuildFailoverUnitsNumber of InBuildFailoverUnits
  • Número de UnhealthyFailoverUnitsNumber of UnhealthyFailoverUnits
  • Número de RéplicasNumber of Replicas
  • Número de InBuildReplicasNumber of InBuildReplicas
  • Número de StandByReplicasNumber of StandByReplicas
  • Número de OfflineReplicasNumber of OfflineReplicas
  • CommonQueueLengthCommonQueueLength
  • QueryQueueLengthQueryQueueLength
  • FailoverUnitQueueLengthFailoverUnitQueueLength
  • CommitQueueLengthCommitQueueLength
  • Número de NósNumber of Nodes
  • IsContextComplete: Verdadeiro/FalsoIsContextComplete: True/False
  • ClusterId: Esse é um GUID gerado aleatoriamente para cada clusterClusterId: This is a GUID randomly generated for each cluster
  • ServiceFabricVersionServiceFabricVersion
  • Endereço IP da máquina virtual ou computador por meio do qual a telemetria é carregadaIP address of the virtual machine or machine from which the telemetry is uploaded

Para desabilitar a telemetria, adicione o seguinte ao elemento propriedades em sua configuração de cluster: enableTelemetry: false.To disable telemetry, add the following to properties in your cluster config: enableTelemetry: false.

Recursos de preview incluídos neste pacotePreview features included in this package

Nenhum.None.

Observação

A partir da nova versão GA do cluster autônomo para Windows Server (versão 5.3.204.x), você pode atualizar seu cluster para versões futuras, de modo manual ou automático.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. Consulte o documento Atualizar uma versão autônoma do cluster do Service Fabric para ver mais detalhes.Refer to Upgrade a standalone Service Fabric cluster version document for details.

Próximas etapasNext steps