Partilhar via

Instalar o SDK do .NET ou o tempo de execução do .NET no Alpine

O .NET é suportado no Alpine e este artigo descreve como instalar o .NET no Alpine. Quando uma versão Alpine deixa de ser suportada, o .NET deixa de ser suportado com essa versão.

Se você estiver usando o Docker, considere usar imagens oficiais do .NET Docker em vez de instalar o .NET você mesmo.

Importante

O .NET 10 foi lançado em 11 de novembro de 2025. Pode levar algum tempo para que os pacotes apareçam nos feeds do gerenciador de pacotes ou para que sua distribuição Linux específica o inclua.

Instale o SDK (que inclui o tempo de execução) se quiser desenvolver aplicativos .NET. Ou, se você só precisar executar aplicativos, instale o Runtime. Se você estiver instalando o Runtime, sugerimos que instale o ASP.NET Core Runtime , pois ele inclui os tempos de execução .NET e ASP.NET Core.

Use os dotnet --list-sdks comandos e dotnet --list-runtimes para ver quais versões estão instaladas. Para obter mais informações, consulte Como verificar se o .NET já está instalado.

Distribuições suportadas

A tabela a seguir é uma lista das versões do .NET atualmente suportadas e as versões do Alpine nas quais elas são suportadas. Essas versões permanecem suportadas até que a versão do .NET atinja o fim do suporte ou a versão do Alpine atinja o fim da vida útil.

Alpino Versão Suportada Disponível no Gestor de Pacotes
3.23 10, 9, 8 10, 9, 8
3.22 10, 9, 8 9, 8
3.21 9, 8 9, 8
3.20 9, 8 8, 6

As seguintes versões do .NET não são ❌ mais suportadas:

  • .NET 7
  • .NET 6
  • .NET 5
  • .NET Core 3.1
  • .NET Core 3.0
  • .NET Core 2.2
  • .NET Core 2.1
  • .NET Core 2.0

Instalar o .NET

Instale o SDK

O SDK do .NET permite que você desenvolva aplicativos com o .NET. Se você instalar o SDK do .NET, não precisará instalar o tempo de execução correspondente. Para instalar o SDK do .NET, execute o seguinte comando:

sudo apk add dotnet10-sdk

Para saber como usar a CLI do .NET, consulte Visão geral da CLI do .NET.

Instalar o tempo de execução

O ASP.NET Core Runtime permite executar aplicativos que foram criados com .NET que não forneceram o tempo de execução. O comando a seguir instala o ASP.NET Core Runtime, que é o tempo de execução mais compatível para .NET. No seu terminal, execute o seguinte comando:

sudo apk add aspnetcore10-runtime

Como alternativa ao ASP.NET Core Runtime, você pode instalar o .NET Runtime, que não inclui suporte ASP.NET Core: substitua aspnetcore10-runtime no comando anterior por dotnet10-runtime:

sudo apk add dotnet10-runtime

Para saber como usar a CLI do .NET, consulte Visão geral da CLI do .NET.

Arquiteturas suportadas

A tabela a seguir é uma lista das versões do .NET atualmente suportadas e a arquitetura do Alpine em que elas são suportadas. Essas versões permanecem suportadas até que a versão do .NET atinja o fim do suporte ou a arquitetura do Alpine seja suportada #. Note que apenas x86_64, armv7, aarch64 é oficialmente suportado pela Microsoft. Outras arquiteturas são suportadas pelos mantenedores de distribuição e podem ser instaladas usando o gerenciador de pacotes apk, se um pacote estiver disponível para essa arquitetura.

Arquitetura .NET 10 .NET 9 .NET 8
x86_64 3.22 3.20, 3.21, 3.22 3.20, 3.21, 3.22
x86 Nenhuma Nenhuma Nenhuma
AARCH64 3.22 3.20, 3.21, 3.22 3.20, 3.21, 3.22
ARMv7 3.22 3.20, 3.21, 3.22 3.20, 3.21, 3.22
ARMHF Nenhuma Nenhuma Nenhuma
S390X Nenhuma Nenhuma Nenhuma
ppc64le Nenhuma Nenhuma Nenhuma
RISCV64 Nenhuma Nenhuma Nenhuma

Instalar versões de pré-visualização

As versões candidatas de visualização e lançamento do .NET não estão disponíveis nos repositórios de pacotes. Você pode instalar visualizações e liberar candidatos do .NET de uma das seguintes maneiras:

Remover versões de pré-visualização

Ao usar um gerenciador de pacotes para gerenciar sua instalação do .NET, você pode entrar em conflito se tiver instalado anteriormente uma versão de visualização. O gerenciador de pacotes pode interpretar a versão de não-visualização como uma versão anterior do .NET. Para instalar a versão não prévia, primeiro desinstale as versões de visualização. Para obter mais informações sobre como desinstalar o .NET, consulte Como remover o .NET Runtime e SDK.

Dependências

Quando você instala com um gerenciador de pacotes, essas bibliotecas são instaladas para você. Mas, se você instalar manualmente o .NET ou publicar um aplicativo independente, precisará garantir que essas bibliotecas estejam instaladas:

3.20+

  • Certificados CA
  • libgcc
  • libssl3
  • libstdc++
  • zlib (somente .NET 8)
  • icu-libs e icu-data-full (a menos que o aplicativo .NET esteja sendo executado no modo invariante de globalização)
  • tzdata
  • KRB5

Use o apk add comando para instalar as dependências.

Próximos passos

  • Last updated on