📚 서론

spring boot 프로젝트를 ec2 에 올려 mysql 을 사용하고자 한다. 그런데 로컬에선 다 돌아가는데 ec2에 클론하니 테스트코드도 말썽이고 빌드도 안된다. 대체 뭐가 문제인지 찾다 RDS 를 활용해보려고 한다.

현 상황은 로컬에서 MySQL 을 사용하고 싶으나 버전관리 등의 용이함으로 인해 Docker mysql image 를 받아 사용하고 있다. 이를 spring boot 에 연동하여 프로젝트를 로컬상에서 MySQL 을 사용할 수 있도록 했다. 그런데 이걸 ec2 에 올린다면?

ec2 에 ssh 로 접속후 spring boot 프로젝트를 클론했다.
그럼 ec2 인스턴스에는 MySQL 이 있을까? 없다. 로컬에서도 docker compose 를 통해 MySQL 이 돌아가고 있어야 테스트코드든 빌드든 돌아간다.

그렇다면 ec2 에 docker 를 설치하고 docker-compose 파일을 수정해서 ec2 상에서 docker-compose 파일을 실행하여 MySQL image 를 받고 database 를 생성하여 사용해야 할 것 같은데.. RDS 를 쓰면 굳이 이 과정이 필요없을것 같아서 써보려고 한다.

📘 RDS

📗 RDS 생성

1. 엔진 옵션에서 MySQL 선택
   

2. 템플릿에서 프리티어 선택 (이건 프로덕션으로 해도 될것같은데 일단 동작하는 것을 확인하는게 최우선이다.)
   

3. 설정에서 DB 인스턴스 식별자와 자격증명을 설정한다.
   DB 인스턴스 식별자는 인스턴스가 생성되었을 때 목록에 표시될 이름이다.
   마스터 사용자 이름은 DB 접속시 필요한 username, 마스터 암호는 DB 접속에 필요한 비밀번호를 의미하며 프로젝트에서 MySQL 사용시 사용하던 사항을 그대로 입력했다.
   

4. 인스턴스 구성은 t2.micro (지금 사용중인 계정은 프리티어가 아니다.)
   

5. 스토리지는 그대로 유지
   

6. 연결은 기존 EC2 컴퓨팅 리소스에 연결하고 해당 EC2 인스턴스를 선택했다.
   
   db 서브넷 그룹도 기존 항목을 선택했다.
   
   rds 생성을 테스트해본다고 만들었다가 삭제했었는데 RDS 데이터베이스를 만들때마다 새 VPC 보안그룹이 생성되는 것 같다. 자동 백업기간때문에 DB 인스턴스 가 삭제가 안되고 있어서 기존 보안그룹 역시 삭제가 안되고 있다. 일주일로 기한을 설정했었으니 다음주 중에 삭제를 다시 시도해봐야겠다.
   

7. 데이터베이스 인증은 암호 인증으로

8. 추가구성에서 백업 보존 기간은 1일로 설정했으나 자유로이 설정해도 되는 것 같다.

9. 월별 추정 요금
   이정도 사양이 월 약 27000원 정도
   

무슨 팝업이 뜨는데 그대로 닫아줬다.

어느정도 생성하는데 시간이 소요되었다.

RDS 생성완료

📗 RDS 접속

TMI인데 사실 어느정도까지 보안에 있어 감춰야 하는지 몰라서 애매한건 다 가리고 있다.

생성된 RDS 를 클릭해서 연결 & 보안을 보면 엔드포인트를 확인할 수 있는데 이게 DB 접속 경로이고 포트가 DB 접속 포트가 된다.

기존에 로컬에서 localhost:3306 으로 접속했다면 이제 엔드포인트값:3306 으로 RDS 에 접속할 수 있다.

.. 그러나 접속할 수 없었다.

어째서인가 하고 ec2 에 직접 접속해서

sudo yum install mysql

mysql 을 설치하고

mysql -u 계정 -p -h host주소

직접 접속해봤는데 이건 가능했다.

생각해보니 퍼블릭 엑세스 불가능으로 해서 접속이 불가능한가 싶어서 설정에서 퍼블릭 엑세스 가능으로 수정후 다시 RDS 접속을 시도했다.

여전히 인텔리제이에서 db 접속 시도시 dbms: mysql (no ver.) case sensitivity: plain=mixed, delimited=exact%0d%0a operation timed out. 오류가 떠서 피눈물을 흘리던 도중 rds 의 보안그룹 2개중 하단의 보안그룹에서

보안그룹 이름이 ec2-rds-2 로 되어 있는 보안그룹에 인바운드 규칙이 하나도 설정되어 있지 않았고 나머지 rds-ec2-2 의 보안그룹 ID 를 복사해서

인바운드 규칙 편집에 들어가 유형은 MySQL 로, 하나는 내 IP, 하나는 복사한 rds-ec2-2 의 보안그룹 ID 를 선택해서 추가했다.

IntelliJ 에서 RDS 의 MySQL 과 연결하기 성공

참고하고 있는 서적 [스프링 부트와 AWS로 혼자 구현하는 웹 서비스] 에서 볼때 RDS 를 생성시 이미 데이터베이스명을 지정했었다고 한다. (MariaDB)

다른 블로그에서도 MariaDB 선택시 추가 구성에서 초기 데이터베이스 이름을 선택하는 창이 있던 것 같다.

나의 경우 MySQL 을 선택했는데 데이터베이스 이름 지정하는건 없었다. 즉, 데이터베이스가 생성되어 있지 않던 현 상황이 올바른 상황임을 인지했다.

📗 EC2 프로젝트 배포 테스트

📕 [error] 8080 port was already in use

자주 발생하길래 정리한다.

lsof -i tcp:8080

lsof : list open files, 현재 시스템에서 열린 파일 및 네트워크 연결에 대한 정보를 표시하는 명령어
-i : 네트워크 연결을 필터링하는 옵션
=> tcp 프로토콜을 사용하는 포트 8080에 대한 연결을 필터링해달라는 명령어이다.

sudo kill -9 23768

-9 : kill 명령어에 전달되는 옵션으로 프로세스를 강제로 종료하는 시그널을 지정한다. 9 는 SIGKILL 시그널을 나타내며 이 시그널은 프로세스를 무조건적으로 종료시키는 가장 강력한 시그널이다.

📕 plain jar 생성 방지

• plain archive
  -plain 이 붙은 jar 파일
  모든 의존성을 포함하지 않고 작성된 소스코드의 클래스 파일과 리소스 파일만 포함
  프로젝트와 관련된(의존하는) 라이브러리를 포함하지 않는다.
  java -jar *.jar 명령을 했을때 어떤 jar 파일을 실행시켜야 할 지 헷갈릴 수 있다.

  -jar : jar 파일을 실행하고자 할 때 사용, 해당 jar 파일을 지정하여 실행
  *.jar : 현재 디렉토리에 있는 확장자가 .jar 인 모든 파일

서버 실행 명령어

java -jar *.jar

• executable archive
  -plain 키워드가 없는 jar 파일
  어플리케이션 실행에 필요한 모든 의존상을 함께 빌드

이제 -plain.jar 파일이 생성되지 않는다.

여전히 ec2 에서 빌드시 테스트코드 실행에서 막힌다. 또한 테스트코드가 실패했다고 떠도 build - libs 디렉토리에 jar 파일이 생성되어 이를 실행하려 했는데 이것도 실패가 뜬다. 아마도 application.yml 파일에서 mysql 설정의 url 에서 localhost 로 되어 있는데 이 host 를 ec2 의 엔드포인트로 바꿔줘야 실행이 되지 않을까 싶다.

📕 운영환경에 따른 다른 application.yml 파일 적용하기 (수정중)

local 에 있을때, ec2 에 있을때 운영환경을 확인하고 알아서 그에 따른 yml 파일을 실행시킬 수 있도록 하는 방법을 찾아보고 있다.

테스트코드는 안돌아가는데 서버는 돌아가게 되었다.

spring boot 2.4 이후 profile 이란 것에 변경사항이 있었다.

profile?
profile 이란 스프링의 각 컴포넌트들의 설정에 필요한 환경 변수 값들을 모아놓은 파일이다.

edit configuration 에서 기본 profile 을 dev 로 설정한다.

📕 테스트 코드가 ec2에서 돌아가지 않는 문제 해결

확인해보니 test - resources - application.yml 이 수정되질 않아서 application.yml 안에 database url 도 localhost 로 나타나지 않고 rds 의 엔드포인트로 수정해줘야 했다.

수정사항 :

결과
이전에 테스트가 모두 실패하던게 다시 Ec2 에 배포하니

배포가 성공하는 것을 알 수 있다. 👍

📓 결론

AWS 에서 RDS 를 사용하기까지의 과정을 돌이켜보면 다음과 같은 과정을 걸쳐 진행했다.

VPC 생성 - EC2 생성 - 보안그룹, 탄력적IP 설정 - springboot 프로젝트 생성 - RDS 생성시 EC2 인스턴스와 연동 - RDS 엔드포인트, 탄력적 IP 확보 - EC2 ssh 접근 - EC2 내부에 springboot 프로젝트와 맞는 java 설치, timezone 설정, hostname 설정 - EC2 내부에 github / gitlab 프로젝트 클론 (셸스크립트 적용예정) - EC2 내부에 MySQL 설치 및 접속하여(탄력적 IP, EC2 에서 키 페어 생성, RDS 의 엔드포인트 필요) 데이터베이스 생성 - RDS 퍼블릭 설정 - 외부에서 RDS 엔드포인트 및 username, pw 를 통해 RDS 의 MySQL DB 접근 (IntelliJ database, MySQL workbench database 연동)

운영환경에 따라 application.yml 이 다르게 동작하는것과 로컬에서처럼 EC2 내에서 빌드시 테스트코드가 성공하도록 하는 것까지 확인되면 배포까지의 셸 스크립트 자동화 작업을 하고 추후 GitLAB 에 pipline 설정을 통해 프로젝트에서 push 만 하면 테스트 점검, 빌드 및 배포까지 일련의 과정 CI/CD 작업까지 하는 것이 목표다.

이전 리눅스 명령어를 사용할때 어떤 동작을하려면 어떤 명령어가 필요한지 찾아보고 그대로 입력만 했다면 최근엔 명령어의 어떤 옵션이 어떤 동작을 하는지까지 확인해보니 더 이해가 잘 되고 있다. 갑작스럽지만 전에 일하던 곳에서 멘토로 많은 조언을 해주셨던 분들께 정말 감사한 마음이 든다. 하나라도 모른 채 그냥 넘어가지 말고 확실히 알아가는 습관을 들이고자 노력 중이다.