손쉽게 Windows에서 WSL 2와 Miniconda를 활용한 개발 환경 구축하기

 

 

 

 

 

 

안녕하세요! 😊 이번 포스팅에서는 윈도우 환경에서 WSL 2와 VS Code를 사용해 Linux 개발 환경을 구축하는 과정을 함께 해볼 거예요. 환경 설정은 생각보다 까다롭고 작은 실수 하나만으로도 고생할 수 있어서 저도 처음엔 이런저런 문제로 많이 헤맸지만, 이제는 그 과정을 간단하게 풀어보려고 합니다. 이 가이드를 천천히 따라오시면, 비개발자분들도 문제없이 Linux와 Miniconda 환경을 설정할 수 있을 거예요! 🐾

 

 

본 개시물은 아래 블로그에서 이어진답니다~🐦

https://yiheeju.tistory.com/3

실패 없이 Window 환경에서 WSL 2와 VScode 통합하기

 

1. WSL: Ubuntu 터미널 설정을 통한 개발 환경 준비

시작하기에 앞서서 다음과 같이 준비해 주세요. 

VScode를 실행시켜 주신후,  WSL:Ubuntu 환경을 만들어주세요.

상단 왼쪽 부분의 3줄을 클릭하신 후 터미널 > 새 터미널을 눌러주세요.

 

다음과 같이 ubuntu 터미널이 열립니다.

본 과정은 대부분 위의 터미널에서 쭉 실행 될 예정이에요.

 

 

2. Miniconda 설치 과정

먼저 miniconda를 설치해줄거에요.

Miniconda 설치에 대한 자세한 가이드라인이 있는 공식 문서이니 참고하세요.

(참고 사이트 : https://docs.anaconda.com/miniconda/)

 

위의 사이트를 참고하여 각자의 컴퓨터 환경에 맞는 Miniconda를 설치할 수 있습니다. 여기서 우리는 Linux 환경에서 설치를 진행할 것이므로, Linux용 Miniconda 패키지를 설치하는 방법을 다룹니다.

 

1) Miniconda 설치 파일 다운로드

터미널에 다음 명령어를 입력하여 최신 버전의 Miniconda 설치 파일을 다운로드합니다.

wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh 

 

2) 설치 파일 실행 권한 부여

다운로드된 설치 파일에 실행 권한을 부여해줍니다.

chmod +x Miniconda3-latest-Linux-x86_64.sh 

 

3) Miniconda 설치 실행

설치 파일을 실행하여 설치를 시작합니다.

./Miniconda3-latest-Linux-x86_64.sh

 

4) 설치 진행 중 사용자 입력

./Miniconda3-latest-Linux-x86_64.sh를 통해 설치가 시작되면, 터미널에 많은 텍스트가 출력됩니다.

엔터를 누르다보면 주르르륵 출력되는 내용을 따라가면서, 중간에 라이선스 동의 화면이 나옵니다.

여기서 다음과 같이 입력해 주세요!!

Do you accept the license terms? [yes|no]

이 메시지가 나오면 yes라고 입력하여 라이선스에 동의합니다.

 

5) 설치 경로 확인

위와 같이 Miniconda3 will now be installed into this location : 

~~~

설치 경로가 표시되면 Enter를 눌러 기본 경로에 설치합니다.

그러면 위와 같이 다시 무언가들이 주르르르르륵 스쳐지나갈 것 입니다.

 

6) 설치 완료

설치가 계속 진행되며, 설치가 끝나면 마지막으로 다음 메시지가 나타납니다.

 You can undo this by running 'conda init --reverse $SHELL'? [yes|no]라는 문구가 나오면 아래와 같이  yes를 입력하시면 됩니다.

 

그럼 이제 설치 완료가 되었어요!

하지만 여기서 추가적으로 export 명령을 사용하여 Miniconda의 경로를 시스템의 PATH 환경 변수에 추가해주어야합니다.

 

3. PATH 환경 변수 설정 및 버전 확인

1) Miniconda 경로를 시스템 PATH에 추가

Miniconda의 실행 파일을 시스템의 PATH 환경 변수에 추가해줌으로 이를 통해 터미널에서 언제든지 conda 명령을 사용할 수 있게 됩니다.

아래 코드를 터미널에 입력하세요!

echo 'export PATH=$PATH:/home/user/miniconda3/bin' >> ~/.bashrc

 

2) 설정 적용

다음 코드를 터미널에 입력해서 .bashrc 파일을 다시 로드하여 변경 사항을 즉시 반영 해줍니다.

source ~/.bashrc

 

3) 설치 확인

conda 명령어가 제대로 인식되는지 확인하기 위해, 다음 명령어를 실행하여 conda의 버전을 확인해주세요~!

 

conda의 버전이 알맞게 출력되고, Miniconda가 정상적으로 설치 및 인식되었음을 확인할 수 있어요!😆

 

 

3. 확장에서 필요한 확장팩 다운로드받기

마지막으로 마켓플레이스 검색창에서 Python과 jupyter를 검색하고 다운받으세요!

 

위의 과정(3. 확장에서 필요한 확장팩 다운로드받기)을 진행해주시지 않으시면 추후에 코드 실행시 다음과 같이 막힐 수 있습니다!!

---

 

 

 

가상환경 설정해주는 이유와 Miniconda, WSL ubuntu에 대한 간단한 설명은 아래를 참고해주세요👽

Miniconda와 WSL Ubuntu를 활용한 효율적인 개발 환경 구축 방법