Pular para o conteúdo principal

Atualização do Signer em Azure App Services

Esta página mostra como atualizar uma instância on-premises do Signer instalada em um App Service conforme o setup em Azure App Services.

Antes de atualizar​

  1. Verifique a versão instalada. Abra https://<seu-dominio>/api/system/info. O campo productVersion mostra a versão.
  2. Leia o changelog de todas as versões entre a sua e a nova. Procure as versões marcadas com alteração no modelo do banco de dados.
  3. Se você vai sair da versão 2.x para a 3.x, siga também Atualizando para 3.x. Em um App Service Windows, a configuração .NET version deve ser .NET 10 (LTS).
  4. Atualize primeiro o App Service de homologação. Teste o envio e a assinatura de documentos antes de atualizar a produção.
  5. Escolha um horário de pouco uso. Na primeira inicialização, a aplicação atualiza o banco de dados quando a versão nova tem alterações no modelo.
aviso

Se o App Service Plan executa mais de uma instância, só uma deve atualizar o banco de dados. Reduza o plano para uma instância (Scale out) antes de atualizar e volte ao número anterior depois que o site iniciar.

Backup​

  1. No portal do Azure, abra o SQL database do Signer e verifique se você consegue fazer uma restauração point-in-time para o horário de antes da atualização. Se preferir, crie uma cópia do banco com Copy.
  2. Guarde o pacote .zip da versão instalada. Você vai precisar dele se tiver de voltar os binários.

As configurações do App Service (Configuration) e os arquivos da storage account não mudam com a atualização.

Atualização​

  1. Baixe o pacote da versão nova: https://cdn.lacunasoftware.com/signer/signer-<versão>.zip. Os links de cada versão estão no changelog.
  2. Na seção Overview do App Service, clique em Stop.
  3. Vá em Advanced Tools e clique em Go para abrir o Kudu.
  4. No menu superior, clique em Tools e depois em Zip Push Deploy.
  5. Arraste o pacote .zip para a lista de arquivos e espere o fim do deploy.
  6. Faça em Configuration as alterações que o changelog pedir e clique em Save.
  7. Na seção Overview, clique em Start.

Verifique a atualização​

  1. Abra https://<seu-dominio>/api/system/info e verifique se productVersion mostra a versão nova. O primeiro acesso pode demorar enquanto o banco é atualizado.
  2. Se houver erro, consulte os logs na tabela da storage account configurada em Serilog__WriteTo__0__Args__storageTableName (padrão: SignerLog).

Se o site não iniciar e o log mostrar PKI SDK License was not loaded successfully, a aplicação não carregou a licença do PKI SDK (licença ausente, inválida ou vencida). Peça uma licença atualizada à Lacuna e informe-a em PkiSuite__SdkLicense.

Se algo der errado​

Se a versão nova tiver um problema, fale primeiro com o suporte da Lacuna. Se for preciso voltar à versão anterior, siga o rollback de versão. Para voltar os binários, publique pelo Kudu o pacote .zip da versão anterior.

Veja também​

Ver em Markdown