AWS Elastic Beanstalk 단일 인스턴스 무중단 배포하기

https://d2908q01vomqb2.cloudfront.net/cb4e5208b4cd87268b208e49452ed6e89a68e0b8/2018/02/20/AWS-Elastic-Beanstalk-Logo.png

최근에 staging 환경에서 단일 인스턴스를 두면서도 무중단 배포를 하고 싶었는데,
AWS Elastic Beanstalk을 활용해서 이를 손쉽게 해결할 수 있었습니다. 그래서 저와 같은 고민을 하고 계신 분들을 위해 기록차 이 글을 작성합니다.

AWS Elastic Beanstalk은 vercel과 유사하게 코드만 올리면 인프라 관련 세팅을 매우 손쉽고 빠르게 배포할 수 있도록 도와주는 PaaS(Platform as a Service)입니다.

Elastic Beanstalk을 사용하면 인프라 관리를 신경쓰지 않을 수 있고 비용도 Elastic Beanstalk 기능 자체는 무료이며 S3, EC2 등 웹 애플리케이션을 저장하고 실행하기 위해 생성한 리소스에 대해서만 지불하면 됩니다.
그래서 리소스를 최대한 프리티어로 구성하고 여러 프로젝트에서 아주 유용하게 활용하고 있어요!

환경 구성

ElasticBeanstalk 대시보드에서 환경 추가를 선택하고 원하는 이름과 환경 정보, 도메인 이름을 적절하게 설정해주세요!
저는 test-mokhs로 했습니다

플랫폼 유형 구성

플랫폼 유형을 배포할 애플리케이션 환경에 맞춰서 구성합니다.
저는 Java 웹 애플리케이션(e.g. Spring Boot)을 배포하는 경우에 맞춰 Java로 선택했습니다.

여기서 중요한 건 단일 인스턴스로 유지하면서 무중단 배포를 하기 위해서 사전 설정에서 사용자 지정 구성을 선택해줘야한다는 점입니다.
단일 인스턴스를 선택하면 이후에 추가 배치를 통한 롤링 배포 옵션을 선택하는 섹션이 보이지 않습니다.
고가용성을 선택해서 수정할 수도 있겠지만 일부 옵션들이 원하는 것과 다르게 구성되어 사용자 지정 구성 옵션으로 진행하는 게 편합니다.
어떤 옵션들이 다른 지는 직접 변경해가면서 알아보셔도 좋을 것 같습니다 :)

서비스 액세스 구성

서비스 액세스 구성은 다음과 같이 설정해주세요!
서비스 역할에서는 기존 서비스 역할 사용을 선택하셔도 됩니다.
*여기서 주의할 점은 EC2 키 페어와 EC2 인스턴스 프로파일입니다.
해당 설정을 공백으로 두거나 적절하게 설정해주지 않으면 Elastic Beanstalk에서 IAM Role을 찾지 못해 Elastic Beanstalk 환경이 정상 동작하지 않을 수 있습니다.

EC2 키 페어와 EC2 인스턴스 프로파일 생성 관련해서는 바로 아래서 살펴보겠습니다.

!

Elastic Beanstalk에서 사용할 IAM Role, EC2 키 페어 생성

주의* 위에서 말했다시피 미리 인스턴스 프로파일(IAM Role)과 키 페어를 만들어두지 않으면 Elastic Beanstalk에서 IAM Role을 찾지 못해 Elastic Beanstalk 환경이 정상 동작하지 않을 수 있습니다.

키 페어는 EC2 대시보드에 가서 네트워크 및 보언 > 키 페어 탭에 들어가서 생성해주세요!

인스턴스 프로파일(IAM Role) 생성은 IAM 대시보드에 들어가서 역할 생성을 선택 후 아래 과정을 따라가시면 됩니다!
fyi. 인스턴스 프로파일을 비롯한 IAM 관련 설정은 공식 문서에서 더 자세하게 확인해볼 수 있습니다.
https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/iam-instanceprofile.html

 

서비스 또는 사용 사례를 EC2로 선택하고 아래 3개 권한을 추가해주세요

• AWSElasticBeanstalkMulticontainerDocker
• AWSElasticBeanstalkWebTier
• AWSElasticBeanstalkWorkerTier

검토 단계에서 다음과 같이 구성되어 있으면 완료! 역할 이름도 적절하게 설정해주세요.

네트워크 관련 설정

VPC 설정은 각 환경에 맞게 설정해주시면 됩니다!  저는 가용 영역으로 ap-northeast-2c만 사용하므로 이렇게 구성했어요.

 

RDS도 미리 만들어둔 게 있다면 서브넷을 선택해서 손쉽게 설정할 수 있습니다

 

오토 스케일링 그룹 설정

무중단 배포를 위해 단일 인스턴스가 아닌 밸런싱된 로드를 선택하고 인스턴스 최댓값을 1로 유지합니다. 
이를 선택하지 않으면 무중단 배포 설정을 하기 위한 "추가 배치를 통한 롤링 배포" 옵션이 보이지 않습니다.

로드 밸런서 유형

로드 밸런서로는 Application Load Balancer를 사용합니다.
프로세스와 리스너는 본인의 애플리케이션 설정에 맞게 맞춰주세요!

e.g. 저는 8080 port에 서버 애플리케이션을 띄우고 health check path는 /health로 설정했습니다.
fyi. health check path에 맞는 api도 개발이 필요합니다.
관련해서 자세한 내용은 Application Load Balancer에 대해서 찾아보는 걸 추천합니다.

샘플 애플리케이션으로 먼저 배포가 잘 되는지 테스트하고 싶은 경우는 기본 설정 그대로 배포해서 테스트 후 코드를 교체하는 걸 추천드려요!
fyi. Elastic Beanstalk은 배포가 완료된 이후에도 로드 밸런서를 비롯한 일부 구성을 자유롭게 변경할 수 있습니다

롤링 업데이트 및 배포 설정

*이후 롤링 업데이트 및 배포 섹션에서 배포 정책을 '추가 배치를 사용한 롤링'으로 설정합니다.
fyi. 단일 인스턴스로 인프라를 구성했으므로 추가 배치를 사용한 롤링 배포 정책을 활용해야 무중단 배포를 할 수 있어요!

 

이후 검토 과정을 거쳐 ElasticBeanstalk이 정상적으로 배포되는 걸 확인한 후
코드 업로드를 통해 여러 환경 버전을 배포해보며 무중단으로 배포되는 걸 확인해보세요!