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

Pode utilizar o Tecido de Serviço Azure para criar clusters de tecido de serviço em quaisquer máquinas virtuais ou computadores que executem o Windows Server.You can use Azure Service Fabric to create Service Fabric clusters on any virtual machines or computers running Windows Server. Isto significa que pode implementar e executar aplicações de Tecido de Serviço em qualquer ambiente que contenha um conjunto de computadores Windows Server interligados, seja nas instalações ou com qualquer fornecedor 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 configuração para criar clusters de tecido de serviço chamado pacote de Servidor Windows autónomo.Service Fabric provides a setup package to create Service Fabric clusters called the standalone Windows Server package. Os clusters tradicionais de tecido de serviço em Azure estão disponíveis como um serviço gerido, enquanto os clusters autónomos de tecido de serviço são self-service.Traditional Service Fabric clusters on Azure are available as a managed service, while standalone Service Fabric clusters are self-service. Para mais informações sobre as diferenças, consulte Comparar os clusters De Tecido solado azure e autónomos.For more on the differences, see Comparing Azure and standalone Service Fabric clusters.

Este artigo percorre-o através dos passos para criar um cluster autónomo de Tecido de Serviço.This article walks you through the steps for creating a Service Fabric standalone cluster.

Nota

Este pacote autónomo do Windows Server está disponível comercialmente sem custos e pode ser utilizado para implementaçõ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 novas funcionalidades de Tecido de Serviço que se encontram em "Pré-visualização".This package may contain new Service Fabric features that are in "Preview". Desloque-se para baixo para "Visualizar funcionalidades incluídas neste pacote."Scroll down to "Preview features included in this package." secção para a lista das funcionalidades de pré-visualização.section for the list of the preview features. Já pode descarregar uma cópia da EULA.You can download a copy of the EULA now.

Obtenha suporte para o tecido de serviço para o pacote Do Servidor windowsGet support for the Service Fabric for Windows Server package

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

Para criar o cluster, utilize o tecido de serviço para o pacote Windows Server (Windows Server 2012 R2 e mais recente) aqui encontrado:To create the cluster, use the Service Fabric for Windows Server package (Windows Server 2012 R2 and newer) found here:
Link de descarregamento - Pacote Autónomo de Tecido de Serviço - Servidor windowsDownload 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 tempo de funcionação do Tecido de Serviço é automaticamente descarregado no momento da criação do cluster.The Service Fabric runtime package is automatically downloaded at time of cluster creation. Se for implantado a partir de uma máquina não ligada à internet, por favor, descarregue o pacote de tempo de execução fora da banda a partir daqui:If deploying from a machine not connected to the internet, please download the runtime package out of band from here:
Link de descarregamento - Tempo de execução de tecido de serviço - Servidor windowsDownload Link - Service Fabric Runtime - Windows Server

Encontre amostras de configuração autónoma de cluster em:Find Standalone Cluster Configuration samples at:
Amostras de configuração autónoma de clusterStandalone Cluster Configuration Samples

Criar o clusterCreate the cluster

São instalados vários ficheiros de configuração de cluster de exemplo com o pacote de configuração.Several sample cluster configuration files are installed with the setup package. O ClusterConfig.Unsecure.DevCluster.json é a configuração de cluster mais simples: um cluster inseguro com três nós em execução num único computador.ClusterConfig.Unsecure.DevCluster.json is the simplest cluster configuration: an unsecure, three-node cluster running on a single computer. Outros ficheiros de configuração descrevem clusters únicos ou de várias máquinas protegidas com certificados X.509 ou de segurança do Windows.Other config files describe single or multi-machine clusters secured with X.509 certificates or Windows security. Não precisa de modificar qualquer uma das definições de configuração predefinida para este tutorial, mas examine o ficheiro de configuração e familiarize-se com as definiçõ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 secção nós descreve os três nós do cluster: nome, endereço IP, tipo de nó, domínio de falha e o 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 secção propriedades define a segurança, o nível de fiabilidade, a recolha de diagnóstico e os 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 é inseguro.The cluster created in this article is unsecure. Qualquer pessoa pode ligar de forma anónima e efetuar operações de gestão, para que os clusters de produção sejam sempre protegidos ao utilizar certificados X.509 ou 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ó está configurada no momento de criação do cluster e não é possível ativá-la depois de o cluster ser criado.Security is only configured at cluster creation time and it is not possible to enable security after the cluster is created. Atualize o ficheiro config para permitir a segurança do certificado ou a segurança do Windows.Update the config file enable certificate security or Windows security. Leia Secure a cluster (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.

Passo 1: Criar o clusterStep 1: Create the cluster

Cenário A: Criar um cluster de desenvolvimento local não seguroScenario A: Create an unsecured local development cluster

O tecido de serviço pode ser implantado num cluster de desenvolvimento de uma máquina utilizando o ficheiro 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.

Desembale o pacote autónomo para a sua máquina, copie o ficheiro de config da amostra para a máquina local e, em seguida, execute o script CreateServiceFabricCluster.ps1 através de uma sessão de administrador PowerShell, a partir da pasta de pacote autónoma.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 secção de Configuração do Ambiente no Plan e prepare a implementação do seu cluster para obter detalhes de resolução de problemas.See the Environment Setup section at Plan and prepare your cluster deployment for troubleshooting details.

Se terminar de executar cenários de desenvolvimento, pode remover o cluster de Tecido de Serviço da máquina, referindo-se aos passos na secção "Remova 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 multi-máquinaScenario B: Create a multi-machine cluster

Depois de ter passado pelos passos de planeamento e preparação detalhados no Plan e preparar a implementação do cluster,está pronto para criar o seu cluster de produção utilizando o ficheiro 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 irá implementar e configurar o cluster tem de ter privilégios de administrador no computador.The cluster administrator deploying and configuring the cluster must have administrator privileges on the computer. Não pode instalar o Service Fabric num controlador de domínio.You cannot install Service Fabric on a domain controller.

  1. O script TestConfiguration.ps1 no pacote autónomo é utilizado como um analisador de melhores práticas para validar se um cluster pode ser implementado num determinado ambiente.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 da implementação lista os pré-requisitos e os requisitos do ambiente.Deployment preparation lists the pre-requisites and environment requirements. Execute o script para verificar se pode criar o cluster de desenvolvimento:Run the script to verify if you can create the development cluster:

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

    Deverá ver um resultado semelhante ao seguinte.You should see output similar to the following. Se o campo inferior "Passado" for devolvido como "Verdadeiro", as verificações de sanidade passaram e o cluster parece ser implantável 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. Criar o cluster: Executar o script CreateServiceFabricCluster.ps1 para implantar o cluster De Serviço Tecido em cada máquina 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
    

Nota

Os rastreios de implementação são escritos na VM/máquina em que executou o script do PowerShell CreateServiceFabricCluster.ps1.Deployment traces are written to the VM/machine on which you ran the CreateServiceFabricCluster.ps1 PowerShell script. Pode encontrá-los 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 corretamente implementado numa máquina, encontre os ficheiros instalados no diretório FabricDataRoot, conforme detalhado na secção FabricSettings do ficheiro de configuração do cluster (por predefiniçã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). Desta forma, os processos FabricHost.exe e Fabric.exe podem ser vistos em execução no Gestor de Tarefas.As well, FabricHost.exe and Fabric.exe processes can be seen running in Task Manager.

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

O pacote de tempo de funcionação do Tecido de Serviço é automaticamente descarregado na criação do cluster.The Service Fabric runtime package is automatically downloaded at cluster creation. Ao implantar um cluster para máquinas não ligadas à internet, terá de descarregar separadamente o pacote de tempo de funcionamento do Tecido de Serviço e fornecer-lhe o caminho na criação de clusters.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 tempo de execução pode ser descarregado separadamente, a partir de outra máquina ligada à internet, no Download Link - Service Fabric Runtime - 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 tempo de funcionamento para onde está a implantar o cluster offline e crie o cluster correndo CreateServiceFabricCluster.ps1 com o -FabricRuntimePackagePath parâmetro incluído, como mostra este 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 ficheiro de tempo de execução .cab, respectivamente..\ClusterConfig.json and .\MicrosoftAzureServiceFabric.cab are the paths to the cluster configuration and the runtime .cab file respectively.

Passo 2: Ligar ao clusterStep 2: Connect to the cluster

Ligue-se ao cluster para verificar se o cluster está em funcionamento e disponível.Connect to the cluster to verify the cluster is running and available. O módulo do ServiceFabric PowerShell é instalado com o runtime.The ServiceFabric PowerShell module is installed with the runtime. Pode ligar-se ao cluster a partir de um dos nós do cluster ou de um computador remoto com o tempo de execução do Tecido de Serviço.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 ligação ao cluster.The Connect-ServiceFabricCluster cmdlet establishes a connection to the cluster.

Para se ligar a um cluster não seguro, execute o seguinte comando 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.2345:19000

Consulte Connect to a secure cluster (Ligar a um cluster seguro) para outros exemplos de ligação a um cluster.See Connect to a secure cluster for other examples of connecting to a cluster. Depois de ligar ao cluster, utilize o cmdlet Get-ServiceFabricNode para apresentar uma lista de nós no cluster e informações de estado 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. O 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

Passo 3: Visualizar o cluster utilizando o explorador de tecido de serviçoStep 3: Visualize the cluster using Service Fabric explorer

O Service Fabric Explorer é uma boa ferramenta para visualizar o seu cluster e gerir aplicações.Service Fabric Explorer is a good tool for visualizing your cluster and managing applications. Service Fabric Explorer é um serviço que funciona no cluster, a que você acede usando um navegador navegando para 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 dashboard do cluster fornece uma descrição geral do cluster, incluindo um resumo de aplicações e do estado de funcionamento do nó.The cluster dashboard provides an overview of your cluster, including a summary of application and node health. A vista do nó mostra o esquema físico do cluster.The node view shows the physical layout of the cluster. Para um determinado nó, pode inspecionar as aplicações que têm um código implementado nesse 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

Pode adicionar ou remover nós para o cluster do Service Fabric autónomo, conforme as necessidades da empresa são alteradas.You can add or remove nodes to your standalone Service Fabric cluster as your business needs change. Veja Adicionar ou Remover nós para um cluster autónomo do Service Fabric para obter passos detalhados.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 RemoveServiceFabricCluster.ps1 do PowerShell a partir da pasta do pacote e passe no caminho para o ficheiro de configuração do 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. Opcionalmente, pode especificar uma localização para o registo da eliminação.You can optionally specify a location for the log of the deletion.

Este script pode ser executado em qualquer máquina que tenha acesso ao administrador a todas as máquinas listadas como nós no ficheiro 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. A máquina em que este guião é executado não tem de 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 recolhidos e como optar por não o fazerTelemetry data collected and how to opt out of it

Como padrão, o produto recolhe telemetria no uso do Tecido de Serviço para melhorar o produto.As a default, the product collects telemetry on the Service Fabric usage to improve the product. O Analisador de Boas Práticas que funciona como parte da configuração verifica a conectividade de 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 não for alcançável, a configuração falha a menos que opte por não telemetria.If it is not reachable, the setup fails unless you opt out of telemetry.

  1. O gasoduto de telemetria tenta carregar os seguintes dados 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 tem impacto na funcionalidade do cluster.It is a best-effort upload and has no impact on the cluster functionality. A telemetria só é enviada do nó que dirige o gerente de failover primária.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 Tipos de ServiçosNumber of ServiceTypes
  • Número de CandidaturasNumber of Applications
  • Número de Upgrades de AplicaçõesNumber of ApplicationUpgrades
  • Número de FailoverUnitsNumber of FailoverUnits
  • Número de InBuildFailoverUnitsNumber of InBuildFailoverUnits
  • Número de Unidades não saudáveis failoverNumber of UnhealthyFailoverUnits
  • Número de RéplicasNumber of Replicas
  • Número de Réplicas inbuildNumber of InBuildReplicas
  • Número de Réplicas StandByNumber of StandByReplicas
  • Número de Réplicas OfflineNumber of OfflineReplicas
  • Comprimento da fila comumCommonQueueLength
  • ConsultaQueueLengthQueryQueueLength
  • FailoverUnitQueueLengthFailoverUnitQueueLength
  • CommitqueueLengthCommitQueueLength
  • Número de nósNumber of Nodes
  • IsContextComplete: True/FalseIsContextComplete: True/False
  • ClusterId: Este é 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 máquina a partir da qual a telemetria é carregadaIP address of the virtual machine or machine from which the telemetry is uploaded

Para desativar a telemetria, adicione o seguinte às propriedades do seu cluster config: enableTelemetria: falso.To disable telemetry, add the following to properties in your cluster config: enableTelemetry: false.

Funcionalidades de pré-visualização incluídas neste pacotePreview features included in this package

Nenhum.None.

Nota

A partir da nova versão GA do cluster autónomo para o Windows Server (versão 5.3.204.x),pode atualizar o seu cluster para futuras versões, manual ou automaticamente.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 Upgrade de um documento de versão de cluster de tecido de serviço autónomo para mais detalhes.Refer to Upgrade a standalone Service Fabric cluster version document for details.

Passos seguintesNext steps