시스템 요구 사항 및 환경 확인

본 설치 가이드는 CentOS 7.5 64 비트 환경을 기준으로 작성되었습니다. 안정적인 설치를 위해 최소 1 코어 CPU 와 2GB 메모리, 그리고 외부 네트워크 접근이 가능한 상태여야 합니다.

설치를 시작하기 전에 시스템에 기존 .NET 관련 패키지가 존재하는지 확인합니다.

[root@server ~]# dotnet --version
-bash: dotnet: command not found

위와 같이 명령어를 찾을 수 없다는 메시지가 나타나면 깨끗한 상태이므로 설치를 진행합니다. 이미 버전 정보가 출력된다면 기존 환경을 정리하거나 별도의 경로를 설정해야 합니다.

패키지 매니저 및 저장소 설정

Microsoft 공식 패키지를 설치하려면 먼저 yum 패키징 도구를 최신 상태로 업데이트하고, Microsoft 의 서명 키 및 저장소를 등록해야 합니다.

[root@server ~]# yum update -y
...
Complete!

다음으로 공식 패키지 저장소 RPM 을 설치합니다. 변수를 활용하여 URL 을 관리하면 스크립트 유지보수에 유리합니다.

[root@server ~]# MICROSOFT_REPO="https://packages.microsoft.com/config/centos/7/packages-microsoft-prod.rpm"
[root@server ~]# sudo rpm -Uvh $MICROSOFT_REPO
Retrieving https://packages.microsoft.com/config/centos/7/packages-microsoft-prod.rpm
Preparing...                          ################################# [100%]
Updating / installing...
   1:packages-microsoft-prod-1.0-1    ################################# [100%]

Yum 미러 오류 대응 및 캐시 생성

경우에 따라 기본 yum 저장소 연결 문제로 인해 패키지 설치 중 오류가 발생할 수 있습니다. 이 경우 국내 미러 서버를 활용하여 저장소 설정을 변경하면 안정성을 높일 수 있습니다.

[root@server ~]# wget -O /etc/yum.repos.d/CentOS-Base.repo http://mirrors.aliyun.com/repo/Centos-7.repo
[root@server ~]# yum makecache
Metadata Cache Updated

저장소 설정이 완료되면 캐시를 생성하여 subsequent 설치 명령어의 속도를 향상시킵니다.

.NET Core SDK 설치

개발 환경 구축을 위해서는 SDK(Software Development Kit) 가 필요합니다. 런타임만 설치할 경우 개발 명령어 실행이 제한될 수 있으므로 SDK 설치를 권장합니다.

[root@server ~]# sudo yum install -y dotnet-sdk-3.0
...
Installed:
  dotnet-sdk-3.0.x86_64 0:3.0.101-1

Dependency Installed:
  aspnetcore-targeting-pack-3.0.x86_64 0:3.0.1-1
  dotnet-apphost-pack-3.0.x86_64 0:3.0.1-1
  dotnet-targeting-pack-3.0.x86_64 0:3.0.0-1
  netstandard-targeting-pack-2.1.x86_64 0:2.1.0-1
Complete!

ASP.NET Core 런타임 설치 옵션

서버 배포 환경에서 코드 실행만 필요한 경우, SDK 대신 런타임만 설치하여 리소스를 절약할 수 있습니다. ASP.NET Core 런타임 패키지는 .NET Core 런타임을 포함하므로 별도로 설치할 필요가 없습니다.

[root@server ~]# sudo yum install -y aspnetcore-runtime-3.0
...
Installed:
  aspnetcore-runtime-3.0.x86_64 0:3.0.1-1

Dependency Installed:
  dotnet-host.x86_64 0:3.0.1-1
  dotnet-hostfxr-3.0.x86_64 0:3.0.1-1
  dotnet-runtime-3.0.x86_64 0:3.0.1-1
  dotnet-runtime-deps-3.0.x86_64 0:3.0.1-1
  libicu.x86_64 0:50.2-3.el7
Complete!

설치 검증 및 구성 요소 구분

설치가 완료되면 버전을 확인하여 정상 동작 여부를 점검합니다.

[root@server ~]# dotnet --version
3.0.101

만약 버전 확인 시 SDK 를 찾을 수 없다는 오류가 발생한다면, 런타임만 설치된 상태일 가능성이 높습니다. Java 의 JRE 와 JDK 관계처럼, .NET 도 실행 환경 (Runtime) 과 개발 도구 (SDK) 가 구분됩니다.

• Runtime: 애플리케이션 실행에 필요한 필수 구성 요소 (dotnet-host, dotnet-runtime 등)
• SDK: 애플리케이션 개발 및 빌드에 필요한 도구 포함 (Runtime 포함)

따라서 dotnet 명령어를 통해 빌드나 생성 기능을 사용하려면 반드시 dotnet-sdk 패키지가 설치되어 있어야 합니다.