Partilhar via

Criar um cluster autónomo em execução no Windows Server

Você pode usar o Azure Service Fabric para criar clusters do Service Fabric em qualquer máquina virtual ou computador que execute o Windows Server. Isso significa que você pode implantar e executar aplicativos do Service Fabric em qualquer ambiente que contenha um conjunto de computadores Windows Server interconectados, seja no local ou com qualquer provedor de nuvem. O Service Fabric fornece um pacote de instalação para criar clusters do Service Fabric chamados de pacote autônomo do Windows Server. 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. Para saber mais sobre as diferenças, veja Comparação dos clusters Azure e clusters autónomos do Service Fabric.

Este artigo orienta você pelas etapas para criar um cluster autônomo do Service Fabric.

Observação

Este pacote autônomo do Windows Server está disponível comercialmente sem custo e pode ser usado para implantações de produção. Este pacote pode conter novos recursos do Service Fabric que estão em "Visualização". Desloque-se para baixo até à secção "Pré-visualizar funcionalidades incluídas neste pacote." para obter a lista das funcionalidades de pré-visualização. Você pode baixar uma cópia do EULA agora.

Obter suporte para o pacote do Service Fabric para Windows Server

Baixe o pacote do Service Fabric para Windows Server

Para criar o cluster, use o pacote do Service Fabric para Windows Server (Windows Server 2012 R2 e mais recente) encontrado aqui:
Link para download - Pacote autônomo do Service Fabric - Windows Server

Encontre detalhes sobre o conteúdo do pacote aqui.

O pacote de tempo de execução do Service Fabric é baixado automaticamente no momento da criação do cluster. Se estiver implantando a partir de uma máquina não conectada à Internet, faça o download do pacote de tempo de execução fora da banda aqui:
Link para download - Tempo de execução do Service Fabric - Windows Server

Encontre exemplos de Configuração de Cluster Independente em:
Exemplos de configuração de cluster autônomos

Criar o cluster

Vários arquivos de configuração de cluster de exemplo são instalados com o pacote de instalação. ClusterConfig.Unsecure.DevCluster.json é a configuração de cluster mais simples: um cluster inseguro de três nós em execução em um único computador. Outros arquivos de configuração descrevem clusters de uma ou várias máquinas protegidos com certificados X.509 ou segurança do Windows. Você não precisa modificar nenhuma das configurações padrão para este tutorial, mas examine o arquivo de configuração e familiarize-se com as configurações. A seção de 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. A seção de propriedades define a segurança, o nível de confiabilidade, a coleção de diagnósticos e os tipos de nós para o cluster.

O cluster criado neste artigo não é seguro. Qualquer pessoa pode se conectar anonimamente e executar operações de gerenciamento, portanto, os clusters de produção devem sempre ser protegidos usando certificados X.509 ou segurança do Windows. A segurança só é configurada no momento da criação do cluster e não é possível ativar a segurança após a criação do cluster. Atualize o arquivo de configuração, habilite a segurança do certificado ou a segurança do Windows. Leia Proteger um cluster para saber mais sobre a segurança do cluster do Service Fabric.

Etapa 1: Criar o cluster

Cenário A: Criar um cluster de desenvolvimento local não seguro

O Service Fabric pode ser implantado em um cluster de desenvolvimento de uma máquina usando o arquivo ClusterConfig.Unsecure.DevCluster.json incluído em Exemplos.

Descompacte o pacote autônomo em sua máquina, copie o arquivo de configuração de exemplo para a máquina local e execute o script CreateServiceFabricCluster.ps1 por meio de uma sessão do PowerShell do administrador, da pasta do pacote autônomo.

.\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 sobre a solução de problemas.

Se tiver terminado de executar cenários de desenvolvimento, você poderá remover o cluster do Service Fabric da máquina consultando as etapas na seção "Remover um cluster".

Cenário B: Criar um cluster de várias máquinas

Depois de passar pelas etapas de planejamento e preparação detalhadas em Planejar e preparar a implantação do cluster, você estará pronto para criar o cluster de produção usando o arquivo de configuração do cluster.

O administrador de cluster que implanta e configura o cluster deve ter privilégios de administrador no computador. Não é possível instalar o Service Fabric em um controlador de domínio.

  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 determinado ambiente. A preparação da implantação lista os pré-requisitos e os requisitos do ambiente. Execute o script para verificar se você pode criar o cluster de desenvolvimento:

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

    Você deverá ver um resultado semelhante ao seguinte. Se o campo inferior denominado "Aprovado" for retornado como "True", as verificações de integridade foram aprovadas e o cluster parece estar pronto para ser implementado com base na configuração de entrada.

    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: execute o script CreateServiceFabricCluster.ps1 para implantar o cluster do Service Fabric em cada máquina na configuração.

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

Observação

Os rastreamentos de implantação são gravados na VM/máquina na qual você executou o script do CreateServiceFabricCluster.ps1 PowerShell. Eles podem ser encontrados na subpasta DeploymentTraces, com base no diretório a partir do qual o script foi executado. Para ver se o Service Fabric foi implantado corretamente em uma máquina, localize os arquivos instalados no diretório FabricDataRoot, conforme detalhado na seção FabricSettings do arquivo de configuração do cluster (por padrão c:\ProgramData\SF). Além disso, os processos FabricHost.exe e Fabric.exe podem ser vistos em execução no Gestor de Tarefas.

Cenário C: Criar um cluster offline (desconectado da Internet)

O pacote de tempo de execução do Service Fabric é baixado automaticamente na criação do cluster. Ao implantar um cluster em máquinas não conectadas à Internet, você precisará baixar o pacote de tempo de execução do Service Fabric separadamente e fornecer o caminho para ele na criação do cluster. O pacote de tempo de execução pode ser descarregado separadamente, a partir de outra máquina ligada à Internet, em Download Link - Service Fabric Runtime - Windows Server. Copie o pacote de tempo de execução para o local onde está a implantar o cluster offline e crie o cluster executando CreateServiceFabricCluster.ps1, incluindo o parâmetro -FabricRuntimePackagePath, conforme mostrado neste exemplo:

.\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 de .cab de tempo de execução, respectivamente.

Etapa 2: Conectar-se ao cluster

Conecte-se ao cluster para verificar se o cluster está em execução e disponível. O módulo PowerShell do ServiceFabric é instalado com o tempo de execução. Você pode se conectar ao cluster a partir de um dos nós do cluster ou de um computador remoto com o runtime do Service Fabric. O cmdlet Connect-ServiceFabricCluster estabelece uma conexão com o cluster.

Para se conectar a um cluster não seguro, execute o seguinte comando do PowerShell:

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

Por exemplo:

Connect-ServiceFabricCluster -ConnectionEndpoint 192.13.123.234:19000

Consulte Conectar-se a um cluster seguro para obter outros exemplos de conexão a um cluster. Depois de se conectar ao cluster, use o cmdlet Get-ServiceFabricNode para exibir uma lista de nós no cluster e informações de status para cada nó. HealthState deve ser OK para cada nó.

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 explorador do Service Fabric

O Service Fabric Explorer é uma boa ferramenta para visualizar seu cluster e gerenciar aplicativos. O Service Fabric Explorer é um serviço executado no cluster, que você acessa usando um navegador navegando até http://localhost:19080/Explorer.

O painel do cluster fornece uma visão geral do cluster, incluindo um resumo da saúde das aplicações e dos nós. A visualização do nó mostra o layout físico do cluster. Para um determinado nó, pode inspecionar as aplicações que têm um código implementado nesse nó.

Explorador do Service Fabric

Adicionar e remover nós

Você pode adicionar ou remover nós ao cluster autônomo do Service Fabric à medida que as necessidades da sua empresa mudam. Consulte Adicionar ou remover nós a um cluster autônomo do Service Fabric para obter etapas detalhadas.

Remover um cluster

Para remover um cluster, execute o script RemoveServiceFabricCluster.ps1 PowerShell da pasta do pacote e passe o caminho para o arquivo de configuração JSON. Opcionalmente, você pode especificar um local para o log da exclusão.

Esse script pode ser executado em qualquer máquina que tenha acesso de administrador a todas as máquinas listadas como nós no arquivo de configuração do cluster. A máquina na qual esse script é executado não precisa fazer parte do 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 os utilizar

Por padrão, o produto coleta telemetria no uso do Service Fabric para melhorar o produto. Se não estiver acessível, a configuração falhará, a menos que você desative a telemetria.

  1. É um carregamento de melhor esforço e não tem impacto na funcionalidade do cluster. A telemetria só é enviada do nó que executa o gerenciador de failover principal. Nenhum outro nó envia telemetria.
  2. A telemetria consiste no seguinte:
  • Número de serviços
  • Número de Tipos de Serviço
  • Número de Aplicações
  • Número de Atualizações de Aplicações
  • Número de FailoverUnits
  • Número de InBuildFailoverUnits
  • Número de Unidades de Transferência de Falha Não Saudáveis
  • Número de réplicas
  • Número de InBuildReplicas
  • Número de StandByReplicas
  • Número de OfflineReplicas
  • CommonQueueLength
  • Comprimento da Fila de Consultas
  • FailoverUnitQueueLength
  • CommitQueueLength
  • Número de nós
  • IsContextComplete: Verdadeiro/Falso
  • ClusterId: Este é um GUID gerado aleatoriamente para cada cluster
  • ServiceFabricVersion
  • Endereço IP da máquina virtual ou da máquina a partir da qual a telemetria é carregada

Para desativar a telemetria, adicione o seguinte às propriedades na configuração do cluster: enableTelemetry: false.

Funcionalidades de pré-visualização incluídas neste pacote

Nenhum.

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, manual ou automaticamente. Consulte o documento Atualizar a versão de um cluster autónomo do Service Fabric para obter detalhes.

Próximos passos