Flask로 웹개발: #3 개발 환경 구축 - Flask 설치

 

Flask로 미니 쇼핑몰 프로젝트를 수행하려면 당연하게도 Flask를 설치하고 개발환경을 구축해야 합니다. 이번 포스팅에서는 Flask를 설치하고 기본적인 환경을 설정하는 방법에 대해 자세히 설명하겠습니다.

1. Python 설치

Flask를 설치하기 위해서는 먼저 Python이 설치되어 있어야 합니다. Python이 설치되어 있지 않다면, Python 공식 웹사이트에서 다운로드하여 설치할 수 있습니다. 설치 과정에서 'Add Python to PATH' 옵션을 체크하는 것을 잊지 마세요.

 

2024.04.30 - [파이썬] - Python 기초 강의: #1 환경 구성

Python 기초 강의: #1 환경 구성

 

2. Conda 가상 환경 설정

로컬 환경에서 패키지를 설치하여 환경을 구성한다면 여러분에 다른 프로젝트를 수행할 때 패키지간의 충돌이 발생할 수 있습니다. 가상환경을 통해 프로젝트별로 독립된 패키지 설치 환경을 제공하여 패키지 간의 충돌을 방지합니다. Conda를 사용하여 가상 환경을 설정하려면 다음 단계를 따르세요.

 

virtualenv를 이용하는 방법도 있지만 여기서는 설명하지 않겠습니다.

Conda 가상 환경 생성

conda create --name flask python=3.9.18

 

여기서 flask는 가상 환경의 이름이며, Python 3.9 버전을 사용합니다. 필요에 따라 버전을 변경할 수 있습니다.

가상 환경 활성화

conda activate flask

 

가상 환경이 활성화되면 프롬프트에 (flask)가 추가된 것을 확인할 수 있습니다.

3. Flask 설치

가상 환경이 활성화된 상태에서 Flask를 설치합니다.

conda install flask
# conda install flask=3.0.3 # 제가 설치한 버전입니다. 편의를 위해 버전 정보 없이 설치하셔도 무방합니다.

 

설치가 완료되면 Flask가 제대로 설치되었는지 확인하기 위해 다음 명령어를 실행합니다.

python -m flask --version

 

정상적으로 설치되었다면 Flask의 버전 정보가 출력됩니다.

4. 기본 Flask 애플리케이션 생성

이제 Flask를 사용하여 간단한 웹 애플리케이션을 만들어보겠습니다.

프로젝트 디렉토리 생성

프로젝트 디렉토리는 이전 포스팅에서 생성하였습니다.

 

2024.07.11 - [Flask 웹 서버 만들기] - Flask로 웹개발: #2 프로젝트 개요 - 요구사항

 

cd flask_ecommerce

Flask 애플리케이션 파일 생성

여전히 app.py 파일은 빈 파일일 것입니다. 이제 app.py 파일에 우리의 코드를 추가하여 봅시다. 아래 코드를 추가합니다.

from flask import Flask

app = Flask(__name__)

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

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

애플리케이션 실행

다음 명령어를 실행하여 애플리케이션을 실행합니다.

python app.py

 

브라우저를 열고 http://127.0.0.1:5000에 접속하면 "Hello, Flask!"라는 메시지를 볼 수 있습니다.

5. 추가 패키지 설치

Flask 애플리케이션을 개발하면서 추가로 필요한 패키지들을 설치할 수 있습니다. 예를 들어, 데이터베이스 관리를 위해 Flask-SQLAlchemy 등을 사용할 수 있습니다. 필요한 패키지들은 그때 그때 추가로 설치하도록 하겠습니다.

conda install conda-forge::flask-sqlalchemy

6. environment.yml 파일 생성

프로젝트의 의존성을 관리하기 위해 env.yml(또는 environment.yaml) 파일을 생성합니다. 이 파일에는 프로젝트에서 사용된 모든 패키지와 그 버전이 기록됩니다.

conda env export > env.yml # 설치된 패키지 정보를 env.yaml 파일로 추출

 

이제 env.yml 파일을 다른 개발자와 공유하여 동일한 환경을 설정할 수 있습니다. 다른 개발자는 다음 명령어를 사용하여 환경을 복원할 수 있습니다.

conda env create -f env.yml

 

이 기능은 여러 개발자가 공동 작업을 수행할 때 동일한 환경을 손쉽게 제공할 수 있는 아주 강력한 기능이므로 여러분도 잘 활용해 보시면 좋겠습니다. env.yaml 파일은 직접 추출하지 않고 작성하셔도 무방합니다.

 

앞서 설치하는 과정을 env.yaml로 간단하게 하고싶으시다면 아래의 코드를 참조하세요.

name: flask
dependencies:
  - flask
  - Flask-SQLAlchemy
  - python==3.9.18

결론

Conda를 사용하여 Flask를 설치하고 가상 환경을 설정하는 방법을 알아보았습니다. Conda는 패키지와 환경 관리를 편리하게 해 주기 때문에 인공지능 프로젝트나 웹 개발 프로젝트에서 유용하게 사용할 수 있습니다. 앞으로 Flask의 다양한 기능을 활용하여 기본 뼈대만 있는 우리의 애플리케이션에 살을 붙여보겠습니다.

감사합니다!