AWS CodeDeploy로 EC2에 배포 자동화하기

---

🚀 AWS CodeDeploy로 EC2에 배포 자동화하기

이전 글에서는 CodeBuild로 자동 빌드하는 법을 알아봤죠.
이번에는 그 빌드된 결과물을 EC2에 자동으로 배포하는
실제 DevOps 워크플로우의 핵심 중 하나인
AWS CodeDeploy를 다뤄볼게요!

---

💡 CodeDeploy란?

AWS CodeDeploy는
EC2, Lambda, 또는 온프레미스 서버에
애플리케이션을 자동으로 배포할 수 있게 해주는 서비스예요.

"매번 서버에 접속해서 git pull 하고, 서비스 재시작하고..."
이 수작업을 모두 자동화해주는 것이 바로 CodeDeploy!

---

🎯 CodeDeploy는 이런 작업을 자동으로 해줘요

• EC2에 애플리케이션 파일 업로드
• 설치 스크립트 실행 (npm install, systemctl restart 등)
• 블루/그린 배포, 롤백 지원
• 배포 상태 추적 및 실패 시 자동 복구

---

🧩 구성 요소 간단 요약

• CodePipeline: 전체 흐름 컨트롤러
• CodeBuild: 애플리케이션 빌드
• CodeDeploy: EC2에 배포
• EC2 인스턴스: 실제 서비스가 돌아가는 서버

---

🛠️ 실습: React 앱을 EC2에 자동 배포하기

전제 조건

• EC2 인스턴스 1대 (Amazon Linux 2)
• CodeDeploy Agent 설치됨
• IAM 역할 및 권한 설정 완료

---

1. EC2에 CodeDeploy Agent 설치

---

[bash]

 

sudo yum update -y
sudo yum install ruby wget -y
cd /home/ec2-user
wget https://aws-codedeploy-us-east-1.s3.amazonaws.com/latest/install
chmod +x ./install
sudo ./install auto
sudo service codedeploy-agent start

---

설치 후에는 상태 체크!

---

[bash]

 

sudo service codedeploy-agent status

---

2. EC2에 IAM Role 연결

• AmazonEC2RoleforAWSCodeDeploy 권한 포함
• EC2 인스턴스에 이 역할을 연결해줘야 CodeDeploy가 접근 가능

---

3. appspec.yml 파일 작성

---

version: 0.0
os: linux
files:
  - source: /
    destination: /home/ec2-user/my-app

hooks:
  AfterInstall:
    - location: scripts/install.sh
      timeout: 300
      runas: ec2-user
  ApplicationStart:
    - location: scripts/start.sh
      timeout: 300
      runas: ec2-user

---

💡 appspec.yml은 CodeDeploy가 어떤 작업을 어떤 순서로 실행할지 정의하는 핵심 파일!

---

4. 배포 스크립트 예시

/scripts/install.sh

---

[bash]

 

#!/bin/bash
cd /home/ec2-user/my-app
npm install

---

 

/scripts/start.sh

---

[bash]

 

#!/bin/bash
pm2 restart app || pm2 start app.js

---

---

5. CodeDeploy 애플리케이션 생성

1. AWS 콘솔 → CodeDeploy → 애플리케이션 생성
2. 컴퓨팅 플랫폼: EC2/온프레미스
3. 배포 그룹 생성:
   • 대상 인스턴스: 태그로 지정 (ex: Name = MyServer)
   • 서비스 역할: CodeDeployRole (AWS에서 제공하는 권한 사용)

---

6. CodePipeline에 배포 단계 추가

• Source → Build → Deploy (CodeDeploy로 EC2 배포)
• appspec.yml 및 스크립트 포함한 zip 파일을 아티팩트로 전달

---

✅ 결과

이제부터는 GitHub에 푸시하면:

1. CodePipeline이 감지
2. CodeBuild가 빌드
3. CodeDeploy가 EC2에 자동 배포
4. EC2에서 앱이 실행되고 사용자에게 서비스 제공!

---

🧠 마무리 팁

• 배포 로그는 CodeDeploy 콘솔에서 확인 가능 (실패 원인 추적에 유용)
• 블루/그린 배포 설정하면 무중단 배포 가능
• pm2, systemctl, docker 등으로 서비스 실행 자동화 가능
• AfterInstall, ApplicationStart 외에도 다양한 hook 사용 가능

---

마무리 🎯

AWS CodeDeploy는
복잡하고 반복적인 서버 배포 작업을 자동화해서
개발자/운영자 모두의 삶의 질을 높여주는 도구예요.

특히 EC2 기반 애플리케이션을 운영하는 팀이라면
꼭 익혀야 할 핵심 DevOps 도구입니다.