---
title: "Atualização do Signer em Azure App Services"
description: "Atualização do Signer em Azure App Services: verifique a versão instalada, faça backup do banco, publique o pacote novo pelo Kudu, confira a nova versão e saiba como voltar atrás."
canonical: "https://docs.lacunasoftware.com/articles/signer/on-premises/azure/update"
locale: "pt-BR"
product: "Signer"
last_updated: "2026-10-22"
---

# 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](https://docs.lacunasoftware.com/articles/signer/on-premises/azure).

## Antes de atualizar

1. Verifique a versão instalada. Abra `https://<seu-dominio>/api/system/info`. O campo `productVersion` mostra a versão.
1. Leia o [changelog](https://docs.lacunasoftware.com/articles/signer/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.
1. Se você vai sair da versão 2.x para a 3.x, siga também [Atualizando para 3.x](https://docs.lacunasoftware.com/articles/signer/on-premises/update-30#azure-app-services).
   Em um App Service Windows, a configuração *.NET version* deve ser **.NET 10 (LTS)**.
1. Atualize primeiro o App Service de homologação. Teste o envio e a assinatura de documentos antes de atualizar a produção.
1. 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**.
1. 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](https://docs.lacunasoftware.com/articles/signer/changelog).
1. Na seção **Overview** do App Service, clique em **Stop**.
1. Vá em **Advanced Tools** e clique em **Go** para abrir o Kudu.
1. No menu superior, clique em **Tools** e depois em **Zip Push Deploy**.
1. Arraste o pacote `.zip` para a lista de arquivos e espere o fim do deploy.
1. Faça em **Configuration** as alterações que o changelog pedir e clique em **Save**.
1. 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.
1. 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](https://docs.lacunasoftware.com/articles/signer/on-premises/rollback). Para voltar os binários, publique pelo Kudu o pacote `.zip`
da versão anterior.

## Veja também

* [Setup em Azure App Services](https://docs.lacunasoftware.com/articles/signer/on-premises/azure)
* [Rollback de versão](https://docs.lacunasoftware.com/articles/signer/on-premises/rollback)
* [Changelog](https://docs.lacunasoftware.com/articles/signer/changelog)