[KR] Streamlit 웹 어플리케이션 배포하기 (feat. Heroku)

이번 포스트에서는 Streamlit기반 웹 어플리케이션을 Heroku 에 배포하는 과정을 다루어 보겠습니다.

Streamlit 관련 주제의 포스팅 목록은 아래의 리스트를 참조해주세요.

1. 파이썬 웹어플리케이션 맛보기 (feat. Streamlit)
2. Streamlit 웹 어플리케이션 배포하기 (feat. Heroku)
3. Streamlit 기반 데이터 QC 툴 개발기 (- -현재 작성 중- -)

Streamlit logo from streamlit.io

Streamlit의 주요 기능을 살펴보았던 지난 포스트(파이썬 웹어플리케이션 맛보기)에 이어, 이번 포스트에서는 Streamlit으로 만든 간단한 웹어플리케이션을 Heroku 에 배포하는 과정을 다루어보고자 한다.

사전 준비사항

들어가기에 앞서 2가지 사전 준비 사항이 있다.

사전 준비 1: Streamlit 웹 어플리케이션

튜토리얼을 진행하기에 앞서, Streamlit기반의 아주 아주 간단한 시각화 웹 어플리케이션을 만들어보았다. 로컬에서 작동시킨 웹 어플리케이션은 다음과 같다. 해당 어플리케이션의 코드는 링크 에서 참고 가능하다.

• Main Page: 데이터셋에 대한 설명을 간단히 소개한다.
• Raw Data: 테이블 형태의 데이터셋을 확인할 수 있다.
• Confirmed Map: 1월 22일부터 현재까지 전세계의 확진자 현황을 지도로 시각화한다.

(데이터셋은 Johns Hopkins CSSE의 Github에 제공된 COVID-19 데이터 를 사용하였다.)

사전 준비 2: Heroku

Heroku 는 웹사이트나 어플리케이션을 빌드하고 배포할 수 있는 PaaS이다. 파이썬, 자바, 루비, PHP, Node.js, Go 등 여러 언어를 지원하고 있다. 소규모 어플리케이션이라면 무료로도 배포할 수 있다.

Heroku 가입

Heroku를 통해 배포를 하기 위해서는 우선 계정이 있어야 한다. 아래 링크를 통해 Heroku 계정을 생성하자.

• https://www.heroku.com/

Heroku CLI 설치

계정을 생성하였다면, 현재 개발 환경에 Heroku Command Line Interface를 설치한다. 아래의 링크에는 각자의 OS에 맞추어 Heroku CLI의 설치 가이드가 제공되어 있다.

• https://devcenter.heroku.com/articles/getting-started-with-python#set-up

CLI를 통한 로그인

설치가 완성되었다면, 쉘에서 heroku 커맨드를 사용할 수 있다. 다음 명령어로 Heroku 에 로그인 해보자.

$ heroku login

아래와 같은 결과가 출력되며, 브라우저를 열어 로그인 하도록 한다. Heroku 에 대한 준비작업은 이로서 완료되었다.

배포를 위한 파일 생성하기

Heroku 에 배포를 하기 위해서는 몇 가지 준비사항이 충족되어야 한다.

1. app.py가 위치한 가상환경에서 git init 명령어를 통해 Git Repository를 생성한다.
2. 배포를 위해 필요한 파일들을 생성한다.

파일 #1. requirements.txt

$ pip freeze > requirements.txt

파일 #2. .gitignore

venv
*.pyc
.DS_Store
.env

파일 #3. setup.sh

setup.sh에서는 Streamlit에 대한 config.toml 파일을 생성한다.

mkdir -p ~/.streamlit/
 
echo “\
[server]\n\
headless = true\n\
enableCORS=false\n\
port = $PORT\n\
“ > ~/.streamlit/config.toml

파일 #4. Procfile

Procfile에서는 Heroku 로 하여금 웹어플리케이션을 시작시키기 위해 명령어를 순서대로 실행하도록 한다.

web: sh setup.sh && streamlit run app.py

( Procfile에 대한 자세한 사항은 다음 링크 에서 참조할 수 있다.)

Heroku에 배포하기

배포를 위한 파일이 모두 준비되었다면, 이제 본격적으로 Heroku 에 배포를 할 수 있게 되었다.

1. Heroku App 생성

$ heroku create {your app name}

앞서 Heroku CLI를 생성했을 때와 같은 Heroku 로그인 과정을 거쳐, Heroku App이 생성 되었다.

생성된 App은 Heroku 사이트의 대시보드에서도 다음과 같이 확인이 가능하다.

2. Heroku repository 생성 및 배포

$ git add . 
$ git commit -m 'Init app boilerplate' 
$ git push heroku master

Heroku 는 배포를 위해 Git을 사용하므로, 방식도 같다.

Heroku 의 프로세스 인스턴스를 1개로 제한하는 것을 권장한다. 프로세스가 많을 수록 유료가 될 수 있기 때문에, 무료인 상태에서 계속 사용하고 싶다면, 아래의 명령어를 실행시켜준다.

$ heroku ps:scale web=1

Heroku 배포 확인하기

드디어 배포가 완료되었다! 이제 배포된 웹 어플리케이션을 https://your_app.herokuapp.com 에서 확인할 수 있다. 본 튜토리얼을 위해 배포된 웹 어플리케이션은 https://tuto-covid19-map.herokuapp.com/ 에서 확인할 수 있다.

마무리하며

간단한 과정을 거쳐 웹 어플리케이션을 배포까지 해보았다. AWS와 같은 클라우드에 배포하는 과정은 익숙하지 않았고, 현재 Streamlit이 자체적으로 특정 배포 방식을 권장하고 있지는 않기에, Dash(Plotly에서 개발한 웹어플리케이션 프레임워크)에서 웹어플리케이션을 Heroku에 배포하는 가이드를 적용해 보았다. 큰 어려움 없이 배포를 완료하였기에, 많은 분들도 이 과정을 참고하시어 Streamlit 을 활용한 다양한 프로젝트를 진행할 수 있으리라 생각된다.

코드

• Github

참고자료

• Dash 공식 페이지
• Johns Hopkins CSSE Github Repository
• Mapping the Spread of Coronavirus COVID-19 with python and Plotly by. Babak Fard

본 글은 제 기술 블로그에 포스팅한 글을 옮긴 것입니다. 더욱 다양한 주제와 포스트는 https://lucaseo.github.io/ 를 방문해주세요 !