[배포 및 인프라] 해보자 배포 [2] - EC2에서 스프링 애플리케이션 띄우기

 

 

 

 

이번 글에서는 이전 글에서 생성한 EC2에 스프링 애플리케이션을 띄워보도록 하겠습니다.

이때 스프링 애플리케이션은 자신의 아무런 스프링 애플리케이션이나 상관없습니다.

(단 maven이 아닌 gradle을 대상으로 진행합니다)

 

 

 

 

 

 

🧐 깃허브 레포지토리에 프로젝트 올리기

이미 깃허브에 프로젝트를 올려두셨다면 해당 과정은 건너뛰어도 상관없습니다.

 

저는 레포지토리를 하나 생성해서 다음과 같이 예제 애플리케이션을 올려두었습니다.

 

 

 

 

 

이제 해당 프로젝트를 clone받을 수 있도록, code 버튼을 누른 뒤 주소를 복사합니다.

 

 

 

 

 

 

 

 

 

 

 

 

🧐 EC2 에서 프로젝트 clone받기

이전 글에서도 다루었지만 다음과 같이 입력하여 접속할 수 있습니다.

ssh -i [키페어] ubuntu@[퍼블릭 IPv4 주소]

ssh -i mallang-key-pair.pem ubuntu@123.456.788.123

 

다음과 같이 뜨면 됩니다.

 

 

 

이제 위에서 깃허브 레포지토리에 올린 프로젝트를 clone 받도록 하겠습니다.

다음과 같이 입력해주세요

git clone [위에서 복사한 깃허브 레포지토리 주소]

git clone https://github.com/shin-mallang/bapo-test.git

그러면 다음과 같이 인증을 하라는 메세지가 나올 텐데요, 아마 아이디와 비밀번호를 입력하면 다음과 같이 오류가 발생할 것입니다.

 

 

 

이를 해결하는 방법은 아래와 같습니다.

깃허브 우측 상단의 자신의 프로필을 클릭한 뒤, Settings를 클릭합니다.

 

 

 

 

 

좌측 중하단의 Developer settings를 클릭합니다.

 

 

 

 

 

 

Personal access tokens의 Tokens (classic) 을 클릭합니다.

 

 

 

 

 

Generate new token -> Generate new token (classic)을 클릭합니다.

(저는 이미 사용중인게 있어서 delete 버튼이 뜨는데, 설정하신 적이 없다면 없는게 정상입니다.)

 

 

 

 

 

저는 다음과 같이 설정해 주었습니다.

Note는 적당히 맘대로 지어주었고, Expiration은 No expiration으로 설정했습니다.

 

필수적인 부분은 repo와 admin:repo_hook에 대한 권한이고, 나머지 부분은 뭔가 필요할 수도 있을 거 같아서 몇개 설정해 보았습니다.

(admin:repo_hook은 이후 젠킨스로 CI/CD를 설정할 때 필요합니다.)

다 설정했으면 Generate token을 클릭합니다.

 

 

 

 

 

생성된 토큰을 복사해서, 어딘가에 기록해두세요.

(남들에게 노출되면 안됩니다. 큰일납니다.)

(나중에 Jenkins로 CI/CD 설정할 때 또 귀찮게 생성하는 일이 없으려면 지금 잘 기록해두세요)

 

 

 

 

 

 

이제 다시 EC2로 돌아가서 PASSWORD 입력 부분에 복사한 토큰을 입력해주면 인증에 성공합니다.

 

 

 

 

 

이후 clone한 프로젝트 폴더로 이동해주세요

 

 

 

 

 

이제 다음 명령어를 통해 빌드를 한번 해보겠습니다.

./gradlew build

위와 같이 에러가 뜨면 정상입니다.

이는 아직 EC2 서버에 자바를 설치하지 않아서 발생한 문제입니다.

 

 

 

 

 

 

 

 

 

 

 

 

 

🧐 EC2 에 자바 설치하기

자바는 다음과 같은 명령어로 설치할 수 있습니다.

(참고 - https://docs.aws.amazon.com/corretto/latest/corretto-11-ug/generic-linux-install.html)

 wget -O- https://apt.corretto.aws/corretto.key | sudo apt-key add - 
 sudo add-apt-repository 'deb https://apt.corretto.aws stable main'
 
 sudo apt-get update; sudo apt-get install -y java-11-amazon-corretto-jdk

 

 

📕 11버전 말고, 다른 버전이 필요한 경우

11 버전이 아닌 다른 버전이 필요하다면, 다음을 참고해주세요 - https://docs.aws.amazon.com/corretto/index.html

 

 예를 들어 17버전의 경우 다음과 같이 설치할 수 있습니다.

 

 

 

 

 

자바를 설치했으면, java -version 명령어를 통해서 확인할 수 있습니다.

 

이제 다시 프로젝트를 빌드해보도록 하겠습니다.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

🧐 EC2 에서 스프링 프로젝트 빌드하고 실행하기

다음 명령어를 통해 빌드를 진행할 수 있습니다.

./gradlew build

빌드가 끝나면 jar 파일이 build/libs 디렉토리 내부에 생성되게 되는데요, 이동해서 확인해보도록 하겠습니다.

 

 

 

 

 

 

 

 

참고: plain jar과 그냥 jar의 차이

간단하게 plain jar은 애플리케이션 실행에 필요한 모든 의존성을 포함하지 않고, 작성된 소스코드의 클래스 파일과 리소스 파일만을 포함합니다.

plain이 없는 jar은 Executable Jar로써, 코드 실행에 필요한 모든 의존성이 포함되어 있습니다.
Executable Jar 관련한 키워드로 검색하면 더 많은 정보를 얻을 수 있습니다.

이렇게 해서 jar 파일이 생성된 것을 확인했고, 이제 해당 JAR 파일을 실행하도록 하겠습니다.

 

 

 

 

 

 

 

 

 

다음과 같은 명령어로 jar 파일을 실행할 수 있습니다.

nohup java -jar [생성된 JAR 파일] &

nohup java -jar jwp-shopping-order.jar &

nohup은 터미널이 종료될때 발생하는 시그널인 SIGHUP를 블락하여, 터미널이 종료되더라도 계속해서 애플리케이션을 실행할 수 있도록 해줍니다.

 

&는 백그라운드로 프로젝트를 실행하는 명령어입니다.

 

이들에 대해 궁금하다면 직접 nohup을 빼거나 &를 빼가면서 어떻게 달라지는지 확인하시면 좋을 것 같습니다.

참고: 
[시스템 프로그래밍] 프로세스 [0] - 제어 흐름과 예외 상황
[시스템 프로그래밍] 프로세스 [1] - 프로세스
[시스템 프로그래밍] 프로세스 [2] - 프로세스의 제어
[시스템 프로그래밍] 프로세스 [3] - 시그널

 

 

 

 

 

 

 

 

nohup을 사용하면 nohup.out 파일이 생성되는데요, cat nohup.out 명령어를 통해 애플리케이션 실행 로그를 확인할 수 있습니다.

 

 

 

 

 

 

 

 

 

 

 

🧐 실행한 애플리케이션에 요청 보내기

저는 다음과 같은 코드를 하나 작성해 두었습니다.

@Controller
public class MemberViewController {

    private final MemberDao memberDao;

    public MemberViewController(MemberDao memberDao) {
        this.memberDao = memberDao;
    }

    @GetMapping("/settings")
    public String members(Model model) {
        model.addAttribute("members", memberDao.getAllMembers());
        return "settings";
    }
}

 

/settings URI로 이동하여 화면을 잘 보여주는지 확인해 보도록 하겠습니다.

 

 

 

 

 

우선 8080 포트를 사용한다는 가정 하에, 서버의 ip 주소는 EC2 인스턴스 정보에서 확인할 수 있습니다.

퍼블릭 IPv4 주소에 123.456.789.123 이라 나와있다고 가정하겠습니다.

 

그러면 다음과 같은 url로 접근할 수 있습니다.

http://123.456.789.123:8080/settings

 

 

 

 

 

 

그런데, 막상 해보시면 위와 같이 연결에 실패할 것입니다.

그 이유는 외부 TCP 요청을 보낼 때 8080 포트로 들어오는 요청을 허용하지 않았기 때문인데요, 이제 이를 해결해 보도록 하겠습니다.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

🧐 EC2 인스턴스 인바운드 규칙 편집하기

다시 사용중인 EC2 정보화면으로 돌아와서, 보안을 클릭합니다.

 

 

 

 

 

 

 

보안 그룹을 클릭합니다.

 

 

 

 

 

 

 

인바운드 규칙 편집을 클릭합니다.

 

 

 

 

 

 

 

 

규칙 추가 - 사용자 지정 TCP - 8080 포트 - 내 IP를 선택하고 규칙을 저장합니다.

(만약 모든 곳에서 배포한 서버에 접근이 가능하게 만들고 싶으면 Anywhere IPv4를 선택해주면 되고,

특정 프론트엔드 서버에서만 접근을 허용할 것이다! 라고 한다면 사용자 지정 - 프론트엔드 서버의 IP를 입력해주시면 됩니다.)

 

 

 

 

 

 

 

 

이제 접속할 수 없었던 url로 다시 접근을 시도해 보겠습니다.

http://퍼블릭 IPv4 주소:8080/URI

성공한 것을 확인할 수 있습니다!

 

 

 

 

 

이렇게 해서 생성한 EC2 서버에서 손수 스프링 애플리케이션을 배포하는 과정을 진행해 보았습니다.

 

마지막으로 애플리케이션을 종료하는 방법을 간단하게 알아보고 이번 포스팅을 끝내도록 하겠습니다.

 

 

 

 

 

 

 

 

 

 

 

 

 

🧐 스프링 애플리케이션 종료하기

우선 ps 명령어를 통해 어떤 프로세스들이 작동중인지 확인해 보겠습니다.

 

위와 같이 java 애플리케이션이 돌고있는 것을 확인할 수 있는데요, 해당 프로세스의 PID가 3560이라는 것을 알 수 있습니다.

간단하게는 kill -9 3560 혹은 kill -2 3560을 통해서 해당 애플리케이션을 종료할 수 있습니다.

 

 

 

 

혹은 포트 번호를 통해 PID를 찾아서 종료하는 방법이 있는데요, 다음과 같습니다.

lsof -i :포트번호 -t | xargs kill -15(혹은 -2 혹은 -9)

 

 

예를 들어 8080 포트를 사용하는 프로세스를 종료하기 위해서는 다음과 같이 작성할 수 있습니다.

lsof -i :8080 -t | xargs kill -15