로컬환경에서 Jekyll 환경 구축하기

김남주 - 2023년 08월 26일

infomation jekyll docker local environment setup

1. Docker 환경 구축하기

1.1 Docker 설치하기

Docker Logo

1.1.1 윈도우

  1. WSL 2 설치하기

  2. 패키지 관리자 설치하기

  3. Docker Desktop 설치하기

    관리자 모드로 PowerShell을 실행하고 다음 명령어를 실행합니다.

    choco install docker-desktop

    이후 설치가 완료되면 재부팅 후 Docker Desktop을 실행합니다.

1.1.2 맥

  1. Homebrew 설치하기

  2. Docker Desktop 설치하기

    터미널을 열고 다음 명령어를 실행합니다.

    brew install --cask docker

    이후 설치가 완료되면 Docker Desktop을 실행합니다.

다음과 같은 화면이 나오면 Docker Desktop이 정상적으로 설치된 것입니다.

Docker Desktop

2. GDSC-DEU 블로그 프로젝트 내려받기

GitHub에서 GDSC-DEU 블로그 프로젝트를 내려받습니다.

깃 또는 깃허브가 설치되어 있지 않다면 패키지 매니저를 이용하여 설치해주세요.

git clone https://github.com/GDSC-DEU/gdsc-deu.github.io.git

또는 GitHub Desktop을 사용하여 프로젝트를 내려받습니다.

주의사항: 내려받은 프로젝트의 경로를 기억해두세요.

3. Jekyll 이미지 다운로드하기

터미널을 열고 다음 명령어를 실행합니다.

docker pull jekyll/jekyll

4. Jekyll 서버 실행하기

내려받은 프로젝트의 경로로 이동한 후 다음 명령어를 실행합니다.

맥 & 리눅스

docker run  -it -v $(pwd):/srv/jekyll -p 4000:4000 jekyll/jekyll jekyll serve

윈도우

윈도우의 경우 $(pwd) 대신에 프로젝트의 경로를 입력해주세요.

예) 프로젝트의 경로가 c:\Users\GDSC\gdsc-deu.github.io일 경우

docker run  -it -v c:/Users/GDSC/gdsc-deu.github.io:/srv/jekyll -p 4000:4000 jekyll/jekyll jekyll serve

실행 확인

브라우저에서 http://localhost:4000으로 접속하여 Jekyll 서버가 정상적으로 실행되는지 확인합니다.

web-site

윈도우의 경우 자동으로 재 빌드가 되지 않습니다. 변경사항이 반영되지 않을 경우 도커에서 컨테이너를 재실행해주세요.