WSL 개발 환경 설정 (with asdf)
2022-08-02 14:31:14

update log

날짜 변경점
2022/02/18 🎺 처음 글 작성한 날
2022/03/06 오타 수정
2022/08/02 오타 수정, asdf 설치 명령어 버전 수정, 추천 플러그인 리스트 추가, CNP 하기 쉽게 글 수정, 최신 설정으로 약간 수정

개요

windows에서 개발환경을 구축하는 경우 몇가지 불편한 점이 있었다.

존재하긴 하지만 아직은 부족한 패키지 관리자 (winget)

기본을 무시해 버리는 비 POSIX 터미널

따라오는 수많은 cli기반 툴들의 미지원

한번 꼬이면 어디부터 해결해야될지 모르겠는 PATH

사실 몇가지는 windows에 대해 몰라서 생기는 불편함과 문제점일 수도 있다.

그런데 마침 마소에서 WSL이라는 거의 완벽한 시스템을 제공하니 당연히 써야겠지

아무튼 WSL를 잘 설치해보자

보통 wsl --install -d ubuntu 이나 windows store에서 다운 받을 수 있다.

재부팅을 수행하면 ubuntu의 자동시작과 함께 리눅스 유저 설정이 가능하다.

이후 설명을 따라하자

소프트웨어 업데이트

1
sudo apt update && sudo apt upgrade -y && sudo apt autoremove -y

vscode remote 설정

vscode에서 Remote - WSL 플러그인 설치

터미널에서 code . 입력

Git 설정

1
2
3
4
sudo apt-get install git
git config --global user.name "Your Name"
git config --global user.email "youremail@domain.com"
git config --global credential.helper "/mnt/c/Program\\ Files/Git/mingw64/bin/git-credential-manager.exe"

windows의 crlf와 wsl의 lf의 충돌로 인한 문제 해결

docker 설치

1
2
3
// cmd or pwsh

winget install docker.desktop

docker desktop >> settings

General >> Use the WSL 2 based engine

Resources >> WSL INTEGRATION >> (turn on)

zsh, oh-my-zsh, p10k theme 설치

1
2
3
sudo apt install zsh
sh -c "$(wget https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh -O -)"
git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/themes/powerlevel10k

p10k 태마의 아름다움을 위해 Nerd FontsSource Code ProFont AwesomePowerline 폰트 중 하나를 선택해 windows에 설치 후 터미널의 폰트를 변경해주자

** Nerd Fonts를 이용할 때만 p10k 테마의 모든 설정을 활성화할 수 있다.

(Meslo Nerd Font 추천)

~/.zshrc 파일의

ZSH_THEME="robbyrussell" 이라고 적힌 라인을
 ZSH_THEME="powerlevel10k/powerlevel10k"
 로 교체하여 주자.

source ~/.zshrc 로 p10k 테마를 적용시킨다.

설정마법사 같은 창이 나오는데 대충 원하는 테마를 설정해주자.
만약 다시 설정하고 싶다면 p10k configure 명령어를 이용해 가능하다.

글쓴이는 다음과 같이 설정하였다.

oh-my-zsh 플러그인

1
2
3
4
5
# zsh-syntax-highlighting
git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting

# zsh-autosuggestions
git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions

~/.zshrc 파일에 plugins 항목에 다음과 같이 추가한다.

1
2
3
4
plugins=(
zsh-syntax-highlighting
zsh-autosuggestions
)

추천하는 플러그인 리스트

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
plugins=(
z
gh
git
httpie
sudo
rust
copypath
direnv
golang
python
docker-compose
docker
asdf
zsh-syntax-highlighting
zsh-autosuggestions
)

source .zshrc

터미널 입력 문제 해결

windows terminal과 oh-my-zsh의 뭔지 모를 문제로 인해

터미널에 붙혀넣기를 수행할때 한글자씩 천천히 입력되는 문제가 있다.

없어졌다면 다행이고..

이걸 해결하기 위해선 ~/.zshrc에 다음 한줄을 추가한다.

1
DISABLE_MAGIC_FUNCTIONS="true"

이후 source ~/.zshrc 나 터미널을 재시작 해보면 해당 문제가 사라졌음을 알 수 있다.

터미널 추천 툴

bat 설치 (clone cat)

Releases · sharkdp/bat

1
2
bat_version_amd64.deb <- 다운로드
sudo dpkg -i bat_version_amd64.deb

.zshrc에 추가

1
alias cat="bat"

이제 예쁜 cat으로 대체되었다


기억 해두면 좋은 옵션으로 --plain이 있다.
다음과 같이 변경되며 복사하기 편하게 바뀐다.

logo-ls 설치

Releases · Yash-Handa/logo-ls

1
2
logo-ls_amd64.deb <- 다운로드
sudo dpkg -i logo-ls_amd64.deb

zshrc에 다음 줄 추가

1
alias ls="logo-ls"

ls 명령어에 아이콘이 생겼다.
기존의 밋밋하던 ls 명령어에 아이콘이 생겼음을 확인할 수 있다.

asdf 설치 (version manager)

node, python, go 버전 관리 문제를 한번에 해결할 수 있다.

1
git clone https://github.com/asdf-vm/asdf.git ~/.asdf --branch v0.10.2

add to ~/.zshrc

1
2
3
4
5
6
. $HOME/.asdf/asdf.sh

# append completions to fpath
fpath=(${ASDF_DIR}/completions $fpath)
# initialise completions with ZSH's compinit
autoload -Uz compinit && compinit

ohmyzsh/plugins/asdf at master · ohmyzsh/ohmyzsh

source ~/.zshrc

이제 asdf 명령어를 실행할 수 있습니다.

asdf를 이용해 node 설치

node 플러그인 설치

1
asdf plugin-add nodejs https://github.com/asdf-vm/asdf-nodejs.git

node 최신 버전 설치

1
asdf install nodejs latest

node 시스템 전역 사용 선언

1
asdf global nodejs latest

asdf를 이용해 python 설치

python 플러그인 종속성 설치

1
2
3
sudo apt-get update; sudo apt-get install make build-essential libssl-dev zlib1g-dev \
libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm \
libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev

python 플러그인 설치

1
asdf plugin-add python

python 최신 버전 설치

1
asdf install python latest

python 시스템 전역 사용 선언

1
asdf global python latest

asdf를 이용해 golang 설치

node 플러그인 설치

1
asdf plugin-add golang

node 최신 버전 설치

1
asdf install golang latest

node 시스템 전역 사용 선언

1
asdf global golang latest

asdf 사용팁 💡

aws-cli, hugo 등의 cli 도구들의 설치 및 버전관리를 도와주는 좋은 툴이다.
대체로 툴의 설치는 앞서 보았듯 다음 4개 단계을 수행하면 설치된다.

  1. 해당 툴의 시스템 디펜던시 설치 (경우에 따라 다름)
  2. 해당 툴 플러그인 설치 (plugin-add)
  3. 툴의 최신버전 설치 (install)
  4. 툴의 특정 버전 전역 사용 선언 (global)

rustup를 이용한 rust 설치

러스트의 경우도 asdf로 설치를 진행할 수 있으나 개발도중 문제가 발생하는 경우가 있어 rustup를 이용한 설치를 권장한다.

1
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

선택하라는 메세지가 출력되며 옵션 1번 선택 (default)

깔끔하게 설치된다.

이전
2022-08-02 14:31:14
다음