Instalación del SDK y el entorno de ejecución de .NET en Alpine
Importante
.NET 9 se publicó el 12 de noviembre de 2024. Los paquetes pueden tardar tiempo en aparecer en las fuentes del administrador de paquetes o en la distribución específica de Linux para incluirlos.
.NET es compatible con Alpine y en este artículo se describe cómo instalar .NET en Alpine. Cuando una versión de Alpine no es compatible, .NET deja de ser compatible con esa versión.
Si usa Docker, plantéese usar imágenes oficiales de Docker de .NET en lugar de instalar .NET por su cuenta.
Instale el SDK (que incluye el entorno de ejecución) si quiere desarrollar aplicaciones .NET. O bien, si solo necesita ejecutar aplicaciones, instale el entorno de ejecución. Si va a instalar el entorno de ejecución, se recomienda instalar el entorno de ejecución de ASP.NET Core, ya que incluye los de .NET y ASP.NET Core.
Use los comandos dotnet --list-sdks y dotnet --list-runtimes para ver qué versiones están instaladas. Para obtener más información, vea Cómo comprobar que .NET Core ya está instalado.
Instalación de .NET
Instalación del SDK
El SDK de .NET permite desarrollar aplicaciones con .NET. Si instala el SDK de .NET, no necesita instalar el entorno de ejecución correspondiente. Para instalar el SDK de .NET, ejecute el comando siguiente:
sudo apk add dotnet8-sdk
Para obtener información sobre cómo usar la CLI de .NET, consulte Información general sobre la CLI de .NET.
Instalación de la instancia en tiempo de ejecución
El entorno de ejecución de ASP.NET Core le permite ejecutar aplicaciones creadas con .NET en las que no se ha proporcionado el entorno de ejecución. El comando siguiente instala ASP.NET Core Runtime, que es el runtime más compatible con .NET. Ejecute el comando siguiente en el terminal:
sudo apk add aspnetcore8-runtime
Una alternativa al entorno de ejecución de ASP.NET Core es instalar el de .NET, que no incluye compatibilidad con ASP.NET Core; en el comando anterior, reemplace aspnetcore8-runtime por dotnet8-runtime:
sudo apk add dotnet8-runtime
Para obtener información sobre cómo usar la CLI de .NET, consulte Información general sobre la CLI de .NET.
Distribuciones admitidas
En la tabla siguiente se muestra una lista de versiones de .NET actualmente compatibles y las versiones de Alpine en las que se admiten. Estas versiones siguen siendo compatibles hasta que la versión de .NET llega al fin del soporte técnico o la versión de Alpine llega al final del ciclo de vida.
| Alpine | Versión admitida | Disponible en Administrador de paquetes |
|---|---|---|
| 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 |
Importante
Alpine 3.17 alcanza el final de la vida el 22 de noviembre de 2024.
Las versiones siguientes de .NET ya ❌ no se admiten:
- .NET 7
- .NET 6 (a partir del 12 de noviembre de 2024)
- .NET 5
- .NET Core 3.1
- .NET Core 3.0
- .NET Core 2.2
- .NET Core 2.1
- .NET Core 2.0
Arquitecturas compatibles
En la tabla siguiente se muestra una lista de versiones de .NET actualmente compatibles y la arquitectura de Alpine en las que se admiten. Estas versiones siguen siendo compatibles hasta que la versión de .NET llega al fin del soporte técnico o la arquitectura de Alpine en las que se admite#. Tenga en cuenta que solo x86_64Microsoft admite oficialmente, armv7aarch64. Otras arquitecturas son compatibles con los mantenedores de distribución y se pueden instalar mediante el apk administrador de paquetes.
| Architecture | .NET 6 | .NET 8 |
|---|---|---|
| x86_64 | 3.17, 3.18, 3.19, 3.20 | 3.17, 3.18, 3.19, 3.20 |
| x86 | Ninguno | Ninguno |
| aarch64 | 3.17, 3.18, 3.19, 3.20 | 3.17, 3.18, 3.19, 3.20 |
| armv7 | 3.17, 3.18, 3.19, 3.20 | 3.17, 3.18, 3.19, 3.20 |
| armhf | Ninguno | Ninguno |
| s390x | 3,17 | 3,17 |
| ppc64le | Ninguno | Ninguno |
| riscv64 | Ninguno | Ninguno |
Instalación de versiones preliminares
Las versiones preliminares y candidatas para lanzamiento de .NET no están disponibles en los repositorios de paquetes. Puede instalar las versiones preliminares y versiones candidatas para lanzamiento de .NET de una de las formas siguientes:
Eliminación de versiones preliminares
Cuando se usa un administrador de paquetes para administrar la instalación de .NET, es posible que se produzca un conflicto si previamente se ha instalado una versión preliminar. El administrador de paquetes puede interpretar la versión que no es preliminar como una versión anterior de .NET. Para instalar la versión que no es preliminar, desinstale primero las versiones preliminares. Para obtener más información sobre cómo desinstalar .NET, vea Procedimiento para quitar el entorno de ejecución y el SDK de .NET.
Dependencias
Al realizar la instalación con un administrador de paquetes, estas bibliotecas se instalan automáticamente. Pero si instala manualmente .NET o publica una aplicación independiente, deberá asegurarse de que estas bibliotecas estén instaladas:
3.18+
- ca-certificates-bundle
- libgcc
- libssl3
- libstdc++
- zlib
- libgdiplus (si la aplicación .NET requiere el ensamblado System.Drawing.Common)
3.15 - 3.17
- icu-libs
- krb5-libs
- libgcc
- libintl
- libssl3
- libstdc++
- zlib
- libgdiplus (si la aplicación .NET requiere el ensamblado System.Drawing.Common)
Use el comando apk add para instalar las dependencias.
Si la aplicación de .NET usa el ensamblado System.Drawing.Common, también será necesario instalar libgdiplus. Dado que System.Drawing.Common ya no se admite en Linux, solo funciona en .NET 6 y requiere que se establezca el conmutador de configuración en tiempo de ejecución System.Drawing.EnableUnixSupport.
Para instalar libgdiplus, ejecute:
apk add libgdiplus
