AWS EC2에 Flask 배포하기 (MySQL, FileZilla)

AWS EC2에 Flask 서버를 배포해보았습니다.

쉽지 않았습니다.

(당연함 한번도 안해봄)

 

우선 저에게 주어진 건

ec2-*-**-*-**.ap-northeast-2.compute.amazonaws.com 서버 주소와

ppk 키페어 파일뿐이었습니다.

(콘솔 접근도 못했음,,)

 

aws에서 인스턴스를 생성하고 ~ 이런 부분은 다 넘어가고 

이 상황에서부터 시작해보겠습니다.

 

 

[ 목차 ]

1. ppk to pem

2. aws ec2 서버 접속

3. FileZilla Client 설치

4. FileZilla로 코드 파일 업로드

5. flask 실행

6. port 설정

7. mysql 설치 및 접속

8. mysql 사용자 추가 및 데이터베이스 생성

9. flask에서 mysql 연결

10. 백그라운드 실행

 

** 개발 환경 **

- Mac OS (Intel)

- VS Code

- Python 3.11.7

---

 

먼저 서버에 접속이 되는지 확인을 해봅니다.

엏 근데 ppk 파일은 pem 파일로 변환하는 게 좋습니다.

 

 

<ppk to pem>

puttygen이 필요합니다.

brew install putty

 

설치했다면 다음 명령어로 변환해줍니다.

/Users/keypair.ppk << 각자의 키페어 주소값으로 하시면 됩니다.

puttygen /Users/keypair.ppk -O private-openssh -o /Users/keypair.pem

 

저기서 private-openssh 로 안하면 Permission denied (publickey) 에러만 주구장창 볼 수 있습니다..

그리고 pem 파일의 권한도 400 정도로 맞춰줍니다.

400은 소유자에게 읽기 권한만 허용된 설정입니다.

chmod 400 /Users/keypair.pem

 

 

그리고 이제 변환한 pem을 가지고 서버에 접속해봅니다.

ssh -i /Users/keypair.pem ubuntu@*.**.**.**

 

ubuntu 일수도 있고 ec2-user 일수도 있습니다.

뒤에 주소는 ec2-*-**-*-**.ap-northeast-2.compute.amazonaws.com 서버 주소에서 확인할 수 있는 IPv4 주소입니다.

 

 

pem 파일에 문제가 있거나 ip주소가 틀린게 아니라면 ,, 웬만하면 접속이 될 것 입니다..

ubuntu@ip- 로 시작하는 걸로 로그인되었다면 성공입니다..

`exit` 명령어를 입력하시면 서버 세션을 종료할 수 있습니다.

 

 

다음으로 FileZilla 프로그램을 이용해서 파일을 서버에 올려줍니다.

FileZilla가 없으면 설치를 해야합니다.

https://filezilla-project.org/

 

 

왼쪽에 있는 Client 다운로드로 갑니다.

 

 

저는 macOS(Intel)이니까 바로 Download 를 눌러주고

 

여기서 맨 왼쪽에 있는 FileZilla -> Download 버튼을 눌러 다운받아 줍니다.

이후에는 설치하셔서 I agree -> 기본 Default 설정으로 체크하시면 됩니다.

 

실행하면 아래 사진과 같은 화면이 보이실텐데요,

 

닫기 버튼 아래 있는 사이트 관리자 를 눌러줍니다.

파일 > 사이트 관리자 로 진입하실 수도 있어요.

 

 

새 사이트 를 추가하셔서 작성해주시면 됩니다.

aws ec2 기준 !

 

프로토콜은 SFTP - SSH File Transfer Protocol 

호스트는 서버 접속했던 IP 주소

로그인 유형은 키 파일

사용자는 ubuntu

키 파일은 pem 파일 위치

 

로 설정해주시고 연결 해주시면 됩니다.

그럼 아래 사진처럼 리모트 사이트에 접속된 걸 보..셔야 합니다 !

 

여기에 작업했던 파일들을 넣어줍니다.

드래그앤드랍으로 넣어주실 수 있어요.

 

파일질라는 쉽게 파일 옮겨주는 역할만 하기 때문에 잘 ~ 작동하는 코드 파일 및 필요한 파일(eg. requirements.txt)들을 넣고

실행은 터미널에서 해주어야 합니다.

 

 

 

다 옮겨졌으면 아까 서버에 접속했던 터미널에서 계속 진행하겠습니다.

여기는 python도 설치되어 있지 않은 곳이기 때문에 python 설치부터 해주어야 합니다.

 

sudo apt update

sudo apt install python3-pip

 

 

그리고 필요한 라이브러리도 설치해주시면 됩니다.

저는 requirements.txt 파일에 담아왔기 때문에 해당 파일을 열어 설치하는 명령어를 사용하였습니다.

 

pip install -r requirements.txt

 

 

마무리 되면 python3 (실행파일).py 로 실행해보실 수 있습니다.

만약 옮긴 파일들이 venv가 포함되어 있다면,

cd venv
source bin/activate

가상환경을 실행시키고 설치 및 실행 하시면 되겠습니다.

 

flask 로 실행시킬 수도 있습니다.

export FLASK_APP=(실행파일).py
flask run

 

export 명령어로 실행할 flask app을 지정해주고 flask run으로 실행하면 되는데,

이 때 실행할 파일이 루트 파일(eg. venv)에 있지 않다면, FLASK_APP=(디렉토리).(실행파일).py 로 디렉토리 지정을 정확히 해주어야 합니다..!

 

 

이렇게 실행이 잘 되신다면..

축하드립니다(?)

이제 ip주소:설정한 포트 (예. http://3.33.3.33:5000) 로 접속이 되는지 확인해보셔요.

외부 브라우저에서 해당 ip로 접속이 안되신다면 포트 설정이 필요합니다..

 

터미널에서 현재 사용하고 있는 TCP port 조회를 해봅니다.

netstat -tnl

 

그럼 아래 사진 처럼 열린 포트들이 보이실 텐데 

 

여기에 설정했던 flask port (보통 5000)이 안 보이신다면,, 

방화벽 설정이 필요할 수 있습니다.

저는 ubuntu의 방화벽 (ufw) 으로 설정하였습니다.

sudo ufw enable
sudo ufw allow 5000

 

 

만약에 저기 5000이 있는데도 안된다? 하시면 aws ec2 인스턴스 콘솔에서 설정해주어야 합니다.

저는 콘솔에 접근할 수 없는 상황이라 자세히 적진 못하지만 

인스턴스 > 보안그룹 세부정보 > 인바운드 규칙 항목에서 필요한 포트 정보를 추가해주면 됩니다.

 

 

 

저는 이후에 MySQL이 필요한 상황이 왔습니다...

마찬가지로 저는 콘솔에 접근할 수 없었기에........  RDS를 사용하지 않았습니다. 아니 못했달까...

 

일단 aws에 mysql을 설치해줍니다.

sudo apt install mysql-server

 

 

그리고 mysql에 접속해줍니다.

sudo mysql -u root -p

처음에는 비밀번호가 없는데 사용할 password로 입력해서 들어가면 설정되고

그냥 엔터쳐서 접속 후 use mysql 명령어로 비밀번호를 추후에 변경해주는 방법도 있습니다.

 

mysql에 접속했으면 외부 접속 허용 설정을 해줍니다.

mysqld.cnf 파일을 수정하면 되는데

우선 파일이 있는 디렉토리로 이동해 vi 에디터로 파일을 실행해 수정하면 됩니다.

cd /etc/mysql/mysql.conf.d
vi mysqld.cnf

 

i 키를 눌러 Insert 상태로 변경하고

bind-address를 0.0.0.0으로 수정하고

esc 눌러 읽기 상태로 전환하여

:wq 엔터 눌러 저장하고 종료하면 됩니다.

 

 

어 근데 제가 지금 작성하면서 확인했는데

저는 /etc/mysql/mysql.cnf 파일을 수정했거든요..?

메인 설정파일과 특정 설정 포함 파일 차이인데 정상 동작은 하는 거보니 괜찮은 것 같습니다.

 

 

다음으로 사용자 추가 및 데이터베이스 생성 등의 작업을 해줍니다.

// 사용자 추가 예시
사용자 이름 = manager
호스트 주소 = 3.33.3.33
비밀번호 = admin123

CREATE USER 'manager'@3.33.3.33 IDENTIFIED BY 'admin123';


// 데이터베이스 생성
dbname이라는 데이터베이스
한글 사용할 수 있는 UTF8로 문자열 저장
CREATE DATABASE dbname default CHARACTER SET UTF8;


// 사용자 모든 권한 부여
GRANT ALL PRIVILEGES ON dbname TO 'manager'@3.33.3.33;

 

테이블 생성 관련 설명은 건너뛰겠습니다.

DBeaver 와 같은 GUI 툴을 이용하시면 편리하게 관리할 수 있습니다.

이제 터미널에서 할 수 있는 작업이 모두 진행되었다면 flask에 연결해주는 작업을 해주어야 합니다.

 

 

mysql 라이브러리를 설치해주고

pip install mysql-connector-python

 

 connect 해주는 코드는 다음과 같습니다.

꼭 아래의 형식일 필요는 없고 이런 내용이 필요하구나~ 정도만 봐주시면 되겠습니다.

 

config = {
    'host': 3.33.3.33,
    'port': 3306,
    'user': manager,
    'password': admin123,
    'database': FLASKAPP
}

connection = mysql.connector.connect(**config)

 

user와 password는 mysql에서 추가한 사용자 정보를 기입해주시면 되고,

database는 생성한 database의 name을 기입해주시면 됩니다.

 

 

그리고 DB 로직은 대강 아래와 같이 사용할 수 있습니다.

사용이 끝난 cursor와 connection close는 필수입니다..

cursor = connection.cursor()
cursor.execute('SELECT * FROM table')
result = cursor.fetchall()

 

 

이렇게 했으면 이제 실행을 다시 해봅시다.

아마.. 여기까지 됐으면 실행이 안될 겁니다.. 🥲

 

mysql.connector.errors.OperationalError: MySQL Connection not available.

 

 

먼저 mysql 서버가 aws에서 실행중이긴 한건지 확인해봅니다.

sudo systemctl status mysql

 

active (running) 중이면 실행중입니다.

그럼.. flask 5000번 포트 열어야 하는 것과 같이

mysql의 3306번 포트도 활성화 시켜주어야 합니다.

 

 

위의 포트 설정과 서버 실행 과정을 반복했다면..

이제 정상적으로 실행이 되신다면 !

 

flask run 이나 python3 app.py 이렇게 하면 ctr+c 했을 때 종료되잖아요?

백그라운드에서도 동작할 수 있게 해줍니다.

 

 

nohup 명령어를 사용해 줄건데요 간단합니다.

nohup flask run &

nohup python3 app.py &

nohup 하고 & 붙여주면 백그라운드에서 실행됩니다.

해당 명령어를 입력하면 뭐가 뜨고 빠져나오지 못하는데 그냥 컨트롤 C 해서 나오셔도 됩니다.

 

잘 동작 중인지 확인하려면 

ps -ef 명령어로 실행중인 프로세스를 확인하거나

tail -f nohup.out 명령어로 실시간 로그를 출력해볼 수 있습니다.

 

종료하려면 ps -ef 로 PID 를 확인하여

kill [PID] 하시면 됩니다.

 

 

 

 

 

 

그럼

제가 삽질한 게 도움이 되셨길 바라며.. 

또한 어쩌면 미래의 나에게도 도움이 되리라 믿고..

이만 글을 마치겠습니다.

🫠