이진법을 사용하여 온프레미스 Go 웹 애플리케이션을 AWS Elastic Beanstalk로 마이그레이션

작성자: 수하스 바사바라즈(AWS) 및 슈마즈 무크타르 카지(AWS)

환경: PoC 또는 파일럿	소스: 애플리케이션	대상: Elastic Beanstalk
R 유형: 리호스팅	기술: 마이그레이션, 웹 및 모바일 앱	AWS 서비스: AWS Elastic Beanstalk

요약

이 패턴은 온프레미스 Go 웹 애플리케이션을 AWS Elastic Beanstalk로 마이그레이션하는 방법을 설명합니다. Elastic Beanstalk는 애플리케이션 마이그레이션 후 소스 번들용 이진수를 빌드하여 Amazon Elastic Compute Cloud(Amazon EC2) 인스턴스로 배포합니다.

리호스팅 마이그레이션 전략으로서 이 패턴의 접근 방식은 빠르고 코드 변경이 필요하지 않으므로 테스트 및 마이그레이션 시간이 단축됩니다. 

사전 조건 및 제한 사항

사전 조건 

• 활성 상태의 AWS 계정.

• 온프레미스 Go 웹 애플리케이션.

• Go 애플리케이션의 소스 코드가 들어 있는 GitHub 리포지토리입니다. 사용하지 GitHub 않는 경우 다른 방법으로 Elastic Beanstalk용 애플리케이션 소스 번들을 생성할 수 있습니다.

제품 버전

• Elastic Beanstalk에서 지원하는 가장 최신 Go 버전입니다. 자세한 내용은 Elastic Beanstalk 설명서를 참조하세요.

아키텍처

소스 기술 스택  

• 온프레미스 Go 웹 애플리케이션. 

대상 기술 스택

• AWS Elastic Beanstalk

• 아마존 CloudWatch

대상 아키텍처

도구

• AWS Elastic Beanstalk를 사용하면 애플리케이션을 실행하는 인프라에 대해 자세히 알지 못해도 AWS 클라우드에서 애플리케이션을 신속하게 배포하고 관리할 수 있습니다. Elastic Beanstalk를 사용하면 선택 또는 제어에 대한 제한 없이 관리 복잡성을 줄일 수 있습니다.

• GitHub오픈 소스 분산 버전 제어 시스템입니다.

에픽

Go 웹 애플리케이션 소스 번들 .zip 파일 생성

작업	설명	필요한 기술
Go 애플리케이션의 소스 번들을 생성하세요.	Go 애플리케이션의 소스 코드가 들어 있는 GitHub 리포지토리를 열고 소스 번들을 준비합니다. 소스 번들에는 Go 애플리케이션의 기본 패키지를 호스팅하는 루트 디렉터리의 application.go 소스 파일이 포함되어 있습니다. 사용하지 GitHub 않는 경우 이 패턴 앞부분의 사전 요구 사항 섹션에서 애플리케이션 소스 번들을 생성하는 다른 방법을 확인하세요.	시스템 관리자, 애플리케이션 개발자
구성 파일을 생성합니다.	소스 번들에 .ebextensions 폴더를 생성한 다음 이 폴더 안에 options.config 파일을 생성합니다. 자세한 내용은 Elastic Beanstalk 설명서를 참조하세요.	시스템 관리자, 애플리케이션 개발자
소스 번들 .zip 파일을 생성합니다.	다음 명령을 실행합니다. git archive -o ../godemoapp.zip HEAD 그러면 소스 번들 .zip 파일이 생성됩니다. .zip 파일을 로컬 파일로 다운로드하여 저장합니다. 중요: .zip 파일은 512MB를 초과할 수 없으며 상위 폴더 또는 최상위 디렉터리를 포함할 수 없습니다.	시스템 관리자, 애플리케이션 개발자

Go 웹 애플리케이션을 Elastic Beanstalk로 마이그레이션

작업	설명	필요한 기술
Elastic Beanstalk 애플리케이션을 선택합니다.	AWS Management Console에 로그인하고 Elastic Beanstalk console을 엽니다. 리전 목록에서 해당 AWS 리전을 선택합니다. 탐색 창에서 애플리케이션을 선택한 기존 Elastic Beanstalk 애플리케이션을 선택하거나 애플리케이션을 생성합니다. Elastic Beanstalk 애플리케이션 생성에 관한 지침은 Elastic Beanstalk 설명서를 참조하세요.	시스템 관리자, 애플리케이션 개발자
Elastic Beanstalk 웹 서버 환경을 시작합니다.	애플리케이션 개요 페이지에서 새 환경 생성을 선택한 다음 웹 서버 환경을 선택합니다. 환경 이름 및 도메인 이름 필드를 작성합니다. 플랫폼 버전을 선택하고 Go를 플랫폼으로 선택합니다.	시스템 관리자, 애플리케이션 개발자
소스 번들 .zip 파일을 Elastic Beanstalk에 업로드합니다.	애플리케이션 코드에서 코드 업로드를 선택한 다음 로컬 파일을 선택합니다. 소스 번들이 들어 있는 .zip 파일을 선택합니다. 버전 라벨에서 파일에 고유한 이름을 지정한 다음 환경 생성을 선택합니다.	시스템 관리자, 애플리케이션 개발자
배포된 Go 웹 애플리케이션을 테스트합니다.	Elastic Beanstalk 애플리케이션의 개요 페이지로 리디렉션됩니다. 개요 상단의 환경 ID 옆에서 elasticbeanstalk.com(으)로 끝나는 URL을 선택하여 애플리케이션으로 이동합니다. 애플리케이션은 구성 파일에서 이 이름을 환경 변수로 사용하고 웹 페이지에 표시해야 합니다.	시스템 관리자, 애플리케이션 개발자

문제 해결

문제	Solution
Application Load Balancer를 통해 애플리케이션에 액세스할 수 없습니다.	Elastic Beanstalk 애플리케이션을 포함하는 대상 그룹을 확인합니다. 비정상인 경우 Elastic Beanstalk 인스턴스에 로그인하고 nginx.conf 파일 구성을 확인하여 올바른 상태의 URL로 라우팅되는지 확인하세요. 대상 그룹 상태 확인 URL을 변경해야 할 수도 있습니다.

관련 리소스

• Elastic Beanstalk 지원 플랫폼 버전으로 이동

• Elastic Beanstalk에서 구성 파일 사용

• Elastic Beanstalk에서 예제 애플리케이션 생성