Instalar o SDK do .NET ou o tempo de execução do .NET no Alpine
Importante
O .NET 8 foi lançado em 14 de novembro de 2023. Pode levar algum tempo para que os pacotes apareçam nos feeds do gerenciador de pacotes.
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.
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.
O gerenciador de pacotes Alpine suporta a instalação de algumas versões do .NET. Se o pacote .NET não estiver disponível, você precisará instalar o .NET de uma das seguintes maneiras alternativas:
Instalar o .NET 8
O .NET 8 ainda não está disponível na ramificação padrão do repositório de pacotes alpinos. Use a ramificação para instalar o edge
.NET 8. Como alternativa, use uma das seguintes maneiras de instalar o .NET 8:
Para saber como usar a CLI do .NET, consulte Visão geral da CLI do .NET.
Instalar o .NET 6
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 dotnet6-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 aspnetcore6-runtime
Como alternativa ao ASP.NET Core Runtime, você pode instalar o .NET Runtime, que não inclui suporte a ASP.NET Core. Para instalá-lo, substitua aspnetcore6-runtime
no comando anterior por dotnet6-runtime
:
sudo apk add dotnet6-runtime
Para saber como usar a CLI do .NET, consulte Visão geral da CLI do .NET.
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.
Alpine | Versão Suportada | Disponível no Gestor de Pacotes |
---|---|---|
3.20 | 8.0, 6.0 | 8.0, 6.0 |
3.19 | 8.0, 6.0 | 7.0, 6.0 |
3.18 | 8.0, 6.0 | 7.0, 6.0 |
3.17 | 8.0, 6.0 | 7.0, 6.0 |
As seguintes versões do .NET não são ❌ mais suportadas:
- .NET 7
- .NET 5
- .NET Core 3.1
- .NET Core 3.0
- .NET Core 2.2
- .NET Core 2.1
- .NET Core 2.0
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 apk
pacotes.
Arquitetura | .NET 6 | .NET 8 |
---|---|---|
x86_64 | 3.16, 3.17, 3.18, 3.19, 3.20 | 3.17, 3.18, 3.19, 3.20 |
x86 | Nenhuma | Nenhuma |
AARCH64 | 3.16, 3.17, 3.18, 3.19, 3.20 | 3.17, 3.18, 3.19, 3.20 |
ARMv7 | 3.16, 3.17, 3.18, 3.19, 3.20 | 3.17, 3.18, 3.19, 3.20 |
ARMHF | Nenhuma | Nenhuma |
S390X | 3.17 | 3.17 |
ppc64le | Nenhuma | Nenhuma |
RISCV64 | 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.18+
- CA-Certificados-Bundle
- libgcc
- libssl3
- libstdc++
- Zlib
- libgdiplus (se o aplicativo .NET exigir o assembly System.Drawing.Common )
3.15 - 3.17
- UTI-LIBS
- KRB5-LIBS
- libgcc
- libintl
- libssl3
- libstdc++
- Zlib
- libgdiplus (se o aplicativo .NET exigir o assembly System.Drawing.Common )
Use o apk add
comando para instalar as dependências.
Se o aplicativo .NET usa o assembly System.Drawing.Common , o libgdiplus também precisará ser instalado. Como System.Drawing.Common não é mais suportado no Linux, isso só funciona no .NET 6 e requer a configuração da opção de configuração de System.Drawing.EnableUnixSupport
tempo de execução.
Para instalar libgdiplus
o , execute:
apk add libgdiplus