Instalación del SDK y el entorno de ejecución de .NET en CentOS Linux

  • Artículo

.NET es compatible con CentOS Linux. En este artículo se describe cómo instalar .NET en CentOS Linux. Si necesita instalar .NET En CentOS Stream, consulte Instalación del SDK de .NET o de .NET Runtime en RHEL y CentOS Stream.

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.

Importante

El uso de un administrador de paquetes para instalar .NET desde la fuente de paquetes de Microsoft solo admite la arquitectura x64. Otras arquitecturas, como la Arm, no son compatibles con la Fuente de paquetes de Microsoft.

Para obtener más información sobre cómo instalar .NET sin un administrador de paquetes, consulte uno de los siguientes artículos:

Distribuciones admitidas

En la tabla siguiente se muestra una lista de las versiones de .NET compatibles actualmente con CentOS Linux 7. Estas versiones siguen siendo compatibles hasta que la versión de .NET llegue al final del soporte técnico o hasta que ya no se admita la versión de CentOS Linux.

CentOS Linux .NET
7 7, 6

Advertencia

El final del ciclo de vida (EOL) de CentOS Linux 8 llegó de forma prematura el 31 de diciembre de 2021. Para más información, consulte la página oficial de EOL de CentOS Linux. Por este motivo, .NET no se admite en CentOS Linux 8.

Las versiones siguientes de .NET ya ❌ no se admiten:

  • .NET 5
  • .NET Core 3.1
  • .NET Core 3.0
  • .NET Core 2.2
  • .NET Core 2.1
  • .NET Core 2.0

Importante

El uso de un administrador de paquetes para instalar .NET desde la fuente de paquetes de Microsoft solo admite la arquitectura x64. Otras arquitecturas, como la Arm, no son compatibles con la Fuente de paquetes de Microsoft.

Para obtener más información sobre cómo instalar .NET sin un administrador de paquetes, consulte uno de los siguientes artículos:

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.

CentOS Linux 7

Antes de instalar .NET, ejecute los siguientes comandos para agregar la clave de la firma del paquete de Microsoft a la lista de claves de confianza y agregar el repositorio de paquetes de Microsoft. Abra un terminal y ejecute los comandos siguientes:

sudo rpm -Uvh https://packages.microsoft.com/config/centos/7/packages-microsoft-prod.rpm

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 yum install dotnet-sdk-7.0

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 yum install aspnetcore-runtime-7.0

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 aspnetcore-runtime-7.0 por dotnet-runtime-7.0:

sudo yum install dotnet-runtime-7.0

Procedimiento para instalar otras versiones

Todas las versiones de .NET están disponibles para la descarga en https://dotnet.microsoft.com/download/dotnet, pero requieren la instalación manual. Puede intentar usar el administrador de paquetes para instalar una versión diferente de .NET. Sin embargo, es posible que la versión solicitada no esté disponible.

Los paquetes agregados a las fuentes del administrador de paquetes se denominan con un formato susceptible de intrusiones, como, por ejemplo: {product}-{type}-{version}.

  • product
    Tipo de producto .NET que se va a instalar. Las opciones válidas son:

    • dotnet
    • aspnetcore

  • type
    Elige el SDK o el entorno de ejecución. Las opciones válidas son:

    • sdk (solo disponible para el producto dotnet )
    • runtime

  • version
    Versión del SDK o del entorno de ejecución que se va a instalar. Las opciones válidas son cualquier versión de lanzamiento, como las siguientes:

    • 8.0
    • 6.0
    • 3.1
    • 2.1

    Es posible que el SDK o el entorno de ejecución que intenta descargar no esté disponible para la distribución de Linux. Para obtener una lista de las distribuciones admitidas, vea Instalación de .NET en Linux.

Ejemplos

  • Instalación del entorno de ejecución de ASP.NET Core 8.0: aspnetcore-runtime-8.0
  • Instalación del entorno de ejecución de ASP.NET Core 2.1: dotnet-runtime-2.1
  • Instalación del SDK de .NET 5: dotnet-sdk-5.0
  • Instalación del SDK de .NET Core 3.1: dotnet-sdk-3.1

Nota:

Es posible que algún paquete no esté disponible en la distribución de Linux.

Falta el paquete

Si la combinación de paquete y versión no funciona, no está disponible. Por ejemplo, no hay un SDK de ASP.NET Core. Los componentes del SDK para ASP.NET Core se incluyen con el SDK de .NET. El valor aspnetcore-sdk-8.0 es no es correcto y debe ser dotnet-sdk-8.0. Para obtener una lista de las distribuciones de Linux compatibles con .NET, vea Dependencias y requisitos de .NET.

Solución de problemas del administrador de paquetes

En esta sección se proporciona información sobre los errores comunes que puede obtener al usar el administrador de paquetes para instalar .NET.

No se puede encontrar el paquete

Importante

El uso de un administrador de paquetes para instalar .NET desde la fuente de paquetes de Microsoft solo admite la arquitectura x64. Otras arquitecturas, como la Arm, no son compatibles con la Fuente de paquetes de Microsoft.

Para obtener más información sobre cómo instalar .NET sin un administrador de paquetes, consulte uno de los siguientes artículos:

No se pudo capturar el elemento

Al instalar el paquete de .NET, puede ver un error similar a signature verification failed for file 'repomd.xml' from repository 'packages-microsoft-com-prod'. En términos generales, este error significa que la fuente de paquetes para .NET se está actualizando con versiones de paquetes más recientes y que debe volver a intentarlo más tarde. Durante una actualización, la fuente de paquetes no debe estar disponible durante más de 2 horas. Si recibe este error continuamente durante más de 2 horas, abra una incidencia en https://github.com/dotnet/core/issues.

Para obtener más información sobre cómo resolver estos problemas, vea Solución de errores de fxr, libhostfxr.so y FrameworkList.xml.

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:

  • krb5-libs
  • libicu
  • openssl-libs
  • zlib

Si la versión de OpenSSL del entorno de tiempo de ejecución de destino es 1.1 o más reciente, deberá instalar compat-openssl10.

Las dependencias se pueden instalar con el comando yum install. En el fragmento de código siguiente se muestra cómo instalar la biblioteca libicu:

sudo yum install libicu

Para obtener más información sobre las dependencias, vea Aplicaciones de Linux independientes.

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.

Puede instalar una versión reciente de libgdiplusagregando el repositorio Mono al sistema.

Pasos siguientes