Spring Boot & Docker 배포하기

도커를 사용해서 간단한 Srping Boot 서버를 도커 이미지로 만들고 배포해 보자.

---

프로젝트 생성

Spring Initializr를 통해서 위와 같이 프로젝트를 생성해 주었다.

간단한 컨트롤러를 하나 만들어 주었다.

Docker 설치

윈도우에서 도커를 설치, 사용하기 위해서는 Hyper-V, WSL2 두 가지 방법이 있는 것 같다.

• Hyper-V : 윈도우에서 여러 운영 체제를 실행하기 위해서 쓰는 가상 머신

• WSL2 : 리눅스용 윈도우 하위 시스템(Windows Subsystem for Linux 2, WSL2)으로 윈도우의 가상화 기능을 활용해서 윈도우 위에서 리눅스를 사용할 수 있게 해줌

WSL2 방식이 좀 더 안정적으로 동작한다고 하니 이걸 써보자.

Windows Terminal 설치

WSL2를 사용하려면 먼저 Windows Terminal을 설치해 주어야 한다.
이도 두 가지 방법이 있다.

1. Microsoft Store에서 설치하기

• 좌측 하단의 윈도우 검색창에 'Microsoft Store' 검색
• 스토어 검색창에 'Windows Terminal' 검색 후 다운로드
  
  설치 전이라면 열기 버튼이 다운로드 버튼일 것이다. 그걸 클릭하자.

2. Microsoft 홈페이지에서 설치하기

• Microsoft 공식 홈페이지에서 다운로드
  https://www.microsoft.com/ko-kr/p/windows-terminal/9n0dx20hk701?rtc=1&activetab=pivot:overviewtab 여기서 다운받아도 된다.

WSL2 설치

1. Linux용 Windows 하위 시스템 사용

• 설치된 'Windows Terminal' 앱을 관리자 권한으로 실행
  
• Windows PowerShell 프롬프트 열기 (관리자 권한으로 실행하면 바로 열림)
  
• '관리자'가 붙어있는지 확인 후 아래 명령어 실행

$ dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

2. WSL2 요구사항 확인

• 윈도우 빌드 확인
• Windows PowerShell 프롬프트에 아래 명령어 실행

$ winver

• x64 시스템의 경우: 버전 1903 이상, 빌드 18362 이상
• ARM64 시스템의 경우: 버전 2004 이상, 빌드 19041 이상
• 18362보다 낮은 빌드는 WSL2를 지원하지 않음

• 빌드 버전이 낮을 경우,
  Windows Update Assistant를 사용하여 Windows 버전을 업데이트 수행
  https://www.microsoft.com/ko-kr/software-download/windows10

3. Virtual Machine 기능 사용

• 아래 명령어 실행

$ dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

WSL2 업그레이드

1. Linux커널 업데이트 패키지 다운로드

• 최신 패키지 다운로드
  https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi

• 다운로드한 패키지를 관리자 권한으로 실행

좌측 하단 검색창에 명령 프롬프트 검색 후 관리자 권한으로 실행
아래 명령어 실행

$ cd C:\Users\사용자\Downloads (다운로드 받은 패키지의 경로.)
$ wsl_update_x64.msi (파일 실행)

업데이트 진행

업데이트 완료

2. WSL2를 기본 버전으로 설정

• 아래의 명령어 실행
• 기본 WSL 버전 설정만 해도 도커 실행 가능
• 배포판 WSL 버전 변경은 리눅스 사용 시 진행
  (해당 글에서는 리눅스 앱을 다운받아 테스트할 것이기 때문에 진행)

$ wsl --set-default-version 2  ( 기본 WSL 버전 설정 )
$ wsl --set-version <distribution name> <versionNumber>  ( 배포판 WSL 버전 변경 )
$ wsl --set-version Ubuntu-18.04 2  ( 예시 )

GNU/Linux 앱 설치

1. Linux 배포 다운로드

• 'Microsoft Store'에서 다운 받을 Linux 배포판 검색
• "Ubuntu:18.04 LTS" 다운로드
  
  
• 여러가지 Linux 배포판이 있으므로 자신의 PC 사양에 맞는 리눅스 배포판을 검색하여 설치하면 된다.

Docker Desktop 설치

1. Google에 Docker 검색
2. 윈도우용 'Docker Desktop' 설치
   
3. 다운받은 'Docker Desktop Installer' 실행
   

• 안내에 따라 설치
• 설치 중간에 Configuration 항목은 모두 체크
  
  다른 블로그들에서는 'Install required Windows components for WSL 2'라는 항목이 있는데 나는 나타나지 않았다. 버전이 달라져서 그런건가.. 일단 진행해 보자.

도커 WSL 설정 확인하기

1. Docker 실행

2. [Settings]-[General] 선택 후 설정 확인
   
   블로그와 다르게 나는 이미 체크가 되어 있었다. 일단 진행.

3. [Settings]-[Resources]-[WSL INTEGRATION] 선택 후 설정 확인
   
   이것도 블로그와 다르게 나는 아무것도 없었다. 항목 하나가 없었다. 일단 진행.

4. 변경 항목 저장
   Apply & Restart 클릭하여 변경 설정 저장
   나는 변경점이 없다.

설치 확인

1. 'Windows Terminal' 관리자 권한으로 실행

2. 'Windows Powershell'에서 다음 명령어 실행하여 설치 확인
   
   잘 된 건지 모르겠지만 설치했던 Ubuntu와 Docker-desktop이 보인다.

3. 'Ubuntu'에서 다음 명령어 실행하여 설치 확인
   
   Ubuntu에서 실행하라고 해서 해봤는데 커맨드를 찾을 수가 없단다. 하라는대로 했는데.. 혹시 몰라서 Windows PowerShell에서 실행해 봤다.
   
   여기서 실행하니까 커맨드가 먹긴 먹는데 이게 맞는 건지를 모르겠다..