Compartilhar via

Instalar o SDK do .NET ou o runtime do .NET no Alpine

.NET tem suporte no Alpine e este artigo descreve como instalar .NET no Alpine. Quando uma versão alpina fica sem suporte, .NET não tem mais suporte com essa versão.

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

Importante

.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 específica do Linux os inclua.

Instale o SDK (que inclui o runtime) se você quiser desenvolver .NET aplicativos. Ou, se você precisar apenas executar aplicativos, instale o runtime. Se você estiver instalando o Runtime, sugerimos que instale o ASP.NET Core Runtime pois ele inclui runtimes .NET e ASP.NET Core.

Use os comandos dotnet --list-sdks 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 com suporte

A tabela a seguir é uma lista de versões de .NET com suporte no momento e as versões do Alpine em que elas têm suporte. Essas versões permanecem compatíveis 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 em Package Manager
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 de .NET ❌ não têm mais suporte:

  • .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 .NET

Instalar o SDK

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

sudo apk add dotnet10-sdk

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

Instalar o runtime

O ASP.NET Core Runtime permite que você execute aplicativos que foram feitos com .NET que não forneceram o runtime. O comando a seguir instala o ASP.NET Core Runtime, que é o runtime mais compatível para .NET. No 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 ASP.NET Core suporte: substitua aspnetcore10-runtime no comando anterior por dotnet10-runtime:

sudo apk add dotnet10-runtime

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

Arquiteturas com suporte

A tabela a seguir é uma lista de versões de .NET com suporte no momento e a arquitetura do Alpine em que eles têm suporte. Essas versões permanecem com suporte até que a versão do .NET atinja o fim do suporte ou a arquitetura do Alpine seja compatível com#. Observe que somente x86_64, armv7 e aarch64 são compatíveis oficialmente com a Microsoft. Outras arquiteturas têm suporte dos 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 Nenhum Nenhum Nenhum
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 Nenhum Nenhum Nenhum
s390x Nenhum Nenhum Nenhum
ppc64le Nenhum Nenhum Nenhum
riscv64 Nenhum Nenhum Nenhum

Instalar versões prévias

Versões de prévia e candidato a lançamento do .NET não estão disponíveis em repositórios de pacotes. Você pode instalar versões prévias e lançar candidatos de .NET de uma das seguintes maneiras:

Remover versões prévias

Ao usar um gerenciador de pacotes para gerenciar a instalação de .NET, você poderá encontrar um conflito se já tiver instalado uma versão prévia. O gerenciador de pacotes pode interpretar a versão não prévia como uma versão anterior do .NET. Para instalar a versão que não é prévia, desinstale as versões prévias. Para obter mais informações sobre como desinstalar .NET, consulte How to remove the .NET Runtime and SDK.

Dependências

Quando você faz a instalação com um gerenciador de pacotes, essas bibliotecas são instaladas automaticamente. Porém, se você instalar manualmente o .NET ou publicar um aplicativo autossuficiente, 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 em execução no modo globalização-invariável)
  • tzdata
  • krb5

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

Próximas etapas

  • Last updated on