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.
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.
| Alpine | Versão compatível | Disponível no Gerenciador de Pacotes |
|---|---|---|
| 3,21 | 9.0, 8.0 | 9.0, 8.0 |
| 3,20 | 9.0, 8.0 | 8.0, 6.0 |
| 3,19 | 9.0, 8.0 | 7.0, 6.0 |
| 3,18 | 8.0 | 7.0, 6.0 |
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
Não há suporte no Alpine 3.18.
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 dotnet9-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 aspnetcore9-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 aspnetcore9-runtime no comando anterior por dotnet9-runtime:
sudo apk add dotnet9-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 9 | .NET 8 |
|---|---|---|
| x86_64 | 3.19, 3.20, 3.21 | 3.18, 3.19, 3.20, 3.21 |
| x86 | Nenhum | Nenhum |
| aarch64 | 3.19, 3.20, 3.21 | 3.18, 3.19, 3.20, 3.21 |
| armv7 | 3.19, 3.20, 3.21 | 3.18, 3.19, 3.20, 3.21 |
| armhf | Nenhum | Nenhum |
| s390x | Nenhum | Nenhum |
| ppc64le | Nenhum | Nenhum |
| riscv64 | 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.18+
- ca-certificates-bundle
- libgcc
- libssl3
- libstdc++
- zlib
- libgdiplus (se o aplicativo .NET exigir o assembly System.Drawing.Common)
Use o comando apk add para instalar as dependências.
Se o aplicativo .NET usar o assembly System.Drawing.Common, libgdiplus deverá ser instalado. Para obter mais informações, consulte System.Drawing.Common com suporte apenas no Windows.
Para instalar libgdiplus, execute:
apk add libgdiplus
