본문으로 건너뛰기

필수 프로그램 설치하기

개발에 필요한 필수 환경 구성을 위한 Git, .NET Core, Node.js, curl 도구는 크로스 플랫폼 개발을 지원하므로 공식 웹 사이트에서 Windows, macOS, Linux에서 실행되는 설치 관리자를 제공합니다.

설치 관리자를 이용한 설치는 대부분 권장되며 간단한 설치 방법을 제공합니다.

만약 버전 업데이트 자동화 기능이 필요하다면 .NET Core와 Node.js같은 프로그램을 설치하는 방법은 각 운영 체제의 특성과 설치 절차를 이해하는 것을 필요로 합니다.

이러한 작업은 사용자의 시스템에 변경을 가하므로 보안 및 권한 문제를 고려해서 자신의 환경에 적합한 안정적이고 신뢰할 수 있는 설치 스크립트를 만들고 테스트해야 합니다. 다음의 패키지 관리자 명령 프롬프트 예시를 참고하세요.

Windows 10+ 에서 명령 프롬프트로 설치하기​

이 과정은 관리자 권한이 필요할 수 있으며, 설치 중에 권한 상승을 요구하는 메시지가 표시될 수 있습니다. 모든 패키지를 설치하고 환경 변수가 적용된 명령 프롬프트를 사용하기 위해 창을 다시 시작하거나 시스템을 재부팅하는 것을 권장합니다.

명령 프롬프트 창을 열기 위해 Windows 키 + R을 누르고, 나타나는 창에 cmd.exe를 입력하고 엔터를 누릅니다.

Winget 을 이용한 Git 설치​

Git을 설치하는 방법은 명령 프롬프트를 열고 다음 명령을 실행하여 2.44.0+을 설치합니다.

winget install -e --id=Git.Git

Winget 을 이용한 .NET Core 설치​

.NET 10.0을 설치하는 방법은 명령 프롬프트를 열고 다음 명령을 실행하여 .NET Core 10.0을 설치합니다.

winget install -e --id=Microsoft.DotNet.SDK.10

Winget 을 이용한 Node.js 설치​

Node.js LTS를 설치하는 방법은 명령 프롬프트를 열고 다음 명령을 실행하여 Node.js v20.12.2+ LTS를 설치합니다.

winget install -e --id=OpenJS.NodeJS.LTS

업데이트 할 패키지를 검색하기 위해 다음 명령을 실행합니다.

winget search Git.Git
winget search Microsoft.DotNet
winget search OpenJS.NodeJS
winget search cURL.cURL

설치 된 패키지를 최신 버전으로 업데이트하는 방법은 다음과 같습니다.

winget upgrade -e --id=<package-id>

macOS 에서 명령 프롬프트로 설치하기​

.NET Core 10.0 의 경우 macOS 12+ (Monterey) 이상을 지원합니다. macOS 11 (Big Sur) 포함 이하 버전에서는 Homebrew 와 같은 패키지 관리자에서 설치 오류가 발생하지만 .NET Core 10.0 다운로드 에서 직접 macOS 설치 관리자를 다운로드 받아 설치 할 수 있으나 공식적으로 지원하지 않습니다.

터미널(Terminal) 창을 열기 위해 Spotlight 검색(Cmd + Space)을 이용하여 Terminal을 찾거나, Finder에서 Applications > Utilities > Terminal을 찾아 실행합니다.

Homebrew 를 이용한 Git 설치​

brew install git

위의 명령어는 Git 2.44을 다운로드 하고 설치합니다.

Homebrew 를 이용한 .NET Core 설치​

brew install --cask dotnet-sdk

위의 명령어는 .NET Core 10.0+ 을 다운로드 하고 설치합니다.

Homebrew 를 이용한 Node.js 설치​

brew install node@20

위의 명령어는 Node.js v20.12.2 LTS 을 다운로드 하고 설치합니다.

Homebrew 명령으로 설치되는 위치는 /opt/homebrew/opt/node@20 입니다. 이 경로를 시스템의 PATH에 추가해야 node 명령을 편리하게 사용할 수 있습니다. 이를 위해 터미널에서 다음 명령을 실행합니다.

echo 'export PATH="/opt/homebrew/opt/node@20/bin:$PATH"' >> ~/.zprofile
source ~/.zprofile

Homebrew 를 이용한 curl 설치​

brew install curl

위의 명령어는 curl 을 다운로드 하고 설치합니다.

이렇게 하면 CLI 에서 을 macOS 에 설치할 수 있습니다. 이 과정은 관리자 권한이 필요할 수 있습니다.

Homebrew를 사용하여 업데이트가 필요한 패키지의 목록을 확인하려면 brew outdated 명령어를 사용하면 됩니다. 이 명령어는 현재 설치된 패키지 중에서 업데이트가 가능한 패키지의 목록을 보여줍니다.

brew outdated

설치 된 패키지를 최신 버전으로 업데이트하는 방법은 다음과 같습니다.

brew upgrade <package-id>

Ubuntu 22.04에서 명령 프롬프트로 설치하기​

터미널(Terminal) 창을 열기 위해 Dash 검색(Alt + F2)을 이용하여 Terminal을 찾거나, Show Applications에서 Terminal을 찾아 실행합니다.

apt 를 이용한 Git 설치​

sudo apt install -y git

위의 명령어는 Git 2.44을 다운로드하고, 설치를 관리자 권한으로 실행합니다.

apt, apt-get 를 이용한 .NET Core 설치​

# Microsoft 패키지 리포지토리 등록
sudo add-apt-repository ppa:dotnet/backports
sudo apt update

sudo apt-get install -y dotnet-sdk-10.0
sudo apt-get install -y aspnetcore-runtime-10.0
sudo apt-get install -y dotnet-runtime-10.0

위의 명령어는 .NET Core 10.0+ 을 다운로드하고, 설치를 관리자 권한으로 실행합니다.

만약 기존 dotnet 버전을 삭제 후 재설치하려면 다음 명령어로 기존 dotnet 버전을 삭제후 설치를 진행하세요.

sudo apt-get remove --purge 'dotnet*'
sudo apt-get autoremove

apt-get 를 이용한 Node.js 설치​

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

위의 명령어는 Node.js v20.12.2 LTS 을 다운로드하고, 설치를 관리자 권한으로 실행합니다.

apt 를 이용한 curl 설치​

sudo apt install -y curl

위의 명령어는 curl 을 다운로드하고, 설치를 관리자 권한으로 실행합니다.

apt를 사용하여 업데이트가 필요한 패키지의 목록을 확인하려면 apt list --upgradable 명령어를 사용하면 됩니다. 이 명령어는 현재 설치된 패키지 중에서 업데이트가 가능한 패키지의 목록을 보여줍니다.

apt list --upgradable

설치 된 패키지를 최신 버전으로 업데이트하는 방법은 다음과 같습니다.

sudo apt upgrade <package-id>

프로그램 설치 확인하기​

설치가 제대로 되었는지 확인하려면, 명령 프롬프트에 Git, .NET Core, Node.js 실행을 위한 환경 변수가 적용되기 위해, 새로운 명령 프롬프트 창을 실행해서 아래의 명령어를 입력해보세요.

git -v
dotnet --version
node -v
curl -V

CLI 도구 설치하기​

HandStack 화면 개발을 위해 필요한 CLI 도구를 설치합니다. 이 도구 들을 활용하여 클라이언트 측 라이브러리를 관리하고 배포를 위한 번들링 작업, 서버 프로세스 관리를 위한 서비스를 관리할 수 있습니다.

libman 설치하기​

LibMan는 .NET Core 기반의 CLI 도구로 가벼운 클라이언트 라이브러리 획득 도구입니다. 이 도구는 파일 시스템에서 또는 CDN (콘텐츠 전송 네트워크)에서 인기 있는 라이브러리 및 프레임워크를 다운로드합니다. 지원되는 CDN은 CDNJS, jsDelivr 및 unpkg 입니다.

이 도구는 .NET Core 전역 도구로서 Microsoft.Web.LibraryManager.Cli NuGet 패키지에서 설치됩니다. LibMan CLI를 설치하려면 다음 명령어를 사용합니다.

Windows 10+ 에서 명령 프롬프트로 설치하기​

dotnet tool install -g Microsoft.Web.LibraryManager.Cli

macOS, Ubuntu 에서 명령 프롬프트로 설치하기​

sudo dotnet tool install -g Microsoft.Web.LibraryManager.Cli

설치가 완료 되면 CLI 에서 libman 명령어를 사용할 수 있습니다.

클라이언트 라이브러리 목록은 libman.json 파일에 다음과 같은 형식으로 정의되어 있습니다.

{
  "version": "1.0",
  "defaultProvider": "cdnjs",
  "libraries": [
	{
	  "library": "jquery@3.4.1",
	  "destination": "wwwroot/lib/jquery/",
	  "files": [
		"jquery.min.js",
		"jquery.min.map"
	  ]
	},
	{
	  "library": "bootstrap@4.3.1",
	  "destination": "wwwroot/lib/bootstrap/",
	  "files": [
		"dist/css/bootstrap.min.css",
		"dist/js/bootstrap.min.js"
	  ]
	}
  ]
}

이 파일은 프로젝트의 handstack/2.Modules/wwwroot/libman.json 에 있습니다. 라이브러리를 추가하거나 제거하려면 libman.json 파일을 편집하고 libman restore 명령을 실행합니다. 이 명령은 libman.json 파일에 정의된 모든 라이브러리를 다운로드합니다.

통합 개발 환경으로 Visual Studio 2022 를 사용하는 경우, 프로젝트를 열면 libman.json 파일을 인식하여 변경 할 때 마다 자동으로 업데이트 됩니다.

libman.json 파일의 라이브러리는 HandStack 프로젝트 내부의 다음의 위치에 배치되어야 하며, 이 위치는 libman.json 파일의 destination 속성에 정의되어 있습니다.

pm2 설치하기​

PM2는 Node.js 애플리케이션을 위한 프로덕션 프로세스 매니저로, 내장된 로드 밸런서를 가지고 있습니다.

이 도구는 Node.js 전역 도구로서 pm2 Nuget 패키지에서 설치됩니다. pm2 CLI를 설치하려면 다음 명령어를 사용합니다.

Windows 10+ 에서 명령 프롬프트로 설치하기​

npm install -g pm2

macOS, Ubuntu 에서 명령 프롬프트로 설치하기​

sudo npm install -g pm2

주요 기능으로 프로그램이 장애가 발생하면 자동으로 재시작하고, 로그를 관리하며, 멀티 프로세스를 관리할 수 있습니다.

PM2는 기본적으로 Node.js 애플리케이션을 실행하는 데 사용되며, HandStack 의 ack 서버 프로그램을 실행할 때도 사용 가능합니다.

gulp 설치하기​

Gulp는 Node.js 기반의 Task 업무 및 번들링 자동화 도구로, 반복적인 작업들을 위해 개발된 도구입니다.

이 도구는 Node.js 전역 도구로서 Gulp Nuget 패키지에서 설치됩니다. Gulp CLI를 설치하려면 다음 명령어를 사용합니다.

Windows 10+ 에서 명령 프롬프트로 설치하기​

npm install -g gulp-cli

macOS, Ubuntu 에서 명령 프롬프트로 설치하기​

sudo npm install -g gulp-cli

주요 기능은 배포를 위한 CSS, JS, fonts, image 등의 리소스 최적화를 수행합니다.