Tutorial: Como implantar um aplicativo em um cluster gerenciado do Service Fabric

Nesta série de tutoriais, discutiremos:

Esta parte da série aborda como:

  • Conectar-se ao cluster gerenciado do Service Fabric
  • Carregar um aplicativo em um cluster
  • Criar uma instância de um aplicativo em um cluster
  • Remover um aplicativo de um cluster

Pré-requisitos

Conectar-se ao seu cluster

Para se conectar ao cluster, você precisará da impressão digital do certificado do cluster. Você poderá encontrar esse valor na saída das propriedades do cluster da sua implantação de recursos ou consultando as propriedades do cluster em um recurso existente.

O comando a seguir pode ser usado para consultar o recurso de cluster para a impressão digital do certificado de cluster.

$serverThumbprint = (Get-AzResource -ResourceId /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ServiceFabric/managedclusters/mysfcluster).Properties.clusterCertificateThumbprints

Com a impressão digital do certificado de cluster, você está pronto para se conectar ao cluster.

$connectionEndpoint = "mysfcluster.eastus2.cloudapp.azure.com:19000"
Connect-ServiceFabricCluster -ConnectionEndpoint $connectionEndpoint -KeepAliveIntervalInSec 10 `
      -X509Credential `
      -ServerCertThumbprint $serverThumbprint  `
      -FindType FindByThumbprint `
      -FindValue $clientThumbprint `
      -StoreLocation CurrentUser `
      -StoreName My

Carregar um pacote de aplicativos

Neste tutorial, usaremos o exemplo de Aplicativo de Votação do Service Fabric. Para obter mais detalhes sobre a implantação de aplicativo do Service Fabric por meio do PowerShell, confira Implantar e remover aplicativos do Service Fabric.

Observação

Na versão prévia do cluster gerenciado do Service Fabric, você não poderá publicar aplicativos diretamente do Visual Studio.

Primeiro, você precisará empacotar o aplicativo para implantação. Neste tutorial, siga as etapas para empacotar um aplicativo de dentro do Visual Studio. É importante anotar o caminho no qual o aplicativo foi empacotado, pois ele será usado para o caminho abaixo.

Quando o pacote de aplicativos tiver sido criado, você poderá carregar o pacote de aplicativos no cluster. Atualize o valor de $path para representar o caminho no qual o pacote de aplicativos existe e execute o seguinte:

$path = "C:\Users\<user>\Documents\service-fabric-dotnet-quickstart\Voting\pkg\Debug"
Copy-ServiceFabricApplicationPackage -ApplicationPackagePath $path -CompressPackage
Register-ServiceFabricApplicationType -ApplicationPathInImageStore Debug

Criar um aplicativo

É possível instanciar um aplicativo de qualquer versão do tipo de aplicativo registrada com êxito usando o cmdlet New-ServiceFabricApplication. O nome de cada aplicativo deve começar com o esquema "fabric:" e ser exclusivo para cada instância do aplicativo. Quaisquer serviços padrão definidos no manifesto do aplicativo do tipo de aplicativo de destino também são criados.

New-ServiceFabricApplication fabric:/Voting VotingType 1.0.0

Quando essa operação for concluída, você deverá ver as instâncias do aplicativo em execução no Service Fabric Explorer.

Remover um aplicativo

Quando uma instância do aplicativo não for mais necessária, você poderá removê-la permanentemente por nome usando o cmdlet Remove-ServiceFabricApplication, que também remove automaticamente todos os serviços que pertencem ao aplicativo, removendo permanentemente todo o estado do serviço.

Remove-ServiceFabricApplication fabric:/Voting

Próximas etapas

Nesta etapa, implantamos um aplicativo em um cluster gerenciado do Service Fabric. Para saber mais sobre as opções de implantação de aplicativos, confira:

Para saber mais sobre as opções de configuração de cluster gerenciado, confira: