InstallKit은 새로운 PC에서 개발 환경을 구성할 때 필요한 프로그램, 런타임, VSCode 확장 등을 자동으로 설치하기 위한 도구입니다.

사용자는 필요한 설치 항목을 선택한 뒤 설치 버튼을 클릭하면 되며, 설치 상태와 로그를 화면에서 확인할 수 있습니다.

지원 환경

설치 파일 실행

배포된 설치 파일을 실행합니다.

install-kit-setup.exe

설치 마법사의 안내에 따라 설치를 완료합니다.

기본 실행 흐름

프로젝트 정보는 설치할 런타임, 확장 프로그램, 개발환경 구성 방식을 결정하는 기준입니다.

프로젝트 기본 정보

개발 언어별 설치 기준

네트워크 환경

로컬 환경 구성 방식

설치 항목 선택

개발환경 설치 화면에서 설치 가능한 프로그램 목록을 확인하고 필요한 항목만 선택합니다.

• Git
• VSCode
• Node.js
• JDK
• Gradle
• Docker
• XAMPP
• Postman
• D2Coding Font

설치 상태

개발환경 설치 후 프로젝트에 필요한 VSCode 확장을 설치합니다.

확장 카테고리

• Basic
• Java
• Spring Boot
• Vue
• React
• Database
• Docker

설치 절차

설치 완료 후 각 프로그램이 정상 설치되었는지 확인합니다.

확인 명령어

git --version
node -v
npm -v
java -version
echo $env:JAVA_HOME
gradle -v
docker version
code --version

설치 버튼을 눌러도 동작하지 않습니다.

원인: 설치 항목이 선택되지 않았을 수 있습니다.

해결: 하나 이상의 설치 항목을 선택한 후 다시 설치합니다.

설치되어 있는데 미설치로 표시됩니다.

원인: 설치 확인 경로가 실제 설치 경로와 다를 수 있습니다.

where.exe git
Get-Command code | Select-Object -ExpandProperty Source

다운로드에 실패합니다.

원인: Nexus 서버 주소가 잘못되었거나 내부망 연결이 끊겼을 수 있습니다.

올바른 예시: http://host:9998/repository/pds
잘못된 예시: http://host:9998/repository/pds/

PowerShell 실행 오류가 발생합니다.

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

Docker 설치 또는 실행이 실패합니다.

• WSL 설치 여부
• Ubuntu 설치 여부
• BIOS 가상화 활성화 여부
• Windows 재부팅 여부

기존에 설치된 프로그램이 있어도 사용할 수 있나요?

가능합니다. InstallKit은 설치 여부를 확인한 뒤 필요한 항목만 설치합니다.

일부 프로그램만 설치할 수 있나요?

가능합니다. 체크박스로 필요한 항목만 선택할 수 있습니다.

설치를 다시 실행해도 되나요?

가능합니다. 이미 설치된 항목은 상태 확인 후 건너뛰거나 필요한 경우에만 재설치합니다.

인터넷이 없어도 사용할 수 있나요?

가능합니다. 내부 Nexus 서버 또는 로컬 설치 파일을 사용하는 환경에서는 외부 인터넷 없이도 설치할 수 있습니다.

설치 후 명령어가 인식되지 않습니다.

새 PowerShell 창을 열거나 PC를 재부팅한 뒤 다시 확인합니다.