[Python] Python Virtual Environment Setting of Anaconda

Anaconda 를 사용할 때 파이썬 가상환경을 구성하는 방법에 대한 기록을 남깁니다.

Anaconda 가상환경 구성하기

Python을 배우거나 데이터를 다루는 일을 하다 보면 다양한 프로젝트마다 다른 패키지와 라이브러리를 사용할 필요가 생깁니다. 이때 가상환경을 사용하면 프로젝트별로 독립적인 환경을 구성할 수 있어 매우 유용합니다. Anaconda는 이러한 가상환경을 쉽게 관리할 수 있는 도구를 제공합니다. 이번 포스트에서는 Anaconda를 이용해 가상환경을 구성하는 방법을 단계별로 자세히 설명하겠습니다.

1. Anaconda 설치하기

먼저, Anaconda를 설치해야 합니다. Anaconda는 공식 웹사이트에서 다운로드할 수 있습니다.

1. Anaconda 공식사이트의 DownLoad Page로 이동합니다.
2. 본인 운영체제에 맞는 설치 프로그램을 다운로드합니다.
3. 설치 프로그램을 실행하고 안내에 따라 설치를 완료합니다.
   

   

   
   

   

   
   

   

   
   

   

   
   

   

   Add Anaconda to my PATH environment variable Checkbox 를 선택하지 않습니다.
   

   

   
   

   

   
   

   

   
   

   

   
   

   

   완료하고 checkbox 를 모두 check 하였다면 아래와 같은 페이지와 광고가 뜹니다.
   

   

   
   

   

   
   

   

   그리고 Anaconda Navigator 창이 나타납니다.
   

   

2. Anaconda 가상환경 만들기

Anaconda 설치가 완료되면, 이제 가상환경을 만들어보겠습니다.

1. Anaconda Navigator 창에서 Powershell Prompt를 클릭하여 엽니다. (Windows에서는 시작 메뉴에서 "Anaconda Powershell Prompt"를 검색하면 됩니다.)
   

2. 먼저 Anaconda 에서 설치한 Python 의 Version 과 기존에 설치되어 있는 python 의 Version 을 확인해 봅니다. (Anaconda Prompt 에서는 현재 활성화된 환경의 이름이 괄호로 표시됩니다. 현재 base 환경임을 알수 있습니다.
   
   기존에 설치된 python version 과 다름을 알 수 있습니다.

   python --version

3. Anaconda 의 가상환경은 Windows 환경의 경우 User Folder 내의 Anaconda3 > envs Folder 에 위치합니다. (Anaconda3 Version 을 설치한 경우일 것입니다. 4 version 이 나온다면... Anaconda4 가 되겠죠? 아마도... ㅎㅎ)
   

4. 다음 명령으롤 사용하여 설치할 수 있는 Python 의 version 을 확인 할 수 있습니다.
   

5. 다음 명령어를 입력하여 새로운 가상환경을 만듭니다:
   

6. 여기서 virtualEnv_3913는 가상환경의 이름입니다. 원하는 이름으로 변경할 수 있습니다.

   conda create --n virtualEnv_3913 conda create --name virtualEnv_3913

7. 가상환경을 만들면서 특정 Python version을 지정하고 싶다면 다음과 같이 입력합니다:이 예제에서는 Python 3.9.13 version을 사용합니다.

   conda create --n virtualEnv_3913 python=3.9.13 conda create --name virtualEnv_3913 python=3.9.13

8. 설치하고 나면 envs Folder 내에 입력한 이름으로 가상환경 폴더가 생성됩니다.
   

3. 가상환경 활성화하기

가상환경을 만든 후에는 활성화해야 합니다.

1. 다음 명령어를 입력하여 가상환경을 활성화합니다:
   

   conda activate virtualEnv_3913

2. 활성화되면 프롬프트가 (virtualEnv_3913)로 바뀝니다. 이제 이 가상환경 내에서 패키지를 설치하고 관리할 수 있습니다.

3. 다음 명령어를 입력하여 Anaconda 에 설치된 가상환경들을 조회해 봅니다:
   

4. 활성화 되어 있는 가상환경에 * 가 표시되어 있습니다.

   conda env list

4. 패키지 설치하기

가상환경이 활성화된 상태에서 필요한 패키지를 설치할 수 있습니다.

1. 예를 들어, requests 패키지를 설치하려면 다음과 같이 입력합니다:
   

   conda install requests

2. 패키지를 최신 버전으로 업데이트하려면:

   conda update requests

3. 다음 명령을 사용하여 설치할 수 있는 requeats package 의 version 을 확인할 수 있습니다.
   

   conda search requests

4. 특정 버전의 패키지를 설치하려면:

   conda install requests=2.28.1

5. Package 가 설치되는 Folder 는 Users\JH.Woo\anaconda3\envs\virtualEnv_3913 Folder 내의 Lib > site-packages Folder 입니다.
   
   기존 Folder 에 request package 와 설치에 필요한 package 들이 추가된 것을 확인할 수 있습니다.
   

5. 추가된 가상환경을 Anaconda Navigator 에서 사용하기

추가된 가상환경을 Anaconda Navigator 에서 추가하여 사용할 수 있습니다.

1. Anaconda Navigator 에서 추가된 가상환경 확인하기Anaconda Navigator 를 열어 상단에 추가된 가상환경을 확인할 수 있습니다.
   

2. 추가된 가상환경에 tool 설치하기추가된 가상환경을 선택하면 사용할 수 있는 tool 들이 표시됩니다.
   base 환경과는 별도로 virtualEnv_3913 환경에 설치해주어야 합니다.
   
   Jupyter notebook 과 Powershell Prompt 도구의 아래 Install button 을 click 하여 설치해 줍니다.
   그럼 기존의 시작메뉴의 Anaconda3 메뉴에
   
   새로 설치한 Jupyter Notebook(virtualEnv_3913) 와 Anaconda PowerShell Prompt(virtualEnv_3913) 메뉴가 추가된 것을 볼 수 있습니다.
   
   Anaconda Navigator 에서 Jupyter Notebook 의 Launch button 을 클릭하여 실행하거나 시작메뉴에서 Jupyter Notebook(virtualEnv_3913) 메뉴를 실행해 줍니다.
   
   

3. Jupyter Notebook 실행하기
   Jupyter Notebook 을 실행하면 Jupyter server 가 실행되고
   
   Local directory를 표시하는 페이지가 나타납니다.
   
   Local directory는 사용자 폴더(Users) 계정 Folder 를 표시합니다. (예: C:/Users/JH.Woo)
   
   

4. Default Path 변경하여 Jupyter Notebook 실행하기
   탐색기와는 다르게 Default Path 의 상위 Folder 로 이동할 수 없기때문에 Programming 의 효율적인 작업을 위해서 Jupyter Notebook 을 실행할 때 Default Path 를 변경해줄 필요가 있습니다.
   특정 Folder 를 Local Directory 로 설정하여 Jupyter Notebook 을 실행하는 방법을 알아보겠습니다.
   이 예제에서는 D:\Python_Labs 라는 폴더를 사용하겠습니다.
   
   자신에게 맞는 폴더를 사용합니다.
   먼저 Powershell Prompt 를 실행합니다.
   
   다음 명령어를 사용하여 Jupyter Notebook 을 실행합니다.

   jupyter notebook d:/Python_Labs    ## \ 가 아닌 / 라는 것에 주의할 것

   
   Jupyter Notebook server 가 실행되며 실행내용을 보면 Local directory 가 d:/Python_Labs 인 것을 볼 수 있습니다.
   그리고 Local Directory 를 표시하는 Page 가 나타납니다.
   
   해당 Page 에서 새 Notebook 을 생성합니다.
   

5. Jupyter Notebook Home Page 를 실수로 꺼버린 경우
   Jupyter Notebook server 창의 내용을 보면 Jupyter Notebook 의 Home page 를 표시한 부분이 있습니다.
   해당 링크를 Ctrl + Click 하거나 Link 를 복사하여 Browser 에서 실행하면 됩니다.
   

6. New Notebook 에 가상환경 추가해주기
   새 Jupyter Notebook 을 추가할 때 가상환경이 표시되지 않고 Python 3(ipykernel)만 표시될 때 다음 명령어를 실행합다.

   ## conda activate [virtualEnv] 
   ## pip install ipykernel 
   ## python -m ipykernel install --user --name=[virtualEnv] --display-name "[virtualEnv]" 
   conda activate virtualEnv_3913 
   pip install ipykernel 
   python -m ipykernel install --user --name=virtualEnv_3913 --display-name "Python (virtualEnv_3913)"

7. New Notebook 에 가상환경 Kernel 제거하기
   다음 명령어를 실행하여 Kernel 목록을 조회하고 원하는 Kernel 을 삭제합니다.
   명령 실행 후 커널은 다음과 같이 표시됩니다.
   

   jupyter kernelspec list 
   ## jupyter kernelspec remove [virtualEnv] 
   jupyter kernelspec remove virtualenv_3124

6. 가상환경 비활성화하기

작업을 마친 후 가상환경을 비활성화하려면 다음 명령어를 사용합니다:

conda deactivate
conda deactivate virtualEnv_3913

비활성화한 후 다음 명령을 실행해보면 활성화된 가상환경이 base로 변경된 것을 확인할 수 있습니다.

conda env list

7. 가상환경 삭제하기

더 이상 필요 없는 가상환경은 삭제할 수 있습니다.

1. 가상환경을 비활성화한 상태에서 다음 명령어를 입력합니다:
   

   conda remove --n virtualEnv_3913 conda remove --name virtualEnv_3913

2. 다음 명령어는 virtualEnv_3913 가상환경과 그 안의 모든 패키지를 삭제합니다.
   가상환경이 envs Folder 에서 삭제된 것을 확인할 수 있습니다.

   conda remove --name virtualEnv_3913 --all

8. 가상환경 목록 확인하기

현재 만들어진 가상환경 목록을 확인하려면 다음 명령어를 사용합니다:

conda env list

결론

이렇게 해서 Anaconda를 이용해 가상환경을 구성하는 방법을 알아보았습니다.
가상환경을 사용하면 프로젝트마다 독립적인 환경을 유지할 수 있어 여러 버전의 패키지를 관리하기에 매우 편리합니다.
Local Directory 를 설정하며 시작하는 과정이 조금은 귀찮은 작업일 수 있습니다. 처음에는 조금 복잡하게 느껴질 수 있지만, 익숙해지면 훨씬 더 효율적으로 작업을 할 수 있을 것입니다. Anaconda 가상환경을 활용해 보세요!

행복한 고수되세요.

WooGong ))*
\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\