AWS App Runner를 사용해 첫 Node.js 앱 배포를 자동화한 방법
Source: Dev.to
소개
DevOps와 클라우드 배포를 이제 막 시작한 사람으로서, 스스로에게 도전하고 싶었습니다: Node.js 앱을 반복 가능하고 효율적이며 서버 관리가 필요 없는 방식으로 자동 배포할 수 있을까?
몇 차례 실험을 거친 뒤, 바로 그 것을 보여주는 작은 프로젝트를 만들었고, 그 과정에서 사용한 도구와 배운 교훈들을 공유합니다.
🎯 목표
제 목표는 간단했습니다:
- Node.js 애플리케이션을 빌드하기
- 컨테이너에 패키징하기
- 레지스트리에 푸시하기
- 서버리스 서비스를 사용해 자동으로 배포하기
이론적으로는 간단해 보이지만, 초보자로서 컨테이너, 레지스트리 및 배포 서비스에 대해 많이 배워야 했습니다.
🛠️ 사용한 도구와 이유
1. Node.js
이미 JavaScript에 익숙했기 때문에 Node.js는 내 애플리케이션에 당연히 선택되었습니다. 가볍고 설정이 간단하며 클라우드 플랫폼에서 폭넓게 지원됩니다.
이유: 빠른 개발, 컨테이너화가 용이하고 작은 웹 앱에 최적입니다.
2. Docker
Docker를 사용하면 앱과 그 의존성을 컨테이너에 패키징할 수 있어 어디서든 동일하게 실행됩니다.
이유: 환경 간 일관성 확보와 AWS App Runner와의 원활한 통합.
3. AWS Elastic Container Registry (ECR)
ECR은 Docker Hub와 비슷하지만 AWS와 통합된 컨테이너 레지스트리입니다. 배포 전에 Docker 이미지를 저장하는 데 사용했습니다.
이유: AWS App Runner와 원활하게 통합되고 인증이 간편합니다.
4. AWS App Runner
서버리스 배포 서비스를 처음 사용해 본 경험이었습니다. App Runner는 컨테이너화된 앱을 서버에 대한 고민 없이 배포할 수 있게 해줍니다. 자동으로 스케일링, HTTPS, 로드 밸런싱을 처리합니다.
이유: 운영 부담을 없애 주며, 인프라보다 앱 개발에 집중하고 싶은 초보자에게 최적입니다.
5. Shell 스크립팅 (deploy.sh)
배포를 자동화하기 위해 Docker 이미지를 빌드하고, ECR에 푸시한 뒤, App Runner를 트리거하는 작은 스크립트를 작성했습니다.
이유: 반복 작업을 자동화하고 인간 오류 가능성을 줄여줍니다.
팁: 초보자라도 이러한 단계를 스크립트로 작성하면 전체 워크플로를 더 잘 이해할 수 있습니다.
⚙️ 작동 방식
제가 만든 배포 파이프라인의 간략한 개요는 다음과 같습니다:
- 로컬에서 Node.js 앱을 개발합니다
- Docker를 사용해 앱을 컨테이너화합니다
- Docker 이미지를 AWS ECR에 푸시합니다
- AWS App Runner를 트리거하여 새 이미지를 배포합니다
- App Runner가 자동으로 앱을 호스팅하고 스케일링합니다
배포 파이프라인은 처음이지만, 이 워크플로우를 구축해 두니 앱 업데이트가 단일 스크립트를 실행하는 것만큼 간단해졌습니다.
🚧 초보자로서 직면한 도전 과제
- Docker 인증 문제 – AWS ECR 로그인 방식을 배우는 데 여러 번 시도와 오류가 필요했습니다.
- App Runner 개념 이해 – 처음에는 서비스, 이미지, 배포가 어떻게 연결되는지 확신이 없었습니다.
- 자동화 스크립팅 – 오류를 처리하고 한 번에 실행할 수 있는 스크립트를 작성하는 것이 까다로웠습니다.
이러한 도전 과제에도 불구하고 컨테이너화, 클라우드 호스팅 및 배포 파이프라인에 대해 많이 배웠습니다.
📚 배운 점
- Automation saves time: 배포를 위한 스크립트를 작성하는 것이 모든 작업을 수동으로 하는 것보다 훨씬 빠릅니다.
- Serverless hosting is beginner‑friendly: App Runner는 복잡한 서버 관리를 추상화하여 초보자에게 친숙합니다.
- Step‑by‑step learning works best: 작은 Node.js 앱으로 시작하여 점차 Docker, ECR, 그리고 App Runner를 추가했습니다.
🚀 다음 단계
이제 작동하는 배포 파이프라인이 있으니, 개선 계획은 다음과 같습니다:
- GitHub Actions와 CI/CD 통합 탐색 – 코드가 저장소에 푸시될 때마다 빌드와 배포를 자동화합니다.
- 환경 변수 및 비밀 관리 추가 – 파이프라인을 보다 안전하고 다양한 환경에 유연하게 만듭니다.
- 더 복잡한 애플리케이션 배포
권장 사항
더 큰 멀티‑서비스 앱으로 워크플로를 테스트하여 더 깊은 경험을 쌓으세요.
💡 마무리 생각
초보자라도 이 프로젝트를 구축하면서 클라우드 배포와 DevOps 워크플로에 대한 자신감을 얻었습니다.
여러분도 시작한다면, 다음을 실험해 보기를 강력히 추천합니다:
- 컨테이너화된 앱 – 환경에 관계없이 애플리케이션을 일관되게 패키징하고 실행하는 방법을 배우세요.
- 서버리스 배포 – 인프라 관리보다 앱 자체에 집중하세요.
이는 교육적이며 보람도 있으며, DevOps와 클라우드 엔지니어링을 성장시키는 탄탄한 기반을 제공합니다.