AWS CodeBuild로 빌드 자동화하기

---

🔧 AWS CodeBuild로 빌드 자동화하기

지난 글에서는 AWS CodePipeline을 활용해서
CI/CD의 기본 구조를 만들어봤죠.

이번 글에서는 그 중 빌드(Build) 단계를 맡는 핵심 서비스인
AWS CodeBuild를 사용해서,
코드 변경 → 자동 빌드 → 배포 흐름을 만들어요!

---

🧩 CodeBuild란?

AWS CodeBuild는 AWS에서 제공하는
완전 관리형 빌드 서비스예요.

즉, 서버 설치나 환경 구성 없이도
코드 커밋 시 자동으로
✅ 컴파일
✅ 테스트
✅ 패키징
까지 실행되도록 만들어주는 도구입니다.

---

🚀 언제 CodeBuild를 사용할까?

예를 들어:

• React 앱을 npm run build 해서 번들링할 때
• Java 프로젝트를 maven build 할 때
• Python 프로젝트를 테스트 + zip으로 패키징할 때

💡 이 모든 과정을 사람이 손으로 하지 않고,
커밋만 해도 자동으로 수행되게 만드는 게 CodeBuild의 역할!

---

🛠️ 실습: React 앱 자동 빌드 구성하기

목표: GitHub에 푸시하면 React 앱이 자동으로 빌드되고 S3에 배포되도록!

---

1. 프로젝트 루트에 buildspec.yml 파일 만들기

---

 

version: 0.2

phases:
  install:
    runtime-versions:
      nodejs: 18
    commands:
      - npm install
  build:
    commands:
      - npm run build

artifacts:
  files:
    - '**/*'
  base-directory: build

---

이 파일은 CodeBuild가 무엇을 어떻게 빌드할지 정의하는 설정 파일이에요.

 

---

2. S3 버킷 생성 (정적 웹 호스팅용)

• React 빌드 결과물(build 폴더)을 올릴 버킷을 만들어줍니다.

---

3. CodeBuild 프로젝트 생성

👉 이름 설정

예: react-auto-build

👉 소스 제공자 선택

• GitHub 또는 CodeCommit
• 저장소 연결 및 브랜치 지정

👉 환경 설정

• 운영체제: Ubuntu
• 런타임: Managed Image (Standard)
• 런타임 버전: Node.js 18 포함된 이미지 선택
• 서비스 역할: 새로 생성 or 기존 IAM 사용

👉 buildspec.yml 사용 체크

---

4. CodePipeline과 연동하기 (선택)

• CodePipeline의 Build 단계에 위에서 만든 CodeBuild 프로젝트 연결하면
  Source → Build → Deploy 전체 흐름 완성!

---

✅ 전체 흐름 요약

1. GitHub에 커밋
2. CodePipeline이 변경 감지
3. CodeBuild가 npm install & npm run build 실행
4. 결과물(build 폴더)이 S3에 자동 업로드
5. 사용자: 배포된 최신 웹 확인!

---

실무 활용 팁

• test 단계도 추가 가능 (npm test 등)
• 빌드 실패 시 알림: SNS, Slack, 이메일 연동 가능
• Docker 이미지로 커스텀 빌드 환경도 구성 가능
• IAM 권한 세밀하게 조정해서 보안 강화

---

마무리 🎯

AWS CodeBuild를 사용하면
단순히 빌드 스크립트를 서버에 입력하는 수고를 줄이고,
안정적이고 반복 가능한 자동화된 빌드 환경을 만들 수 있어요.

특히 React, Vue, Angular 같이 정적 파일 빌드가 필요한 프로젝트에 정말 잘 어울려요.