---
title: "Atualizando o Rest PKI Core da versão 4.x para 5.0"
description: "Atualização do Rest PKI Core de 4.x para 5.0, que migrou do ASP.NET Core 8.0 para o 10.0, e os passos adicionais conforme o tipo de instalação."
canonical: "https://docs.lacunasoftware.com/articles/rest-pki/core/on-premises/update-50"
locale: "pt-BR"
product: "Rest PKI Core"
last_updated: "2026-10-12"
---

# Atualizando o Rest PKI Core da versão 4.x para 5.0

A versão [5.0](https://docs.lacunasoftware.com/articles/rest-pki/core/changelog#v5-0-0) do [Rest PKI Core](https://docs.lacunasoftware.com/articles/rest-pki/core) foi migrada do ASP.NET Core 8.0 para o ASP.NET Core 10.0, a versão LTS atual
do ASP.NET Core, [com suporte da Microsoft até novembro de 2028](https://dotnet.microsoft.com/platform/support/policy/dotnet-core#lifecycle) (o suporte
ao ASP.NET Core 8.0 termina em novembro de 2026).

Por isso, antes de atualizar a sua instância [on-premises](https://docs.lacunasoftware.com/articles/rest-pki/core/on-premises), você pode precisar seguir alguns passos adicionais, dependendo de como ela
está instalada.

## 1. Verifique como a sua instância está instalada

- Se a sua instância roda em **Docker** ou no **Azure App Services**, a imagem 5.x já inclui o ASP.NET Core Runtime 10.0 e tudo o mais de que ela
  precisa. Não há nada para instalar: **pule direto para o passo 3**.
- Se a sua instância roda diretamente em **Linux** (Ubuntu, Rocky Linux) ou em **Windows Server**, você precisa instalar o novo runtime antes:
  **siga para o passo 2**.

## 2. Instale o ASP.NET Core Runtime 10.0

Instale o runtime correspondente à sua plataforma, conforme descrito abaixo.

> **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

### Ubuntu

> **Info**
>
> Estas instruções assumem que você está logado como **root**. Se não estiver, execute `sudo su -` antes de continuar!

No **Ubuntu 24.04 (LTS) ou mais recente**, o ASP.NET Core Runtime 10.0 está disponível no repositório de pacotes padrão do Ubuntu:

```sh
apt update
apt install -y aspnetcore-runtime-10.0
```

No **Ubuntu 22.04 (LTS)**, primeiro registre o repositório de backports do .NET do Ubuntu e depois instale o runtime:

```sh
apt update
apt install -y software-properties-common
add-apt-repository -y ppa:dotnet/backports
apt update
apt install -y aspnetcore-runtime-10.0
```

> **Aviso**
>
> O Ubuntu 20.04 e versões anteriores não são suportados pelo .NET 10. Atualize o sistema operacional antes de atualizar o Rest PKI Core.

> **Cuidado**
>
> Se o ASP.NET Core Runtime anterior foi instalado a partir do repositório de pacotes da Microsoft (`packages.microsoft.com`), como era o caso no Ubuntu 20.04 e anteriores, remova esses pacotes antes de instalar o runtime pelo repositório do Ubuntu. Misturar pacotes do .NET dos dois repositórios causa erros na inicialização da aplicação. Para mais informações, veja [.NET package mix ups on Linux](https://learn.microsoft.com/dotnet/core/install/linux-package-mixup).

### Rocky Linux

> **Info**
>
> Estas instruções assumem que você está logado como **root**. Se não estiver, execute `sudo su -` antes de continuar!

No Rocky Linux 8, 9 e 10 (assim como no RHEL e em outras distribuições compatíveis), o ASP.NET Core Runtime 10.0 está disponível no repositório AppStream:

```sh
dnf install aspnetcore-runtime-10.0
```

### Windows Server

Baixe e instale o **Hosting Bundle do ASP.NET Core Runtime 10.0** na [página de download do .NET 10.0](https://dotnet.microsoft.com/download/dotnet/10.0)
(seção *ASP.NET Core Runtime*, item *Hosting Bundle* em *Windows*). Após a instalação, reinicie o IIS:

```powershell
iisreset
```

### Teste a instalação

No Linux, execute:

```sh
dotnet --list-runtimes
```

A saída deve incluir uma linha semelhante a:

```text
Microsoft.AspNetCore.App 10.0.* [*/dotnet/shared/Microsoft.AspNetCore.App]
```

> **Dica**
>
> Para outras versões de sistema operacional e formas alternativas de instalar o ASP.NET Core Runtime, veja [esta página](https://learn.microsoft.com/dotnet/core/install/)

## 3. Atualize o Rest PKI Core

Siga as instruções padrão de atualização da sua plataforma.

> **Observação**
>
> A versão 5.0 atualiza o modelo do banco de dados. Na instalação padrão, em que a aplicação tem privilégios de owner sobre o banco, o modelo é
> atualizado automaticamente na primeira vez em que a versão 5.0 é iniciada. Se a sua instância roda [sem privilégios de db_owner](https://docs.lacunasoftware.com/articles/rest-pki/core/on-premises/unprivileged-db-user),
> execute o comando [update-db](https://docs.lacunasoftware.com/articles/rest-pki/core/on-premises/tool/update-db) antes de iniciar a nova versão.

### Docker

Atualize os seus containers para a imagem `lacunasoftware/restpkicore:5.0`, conforme descrito na [instalação em Docker](https://docs.lacunasoftware.com/articles/rest-pki/core/on-premises/docker). Nenhuma outra
mudança é necessária: a imagem já inclui o ASP.NET Core Runtime 10.0 e todas as suas dependências.

As imagens Linux da versão 5.x são baseadas no **Ubuntu 24.04 (noble)** em vez do Debian 12 (bookworm). Isso não tem efeito se você apenas executa a
imagem.

### Azure App Services

Siga as [instruções de atualização no Azure App Services](https://docs.lacunasoftware.com/articles/rest-pki/core/on-premises/azure/update) com a imagem `5.0.0`. A observação acima sobre a imagem Docker também
vale aqui.

### Linux

Siga as [instruções de atualização no Linux](https://docs.lacunasoftware.com/articles/rest-pki/core/on-premises/linux/update) com o pacote `restpkicore-5.0.0.tar.gz`.

### Windows Server

Baixe o pacote `restpkicore-5.0.0.zip` indicado na [configuração no Windows Server](https://docs.lacunasoftware.com/articles/rest-pki/core/on-premises/windows-server), pare o site no IIS, substitua os arquivos
da pasta do site pelos do novo pacote e inicie o site novamente.

## 4. Verifique a versão instalada

Após a atualização, [verifique a versão](https://docs.lacunasoftware.com/articles/rest-pki/core/on-premises/check-version) da sua instância. O campo `productVersion` deve começar com `5.0`.

## OpenTelemetry

Se a sua instância exporta telemetria para um collector OpenTelemetry, observe que o valor padrão do atributo de recurso `service.name` mudou de
`restpkicore` para `Lacuna Rest PKI Core`. Se os seus dashboards ou consultas filtram pelo valor anterior, defina a variável de ambiente
`OTEL_SERVICE_NAME` explicitamente:

```sh
OTEL_SERVICE_NAME=restpkicore
```