본문으로 건너뛰기

실무 가이드

개발 PC 필수 확인​

HandStack 개발 환경을 준비할 때는 다음을 확인합니다.

  • .NET SDK와 ASP.NET Core Runtime 버전
  • Node.js LTS 버전
  • Git
  • PowerShell 7 이상
  • 운영체제별 파일 동기화 도구
  • 브라우저와 개발자 도구
  • 필요 시 Docker, IIS, pm2

Windows 서버에서 IIS로 실행한다면 ASP.NET Core Hosting Bundle 설치와 IIS 재시작도 필요합니다.

패키지와 산출물 구분​

NuGet과 npm은 개발 시점의 패키지 종속성입니다. 반면 운영 서버에는 빌드 결과와 실행에 필요한 파일이 배치됩니다.

HandStack 배포 산출물에는 보통 다음 영역이 포함됩니다.

handstack/
├─ app/
├─ assemblies/
├─ hosts/
├─ modules/
├─ tools/
└─ contracts/

신규 개발자는 패키지 설치와 배포 산출물 복사를 혼동하지 않아야 합니다. 개발 PC에서 빌드가 된다고 해서 운영 서버에도 같은 파일이 자동으로 존재하는 것은 아닙니다.

모듈 종속성 관리​

업무 모듈이 별도 DLL이나 네이티브 라이브러리를 필요로 하면 다음을 확인합니다.

  • 빌드 결과에 해당 파일이 포함되는가?
  • HANDSTACK_HOME/modules/<moduleID> 아래에 필요한 파일이 복사되는가?
  • Linux와 Windows에서 파일명이 다르거나 네이티브 런타임이 다른가?
  • 라이브러리 버전이 HandStack 코어와 충돌하지 않는가?

체크리스트​

  • 신규 개발자가 스크립트만 실행해 개발 환경을 만들 수 있는가?
  • 운영 서버에 수동 설치해야 하는 항목이 문서화되어 있는가?
  • 외부 DLL이나 네이티브 파일이 배포 산출물에 포함되는가?
  • 개발 전용 패키지가 운영 필수 종속성처럼 섞여 있지 않은가?
  • OS별 .bat, .ps1, .sh 사용 기준이 명확한가?