AWS Elastic Beanstalk 초기화 방법 | EB CLI 설치부터 배포 준비까지

AWS Elastic Beanstalk 환경 초기화 완벽 가이드. AWS CLI 설치, IAM 권한 설정, EB CLI 사용법을 단계별로 설명합니다. Django 프로젝트 배포를 준비하는 개발자를 위한 필수 가이드 (2025년 최신)

AWS Elastic Beanstalk(EB) 환경 초기화는 Django 프로젝트를 AWS 클라우드에 배포하기 위한 첫 번째 필수 단계입니다. 이 가이드에서는 AWS CLI 설치부터 EB CLI 설정, eb init 실행까지 모든 과정을 초보자도 따라할 수 있도록 단계별로 설명합니다. EB 초기화를 완료하면 실제 환경 생성과 배포 단계로 넘어갈 수 있습니다.

AWS 계정 및 권한 준비

AWS 계정 생성

먼저 AWS 계정이 필요합니다. 아직 계정이 없다면 AWS 홈페이지에서 가입하세요.

프리티어 혜택:

12개월간 t2.micro 또는 t3.micro 인스턴스 무료 (월 750시간)
많은 AWS 서비스를 무료로 체험 가능

IAM 사용자 생성 및 권한 설정

보안을 위해 루트 계정 대신 IAM 사용자를 생성하는 것이 권장됩니다.

필요한 권한:

AWSElasticBeanstalkFullAccess - EB 환경 관리
AmazonEC2FullAccess - EC2 인스턴스 관리
AmazonS3FullAccess - 애플리케이션 버전 저장

IAM 사용자 생성 단계:

AWS 콘솔에서 IAM 서비스로 이동
좌측 메뉴에서 "사용자" 클릭
"사용자 추가" 버튼 클릭
사용자 이름 입력 (예: eb-deployer)
"프로그래밍 방식 액세스" 선택
다음 단계에서 위의 권한 정책 연결
사용자 생성 완료 후 Access Key ID와 Secret Access Key 다운로드

⚠️ 중요: Access Key는 다시 확인할 수 없으므로 안전한 곳에 보관하세요.

AWS CLI 설치와 설정

AWS CLI 설치

# pip을 사용한 설치
pip install awscli

# 설치 확인
aws --version

예상 출력:

aws-cli/2.x.x Python/3.x.x Linux/5.x.x

AWS 자격증명 설정

AWS CLI를 통해 AWS 서비스에 접근하려면 자격증명을 설정해야 합니다.

# EB 전용 프로필로 설정
aws configure --profile eb-cli

대화형 프롬프트 입력:

AWS Access Key ID [None]: AKIA************    # IAM 사용자의 Access Key
AWS Secret Access Key [None]: ****************  # IAM 사용자의 Secret Key
Default region name [None]: ap-northeast-2     # 서울 리전
Default output format [None]: json              # 출력 형식

💡 Tip: --profile eb-cli 옵션으로 별도 프로필을 만들면 여러 AWS 계정을 관리하기 편리합니다.

자격증명 확인

설정이 제대로 되었는지 확인해봅시다:

# 자격증명 파일 확인
cat ~/.aws/credentials

예상 출력:

[eb-cli]
aws_access_key_id = AKIA************
aws_secret_access_key = ****************

AWS 연결 테스트:

aws sts get-caller-identity --profile eb-cli

성공 시 출력:

{
    "UserId": "AIDA************",
    "Account": "123456789012",
    "Arn": "arn:aws:iam::123456789012:user/eb-deployer"
}

EB CLI 설치하기

EB CLI 설치

pip install awsebcli

# 설치 확인
eb --version

예상 출력:

EB CLI 3.20.10 (Python 3.11.5)

가상환경 사용 (권장)

프로젝트별로 독립적인 환경을 유지하려면 가상환경을 사용하세요:

# 가상환경 생성
python -m venv venv

# 가상환경 활성화
source venv/bin/activate  # Linux/Mac
# 또는
venv\Scripts\activate     # Windows

# EB CLI 설치
pip install awsebcli

EB 애플리케이션 초기화

프로젝트 디렉토리로 이동

cd /path/to/your/django-project

eb init 실행

eb init --profile eb-cli

대화형 설정 과정

EB CLI가 여러 질문을 하는데, 하나씩 살펴보겠습니다.

1단계: 리전 선택

Select a default region
1) us-east-1 : US East (N. Virginia)
2) us-west-1 : US West (N. California)
...
10) ap-northeast-2 : Asia Pacific (Seoul)
...
(default is 3): 10

✅ 서울 리전을 사용하려면 10을 입력하세요.

💡 Tip: 사용자가 주로 있는 지역과 가까운 리전을 선택하면 응답 속도가 빨라집니다.

2단계: 애플리케이션 이름 입력

Enter Application Name
(default is "django-project"): django-bootstrap

원하는 애플리케이션 이름을 입력하거나 엔터를 눌러 기본값을 사용하세요.

⚠️ 주의: 애플리케이션 이름은 AWS 계정 내에서 고유해야 합니다.

3단계: 플랫폼 선택

Select a platform.
1) .NET Core on Linux
2) Docker
3) Go
4) Java
5) Node.js
6) PHP
7) Packer
8) Python
9) Ruby
10) Tomcat
(default is 1): 8

✅ Django는 Python이므로 8을 입력하세요.

4단계: 플랫폼 브랜치 선택

Select a platform branch.
1) Python 3.11 running on 64bit Amazon Linux 2023
2) Python 3.12 running on 64bit Amazon Linux 2023
3) Python 3.9 running on 64bit Amazon Linux 2
(default is 1): 2

✅ 최신 Python 버전을 선택하는 것이 좋습니다. 2 (Python 3.12) 선택

💡 Tip: 로컬 개발 환경의 Python 버전과 가능한 맞추는 것이 좋습니다.

5단계: CodeCommit 사용 여부

Do you wish to continue with CodeCommit? (Y/n): n

✅ 대부분의 경우 n을 입력합니다. (Git을 이미 사용 중이라면 불필요)

6단계: SSH 설정

Do you want to set up SSH for your instances?
(Y/n): y

✅ y를 입력하세요. SSH 접속은 디버깅할 때 매우 유용합니다.

7단계: SSH 키페어 선택

Select a keypair.
1) my-keypair
2) [ Create new KeyPair ]
(default is 1): 2

새로운 키페어를 만들거나 기존 키페어를 선택하세요.

새 키페어 생성 시:

Type a keypair name: eb-django-keypair

초기화 완료

모든 설정이 끝나면 다음과 같은 메시지가 표시됩니다:

Application django-bootstrap has been created.

초기화 확인하기

생성된 파일 확인

eb init 실행 후 프로젝트에 다음 디렉토리와 파일이 생성됩니다:

.elasticbeanstalk/
└── config.yml          # EB 설정 파일

config.yml 내용 살펴보기

branch-defaults:
  main:
    environment: null
global:
  application_name: django-bootstrap
  default_platform: Python 3.12 running on 64bit Amazon Linux 2023
  default_region: ap-northeast-2
  profile: eb-cli
  sc: git
  workspace_type: Application

주요 설정 설명:

application_name: EB 애플리케이션 이름
default_platform: 사용할 Python 플랫폼
default_region: 배포 리전 (서울)
profile: 사용할 AWS 프로필 (eb-cli)

EB CLI 상태 확인

eb list --profile eb-cli

예상 출력:

No environments found for application "django-bootstrap".

✅ 이것은 정상입니다! 환경은 다음 단계인 eb create에서 만듭니다.

AWS 콘솔에서 확인

AWS Elastic Beanstalk 콘솔 접속
리전이 ap-northeast-2 (서울)로 설정되어 있는지 확인
애플리케이션 목록에 방금 만든 애플리케이션이 표시됩니다

문제 해결 가이드

EB CLI 설치 오류

증상: pip install awsebcli 실행 시 의존성 오류

해결방법:

# pip 업그레이드
pip install --upgrade pip

# 다시 설치
pip install awsebcli

자격증명을 찾을 수 없음

증상: eb init 실행 시 "Unable to locate credentials" 오류

해결방법:

# 자격증명 파일 확인
cat ~/.aws/credentials

# 프로필 지정해서 다시 실행
eb init --profile eb-cli

프로필 관련 오류

증상: 여러 AWS 계정을 사용할 때 혼동

해결방법:

# 모든 EB 명령에 --profile 옵션 추가
eb list --profile eb-cli
eb status --profile eb-cli

# 또는 환경 변수로 기본 프로필 설정
export AWS_EB_PROFILE=eb-cli

플랫폼 버전 오류

증상: 원하는 Python 버전이 목록에 없음

해결방법:

# 사용 가능한 플랫폼 확인
eb platform list

# 특정 플랫폼 명시
eb init --platform "Python 3.12 running on 64bit Amazon Linux 2023"

다음 단계 안내

EB 환경 생성하기

초기화가 완료되었으니 다음은 실제 환경을 생성할 차례입니다:

# 환경 생성 명령 (다음 글에서 자세히!)
eb create django-app-dev \
  --platform "Python 3.12" \
  --single \
  --profile eb-cli

환경 생성 시 수행되는 작업:

EC2 인스턴스 생성
보안 그룹 설정
로드 밸런서 구성 (선택 사항)
애플리케이션 배포 준비

다음 글 예고

다음 글에서는 실제로 Django 애플리케이션을 EB에 배포하는 방법을 다룹니다:

환경 생성 (eb create)
환경 변수 설정 (SECRET_KEY, DEBUG 등)
첫 배포 (eb deploy)
배포 확인 및 문제 해결

💰 비용 관련 안내

중요: eb init은 AWS에 아무것도 생성하지 않으므로 비용이 전혀 발생하지 않습니다.

비용은 다음 단계인 eb create에서 실제 환경(EC2 인스턴스 등)을 생성할 때부터 시작됩니다.

예상 비용 (Phase 1 - 단일 인스턴스):

EC2 t3.micro 인스턴스: ~$7/월 (프리티어 적용 시 무료)
데이터 전송: 사용량에 따라
총 예상 비용: $5-15/월 (프리티어 적용 시 거의 무료)

자주 묻는 질문 (FAQ)

Q1. EB CLI 설치가 안 되는데 어떻게 하나요?

A. pip 버전을 먼저 업그레이드하세요:

pip install --upgrade pip
pip install awsebcli

Q2. 프리티어로 사용할 수 있나요?

A. 네, eb init 자체는 무료이고, 환경 생성 시 t3.micro 인스턴스를 선택하면 프리티어 혜택을 받을 수 있습니다 (12개월간 무료).

Q3. 여러 환경을 만들 수 있나요?

A. 가능합니다. 하나의 애플리케이션에 dev, staging, production 등 용도별로 여러 환경을 만들 수 있습니다.

Q4. Windows에서도 사용할 수 있나요?

A. 네, EB CLI는 Windows, Mac, Linux 모두 지원합니다. 명령어는 동일하게 사용 가능합니다.

Q5. 초기화 후 설정을 변경하고 싶어요

A. .elasticbeanstalk/config.yml 파일을 직접 수정하거나 eb init을 다시 실행하여 설정을 변경할 수 있습니다.

📝 배포 전 체크리스트

다음 단계로 넘어가기 전에 다음 사항을 확인하세요:

AWS 계정 생성 완료
IAM 사용자 생성 및 필요한 권한 부여
AWS CLI 설치 및 자격증명 설정
EB CLI 설치 확인 (eb --version)
eb init 성공적으로 완료
.elasticbeanstalk/config.yml 파일 생성 확인
AWS 콘솔에서 애플리케이션 확인

🔗 유용한 참고 링크

마무리

AWS Elastic Beanstalk 환경 초기화의 모든 과정을 살펴봤습니다. 생각보다 간단하죠? 😊

핵심 요약:

AWS 자격증명 올바르게 설정
EB CLI 설치
eb init으로 프로젝트 초기화

다음 글에서는 실제 배포를 진행하면서 Django 애플리케이션이 AWS에서 실행되는 모습을 확인해보겠습니다!

궁금한 점이 있으시면 댓글로 남겨주세요. 행복한 코딩 되세요! 🚀

작성일: 2025-11-14
카테고리: AWS, Django, 클라우드 배포
난이도: 초급-중급

💬 이 글이 도움이 되셨나요? 다른 개발자들과 공유해보세요!

저작자표시 (새창열림)

AWS Elastic Beanstalk 초기화 방법 | EB CLI 설치부터 배포 준비까지

📑 목차

AWS 계정 및 권한 준비

AWS 계정 생성

IAM 사용자 생성 및 권한 설정

AWS CLI 설치와 설정

AWS CLI 설치

AWS 자격증명 설정

자격증명 확인

EB CLI 설치하기

EB CLI 설치

가상환경 사용 (권장)

EB 애플리케이션 초기화

프로젝트 디렉토리로 이동

eb init 실행

대화형 설정 과정

1단계: 리전 선택

2단계: 애플리케이션 이름 입력

3단계: 플랫폼 선택

4단계: 플랫폼 브랜치 선택

5단계: CodeCommit 사용 여부

6단계: SSH 설정

7단계: SSH 키페어 선택

초기화 완료

초기화 확인하기

생성된 파일 확인

config.yml 내용 살펴보기

EB CLI 상태 확인

AWS 콘솔에서 확인

문제 해결 가이드

EB CLI 설치 오류

자격증명을 찾을 수 없음

프로필 관련 오류

플랫폼 버전 오류

다음 단계 안내

EB 환경 생성하기

다음 글 예고

💰 비용 관련 안내

자주 묻는 질문 (FAQ)

Q1. EB CLI 설치가 안 되는데 어떻게 하나요?

Q2. 프리티어로 사용할 수 있나요?

Q3. 여러 환경을 만들 수 있나요?

Q4. Windows에서도 사용할 수 있나요?

Q5. 초기화 후 설정을 변경하고 싶어요

📝 배포 전 체크리스트

🔗 유용한 참고 링크

마무리

티스토리툴바