Pular para o conteúdo principal

Atualizando o Rest PKI Core da versão 2.x para 3.0

Como o ASP.NET Core 6.0 foi descontinuado, a versão 3.0 do Rest PKI Core foi migrada para o ASP.NET Core 8.0, que é a versão LTS mais recente do ASP.NET Core, com suporte da Microsoft até novembro de 2026.

Por isso, antes de atualizar a sua instância on-premises, você precisa seguir alguns passos adicionais.

1. Instale o ASP.NET Core Runtime 8.0​

Consulte a seção Instale o ASP.NET Core Runtime 8.0 do procedimento de instalação correspondente à sua plataforma:

dica

Não é necessário desinstalar as versões anteriores do ASP.NET Core Runtime: várias versões podem coexistir no mesmo sistema sem problemas

observação

No Docker, este passo não é necessário, pois a nova imagem 3.x já vem com o ASP.NET Core Runtime 8.0 embutido

2. Defina um AppDiscriminator explícito​

Verifique se o seu arquivo de configuração contém uma configuração chamada AppDiscriminator na seção General (ou General__AppDiscriminator, se você usa variáveis de ambiente). Se essa configuração existir e estiver preenchida, pule para o próximo passo. Se ela não existir (ou estiver com valor vazio), siga as instruções abaixo.

Abra o log da aplicação e procure a seguinte entrada:

Application starting: Lacuna Rest PKI Core (version: *, spaVersion: *, appDiscriminator: 'YOUR_APP_DISCRIMINATOR')
                                                                                          ^^^^^^^^^^^^^^^^^^^^^^

Copie o valor do campo appDiscriminator sem as aspas simples ao redor (no exemplo acima, o valor correto seria YOUR_APP_DISCRIMINATOR, e não 'YOUR_APP_DISCRIMINATOR') e adicione a configuração AppDiscriminator, com esse valor, na seção General do seu arquivo de configuração.

Exemplo (arquivo .ini ou .conf):

[General]
AppDiscriminator=YOUR_APP_DISCRIMINATOR

Exemplo (variáveis de ambiente):

General__AppDiscriminator=YOUR_APP_DISCRIMINATOR

Em seguida, reinicie a aplicação e verifique os logs novamente. Deve ser registrado um novo log "application starting", sem alteração no campo appDiscriminator.

3. Atualize o Rest PKI Core​

Depois de seguir os passos acima, prossiga com as instruções de atualização.

Solução de problemas com erros de certificado no SQL Server​

Diferentemente do .NET 6, no .NET 8 o padrão é validar o certificado do SQL Server. Isso pode fazer com que a sua instância falhe ao iniciar, com o seguinte erro nos logs:

Microsoft.Data.SqlClient.SqlException: 'A connection was successfully established with the server, but then an error occurred during the login process. (provider: SSL Provider, error: 0 - The certificate chain was issued by an authority that is not trusted.)'

Nesse caso, certifique-se de que o seu SQL Server está configurado com um certificado TLS confiável e que ele não expirou.

Se preferir ignorar a validação do certificado do SQL Server, acrescente ;TrustServerCertificate=True à connection string do banco de dados no arquivo de configuração.

Azure App Services​

Se a sua instância do Rest PKI Core estiver hospedada no Azure App Services:

  1. No portal do Azure, acesse a configuração do seu App Service
  2. Clique em Configuration e selecione a aba General settings
  3. Na seção Stack settings:
    1. A configuração Stack deve estar definida como .NET
    2. A configuração .NET version deve estar definida como .NET 8 (LTS)
dica

A seção Stack settings mencionada acima só aparece se o App Service Plan for baseado em Windows. Nos planos baseados em Linux, nenhuma alteração é necessária.

Ver em Markdown