플라스크(Flask) | 웹 개발을 위한 파이썬(Python) 가상 환경 설치

최근 플라스크(Flask)를 이용한 웹 개발을 진행하고 있어서 파이썬 가상 환경을 준비했습니다.

파이썬 가상 환경은 다양한 버전의 파이썬을 각각 사용하고 관리할 수 있도록 독립된 환경을 제공해줍니다. 

가상 환경을 사용하면 제 1 가상 환경에서는 2.7 버전을, 제2 가상 환경에서는 3.8, 3.9 버전을 사용할 수 있어 정말 편리합니다!

참고로 저는 macOS와 Windows 모두 사용하고 있지만 개발에 주로 사용하는 것은 macOS입니다.

 

---

가상 환경 생성

먼저 가상 환경을 만들 폴더를 생성합니다. 직접 파일 관리자에서 폴더를 만드셔도 되고, 맥이라면 터미널에서 생성하셔도 무관합니다. 저는project1으로 생성해보겠습니다.

$ mkdir '폴더이름'

저는 간단히 project1 로 설정했습니다. (ex. mkdir project1)

 

 

 

다음은 가상 환경을 만들어야 합니다. python 2.x를 사용하고 계시면 그냥 python, python 3.x를 사용하고 계시면 python3로 입력해주세요. 저 같은 경우 python3을 사용했으며, 가상 환경 이름은 간단하게 제 이름으로 했습니다. :-)

$ python3 -m venv '가상 환경명'

가상 환경명에는 원하는 이름을 적어주세요. 저는 제 이름을 넣어서 만들었습니다. :-) (ex. python3 -m venv yejinvenv)

생성에 성공했다면 위에서 만든 폴더 하위에 '가상 환경명' 이름을 가진 폴더가 생성되었습니다.

 

 

 

현재 폴더 구조는 아래와 같습니다!

tree -d로 확인한 폴더 구조

project1 폴더 하위에 가상 환경 폴더 yejinvenv이 생성된 것을 볼 수 있습니다.

 

 

 

 

 

 

---

가상 환경 활성화

이제 생성한 가상 환경에 진입해봅시다. 가상 환경을 생성한 폴더로 이동한 상태에서 다음 명령어로 진입합니다. (macOS)

$ source '가상 환경명'/bin/activate

 

 

Windows의 경우는 다음과 같습니다.

$ cd '가상 환경명'/Scripts/activate

 

성공적으로 가상 환경에 진입하셨다면 터미널에 (가상 환경명)이 붙어 있는 것을 확인할 수 있습니다. 

 

 

 

 

 

 

---

플라스크 설치

가상 환경에 진입한 상태에서 플라스크를 설치해보겠습니다. 이때는 가상 환경 위에 설치된 것이기 때문에, 가상 환경에서 빠져나오면 설치한 기능을 이용할 수 없습니다. 

$ pip3 install Flask

$ flask --version

위 명령어를 통해 플라스크를 설치해주세요! 

플라스크 설치 완료!

이제 가상 환경에서 플라스크를 사용할 수 있습니다. 

 

 

 

 

 

 

---

플라스크 사용 예제

가상 환경도 활성화했고 플라스크도 설치했으니 이제는 플라스크를 사용하여 웹페이지를 띄워봅시다.

프로젝트 폴더(ex. project1)로 이동한 뒤 app.py 파일을 작성합니다. 터미널에서 직접 작성해도 되고, 에디터로 작성해도 됩니다.

# app.py code
from flask import Flask
app = Flask(__name__)

@app.route('/')
def index():
	return 'Hello, Flask!'

@app.route('/name')
def name():
	return "My name is yejin!"

if __name__ == '__main__':
	app.run(debug=True)

 

app.py를 작성하셨으면 환경변수를 설정해야 합니다.

 

 

$ export FLASK_ENV=development

$ export FLASK_APP=app.py

FLASK_ENV를 development로 설정하는 이유는 개발 서버에 development라고 알리지 않으면 production 환경에서 사용하고 있다며 error를 뱉어냅니다. 따라서 환경변수를 설정하여 개발 환경을 활성화해줍니다.

 

 

$ flask run

이후 실행해주시면 여러 텍스트들과 함께 

Running on '~'가 출력되는 것을 볼 수 있습니다. 이제 해당 링크로 들어가 보시면 

 

 

Hello, Flask!

app.py에 썼던 문자가 출력됩니다! 또한 제 이름을 적어두었던 ~/name 에도 들어가 보면

My name is ~

텍스트가 출력된 걸 확인할 수 있습니다.

 

 

 

 

 

 

---

가상 환경 비활성화

가상 환경에서 개발을 하다 기본 파이썬 환경으로 돌아오기 위해선 가상 환경을 비활성화시켜야 합니다.

$ deactivate

간단한 명령어로 빠져나올 수 있습니다!