Atualizando o Amplia da versão 4.x para 5.0
A versão 5.0 do Amplia foi migrada para o ASP.NET Core 10.0, a versão LTS mais recente do ASP.NET Core, com suporte da Microsoft até novembro de 2028.
Por isso, para atualizar a sua instância on-premises, você precisa instalar o ASP.NET Core Runtime 10.0 antes de instalar a nova versão.
Consulte a seção de instalação do ASP.NET Core Runtime 10.0 do procedimento de instalação correspondente à sua plataforma:
- Windows Server (ASP.NET Core 10.0 Hosting Bundle)
- Linux
O .NET 10 não oferece mais suporte a algumas versões antigas de sistemas operacionais, como Red Hat Enterprise Linux 7 e Oracle Linux 7. Se o seu servidor usa uma delas, migre a instância para uma versão suportada antes de atualizar.
No Docker, não há nada a fazer: a imagem 5.0 já é baseada na imagem do ASP.NET Core 10.0. Use a imagem lacunasoftware/amplia:5.0
(veja Setup do Amplia em Docker).
Em seguida, atualize o Amplia normalmente:
- Atualização do Amplia em Windows Server
- Atualização do Amplia em Linux
- Atualização do Amplia em Azure App Services
Atualização do modelo do banco de dados
Esta atualização altera o modelo do banco de dados. Por padrão, o Amplia atualiza o modelo do banco de dados sozinho ao iniciar. Se o Amplia opera sem ser owner do banco de dados, atualize o modelo do banco de dados com o comando update-db antes de iniciar a nova versão (veja Operando o Amplia sem ser owner do banco de dados).
Métricas do Prometheus
O Amplia 5.0 não expõe mais métricas para o Prometheus (a integração experimental adicionada na 4.13.0). Se você coleta essas métricas, remova o Amplia da configuração do seu Prometheus.
Key stores Azure Key Vault
O key store Azure Key Vault agora usa a versão 4 do Azure SDK. As configurações existentes (AppId com AppKey ou CertThumb) continuam funcionando. O Amplia 5.0 também adiciona a configuração UseManagedIdentity, para autenticar com a identidade gerenciada do host em vez de uma chave secreta ou certificado do aplicativo.
Azure App Services
Se a sua instância do Amplia está hospedada no Azure App Services como descrito em Instalação do Amplia em Azure App Services (App Service Plan Linux executando a imagem Docker), nenhuma alteração nas configurações de stack é necessária: importe a imagem 5.0 e selecione a tag dela.
Se a sua instância usa um App Service Plan baseado em Windows, na seção Stack settings de Configuration > General settings, defina a configuração Stack como .NET e a configuração .NET version como .NET 10.