Partilhar via

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

  • Artigo

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 libgdipluso , execute:

apk add libgdiplus

Próximos passos