Compartilhar via

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

O .NET tem suporte no Alpine e este artigo descreve como instalar o .NET no Alpine. Quando uma versão do Alpine ficar sem suporte, não haverá mais suporte dessa versão no .NET.

Se você estiver usando o Docker, considere usar imagens oficiais do Docker para .NET em vez de instalar o .NET por conta própria.

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

Instale o SDK (que inclui o runtime) se quiser desenvolver aplicativos .NET. Ou, se você precisar apenas executar aplicativos, instale o runtime. Se você estiver instalando o runtime, sugerimos que você instale o Runtime do ASP.NET Core, pois ele inclui runtimes do .NET e do 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, confira Como verificar se o .NET já está instalado.

Distribuições com suporte

A tabela a seguir é uma lista de versões .NET atualmente com suporte e as versões do Alpine nas quais elas têm suporte. Essas versões permanecerão com suporte 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 compatível Disponível no Gerenciador 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

Não ❌ há mais suporte para as seguintes versões do .NET:

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

Instalar o SDK

O SDK do .NET permite que você desenvolva aplicativos com o .NET. Se você instalar o SDK do .NET, não será necessário 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 do .NET, consulte Visão geral da CLI do .NET.

Instalar o runtime

O Runtime do ASP.NET Core permite executar aplicativos feitos com o .NET que não forneceram o runtime. O comando a seguir instala o runtime do ASP.NET Core, que é o runtime mais compatível com o .NET. No terminal, execute o seguinte comando:

sudo apk add aspnetcore10-runtime

Como alternativa ao runtime do ASP.NET Core, você pode instalar o runtime do .NET, que não inclui suporte ao 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 com suporte

A tabela a seguir é uma lista de versões do .NET atualmente compatíveis e a arquitetura 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 arquitetura do Alpine seja compatível#. 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

As versões prévias e Release Candidate do .NET não estão disponíveis em repositórios de pacotes. É possível instalar versões prévias e Release Candidate do .NET das seguintes maneiras:

Remover versões prévias

Ao usar um gerenciador de pacotes para gerenciar a instalação do .NET, pode ocorrer um conflito quando já existe uma versão prévia instalada. O gerenciador de pacotes pode interpretar a versão que 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 de como desinstalar o .NET, confira Como remover o SDK e o runtime do .NET.

Dependências

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

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

Próximas etapas

  • Last updated on