포트폴리오를 위한 깃허브 페이지: WSL 개발 환경 구성

코스코드를 수정한 이력을 추적하고 관리하는 버전관리 시스템인 깃(git)의 저장소를 제공하는 깃허브(GitHub)는 저장소를 온라인으로 관리하고 저장소별로 커뮤니티 기능이나 문서화 기능을 제공하기도 합니다.

이번에 보유한 깃허브 저장소를 정리해서 외부에 공개해야 할 일이 생겼습니다. 깃허브는 깃허브 페이지(GitHub Pages)서비스를 무료로 제공합니다. 계정의 웹페이지나 공개저장소를 위한 웹페이지를 작성할 수 있습니다. 다만 데이터베이스를 사용할 수 없기 때문에 외부 서비스를 사용하지 않으면 로그인이나 댓글, 게시판, 추천 기능 같은 것은 구현할 수는 없습니다.

WSL 설치하기

저는 윈도우 11 환경에서 비주얼 스튜디오 코드(VSCode)로 소스코드를 작성하고 있습니다. 그러나 이 환경 그대로 깃허브 페이지를 로컬에서 테스트 할 수 있는 환경을 윈도우에 바로 구성하면 환경 구성에 어려움이 많습니다. 이것저것 복잡하게 구성하지 말고 그냥 윈도우에 리눅스를 설치해서 해결하겠습니다.

2022년 4월 9일 업데이트한 마이크르로 소프트 문서에는 쉽고 간편해진 WSL 설치 방법을 다루고 있습니다. 예전에는 권한 상승에 WSL 기본도구 설치하고 스토어에서 우분투를 설치해야 하는 복잡한 과정이었는 데 이제는 Windows 터미널(관리자)에서:

wsl --install

명령 하나면 자동으로 기본값인 우분투 설치까지 끝내줍니다.(Windows 10 버전 2004 이상 / Windows 11) 터미널은 시작버튼에 마우스 오른쪽 버튼을 클릭하여 손쉽게 실행할 수 있습니다.

설치 후 시스템을 재시작하며 자동으로 WSL-우분투 20.04가 실행됩니다. WSL 첫 실행과정에서 유닉스(UNIX)유저 이름과 비밀번호를 설정하면 필요한 설치과정이 모두 끝납니다.

물론 우분투 20.04가 아닌 다른 버전의 우분투로 변경할 수도 있고, 다른 배포판을 설치할 수도 있습니다.

PS C:> wsl --list --online
다음은 설치할 수 있는 유효한 배포 목록입니다.
'wsl --install -d <배포>'를 사용하여 설치하세요.

NAME            FRIENDLY NAME
Ubuntu          Ubuntu
Debian          Debian GNU/Linux
kali-linux      Kali Linux Rolling
openSUSE-42     openSUSE Leap 42
SLES-12         SUSE Linux Enterprise Server v12
Ubuntu-16.04    Ubuntu 16.04 LTS
Ubuntu-18.04    Ubuntu 18.04 LTS
Ubuntu-20.04    Ubuntu 20.04 LTS

wsl --list --online명령을 사용하면 현재 지원하는 배포판의 목록을 터미널에서 출력합니다.

VSCode 원격 개발 환경

깃을 사용하는 버전관리 도구는 VSCode에 기본적으로 탑재되어 있지만 깃이 설치되어 있지 않으면 실제로 작동하지 않습니다. 페이지를 방문해 설치프로그램을 내려받은뒤 설치합니다.

VSCode에서 WSL개발을 위해 확장도구를 설치합니다. WSL만 사용하는 경우 확장: Remote - WSL를 설치하고, SSH나 도커 등 다른 원격 개발 도구도 필요한 분은 확장: Remote Development을 설치합니다.

다른 아이콘팩을 사용하기 때문에 아이콘 형태가 기본값과 다르지만 원격 개발 도구 탭 아이콘이 추가되었습니다. 원격 개발 탭에서 접속하고자 하는 리눅스 배포판에 마우스 오른쪽 버튼을 클릭하여 Connect To WSL을 선택하면 원격접속이 완료됩니다. 첫 접속때는 필요한 원격 접속 도구를 WSL에 설치하는 과정이 있어 시간이 다소 걸립니다.

초기 설정이 끝나면 터미널을 열고 다음 명령을 실행합니다:

sudo apt update

sudo가 요구하는 비밀번호는 앞서 WSL을 설치한 뒤에 입력했던 유닉스 비밀번호입니다. 이 명령은 업데이트를 수행하는 것이 아니라 패키지목록을 받아오기만 합니다. 하지만 리눅스에 뭔가를 설치하기 전에 꼭 이 명령을 먼저 사용하세요. 다음은 만든 리눅스 환경에 깃허브 페이지 로컬 테스트 환경을 구성합니다.