Gerenciar aplicativos para vários ambientes

  • Artigo

Os clusters do Azure Service Fabric permitem criar clusters usando de um a milhares de computadores. Na maioria dos casos, você precisará implantar seu aplicativo em configurações de vários clusters: o cluster de desenvolvimento local, um cluster de desenvolvimento compartilhado e o cluster de produção. Todos esses clusters são considerados ambientes diferentes em que seu código deve ser executado. Os binários de aplicativo podem ser executados sem modificação em um amplo espectro, mas, com frequência, você desejará configurar o aplicativo de forma diferente.

Considere dois exemplos simples:

  • seu serviço escuta em uma porta definida, mas você precisa que essa porta seja diferente entre os ambientes
  • você precisa fornecer credenciais de associação diferentes para um banco de dados entre os ambientes

Especificando a configuração

A configuração que você fornece pode ser dividida em duas categorias:

  • Configuração que se aplica a como os serviços são executados
    • Por exemplo, o número da porta para um ponto de extremidade ou o número de instâncias de um serviço
    • Essa configuração é especificada no arquivo de manifesto do serviço ou aplicativo
  • Configuração que se aplica ao código do aplicativo
    • Por exemplo, as informações de associação para um banco de dados
    • Essa configuração pode ser fornecida por meio de arquivos de configuração ou variáveis de ambiente

Observação

Nem todos os atributos no arquivo de manifesto do serviço e aplicativo dão suporte a parâmetros. Nesses casos, você precisa substituir cadeias de caracteres como parte do fluxo de trabalho de implantação. No Azure DevOps, é possível usar uma extensão como Substituir Tokens: https://marketplace.visualstudio.com/items?itemName=qetza.replacetokens ou no Jenkins seria possível executar uma tarefa de script para substituir os valores.

Especificando parâmetros durante a criação de aplicativos

Ao criar instâncias de um aplicativo nomeado no Service Fabric, você tem a opção de passar parâmetros. A maneira de fazer isso depende de como você cria a instância do aplicativo.

  • No PowerShell, o cmdlet New-ServiceFabricApplication usa os parâmetros do aplicativo como uma tabela de hash.
  • Usando o sfctl, o comando sfctl application create aceita parâmetros como uma cadeia de caracteres JSON. O script install.sh usa sfctl.
  • O Visual Studio fornece um conjunto de arquivos de parâmetro na pasta Parâmetros no projeto do aplicativo. Esses arquivos de parâmetro são usados durante a publicação do Visual Studio, usando o Azure DevOps Services ou o Azure DevOps Server. No Visual Studio, os arquivos de parâmetro são passados para o script Deploy-FabricApplication.ps1.

Próximas etapas

Os artigos a seguir mostram como usar alguns dos conceitos descritos aqui: