Docker를 이용하여 Spring Boot 기반의 웹사이트 제작을 진행하려고 한다.
프로젝트를 시작하기 전에 먼저 개발 환경 세팅이 필요하다.
일반적으로는 Spring Boot 프로젝트를 먼저 생성한 후 Docker를 연결하여 배포 환경을 구성할 수도 있다.
하지만 프로젝트 후반부에 Docker를 연결할 경우 환경 차이로 인해 머리 아파지는 경우가 있다.
그래서 나는 개발 환경을 구성하는 첫 단계에서 Docker를 먼저 설치한 후 Spring Boot 프로젝트 개발부터 배포까지 Docker 기반으로 진행할 계획이다.
이번에 제작할 사이트에 대한 내용은 다음에 정리하도록 하고
이번 글에서는 Windows 환경에서 Docker와 VSCode를 이용해 Spring Boot 개발 환경을 세팅하는 과정을 정리하려 한다.
아래 순서로 진행할 예정이다.
WSL 2 → Ubuntu → Docker → VS Code 확장
이번 글에서는 먼저 WSL 2 설치부터 Ubuntu 초기 설정까지 작성하고 다음 글에서는 Docker 설치와 VS Code 확장 연결 과정을 정리할 예정이다.
1. WSL 2 설치
내가 작업하는 PC는 Windows 10 Home이다.
Docker 공식 문서도 WSL 2 백엔드를 Windows 개발 환경의 핵심 방식으로 안내하고 있고
VS Code와도 잘 연동되기 때문에 예전처럼 Hyper-V 기반으로 직접 쓰는 방식보다 WSL 2 + Docker Desktop 방식을 사용하도록 하겠다.
1.1 가상화 사용여부 확인
먼저 Docker는 내부적으로 Linux 가상 환경을 사용하기 때문에 CPU 가상화가 켜져 있는지 확인한다.
작업 관리자( Ctrl + Shift + Esc )를 열어 성능 탭에서 CPU를 선택하여 가상화가 켜져 있는지 확인한다.
1.2 WSL 2 설치
PowerShell을 관리자권한으로 실행한 후 아래 명령어를 입력한다
wsl --install이 명령어는 WSL 기능을 켜고 기본 Linux 배포판인 Ubuntu를 설치한다.
정상적으로 설치가 완료된다면 다음 단계인 Ubuntu 설치 및 초기 설정으로 넘어가면 된다.
내 PC에서는 해당 명령어를 입력하였을 경우 '설치 중: Linux용 Windows 하위 시스템 액세스가 거부되었습니다.'라는 이유로 더 이상 진행 할 수 없었다. WSL 관련 구성 요소가 최신 상태가 아니어서 발생한 문제라고 생각했기에 아래 명령어를 입력하여 WSL 업데이트를 시도했다.
wsl --update잘 될 리가 없다. PowerShell을 관리자 권한으로 실행했음에도 권한 상승이 필요하다는 메시지가 계속 출력되었다.
권한 설정이나 기타 상태를 확인했지만 원인은 찾지 못했다.
원인을 끝까지 추적하여 해결할 수도 있었지만 많은 시간을 사용하는 것은 비효율적이라 생각했기에 수동 설치를 하기로 한다.
아래 사이트로 이동하여 'wsl_update_x64.msi'을 다운로드하여 설치한다.
https://learn.microsoft.com/ko-kr/windows/wsl/install-manual
이전 버전의 WSL에 대한 수동 설치 단계
wsl install 명령을 사용하는 대신 이전 버전의 Windows에 WSL을 수동으로 설치하는 단계별 지침입니다.
learn.microsoft.com
2. Ubuntu 설치
Microsoft Store에서 Ubuntu를 검색하여 설치하려 했지만 실패하여 PowerShell을 통해 설치했다.
아래 명령어를 한 줄씩 순서대로 입력한다.
cd $env:USERPROFILE\Downloads
Invoke-WebRequest -Uri https://aka.ms/wslubuntu2004 -OutFile Ubuntu.appx -UseBasicParsing
Add-AppxPackage .\Ubuntu.appx
위 명령어는 현재 사용자 계정의 Downloads 폴더로 이동한 뒤 Ubuntu 설치 파일을 다운로드하고 Windows 앱 패키지로 설치하는 과정이다.
잘 설치가 된다면 '웹 요청을 쓰는 중 요청 스트림을 쓰는 중...(쓴 바이트 수: ....)' 라는 내용을 확인할 수 있다.
다운로드가 완료되면 아래 명령어를 입력한다.
Add-AppxPackage $env:USERPROFILE\Downloads\Ubuntu.appx
그 후 설치가 끝나면 시작 메뉴에서 설치된 우분투를 실행한다.
'Enter new UNIX username:'이 뜨면 사용자 이름을 입력하고 비밀번호까지 입력한다.
( 비밀번호를 입력할 때 터미널 화면에는 아무것도 표시되지 않는 것이 정상이다.)
사용자 이름과 비밀번호 설정이 완료되면 Ubuntu 초기 설정이 끝난다.
'IT SW 개발' 카테고리의 다른 글
| [Highcharts] 하이차트 Ctrl+C, Ctrl+V로 문서에 복사 붙여넣기_(2) (0) | 2026.06.17 |
|---|---|
| [Highcharts] 하이차트 Ctrl+C, Ctrl+V로 문서에 복사 붙여넣기_(1) (0) | 2026.06.17 |