Oracle 클라우드 프리 티어에서 n8n 배포 가이드

카테고리

프로그래밍/소프트웨어 개발

서브카테고리

DevOps

대상자

- 소프트웨어 개발자 및 DevOps 엔지니어

- 중간 수준의 클라우드 배포 및 자동화 도구 경험 보유자

- n8n(자동화 플랫폼)을 사용하여 워크플로우 개발을 원하는 개발자

핵심 요약

• [n8n 배포] GitHub에 제공된 starter template repository를 통해 빠르게 시작 가능
• [Oracle Cloud Free Tier] VM 인스턴스 생성, OCI CLI 설치, n8n 환경 구성 등 5단계로 구성된 배포 프로세스
• [보안 강화] IAM 역할 설정, SSH 키 보안, n8n의 NODE_ENV=production 모드 활성화 필수

섹션별 세부 요약

1. 서론: 빠른 시작을 위한 GitHub 템플릿 제공

• https://github.com/n8n-io/n8n-oci-free-tier 리포지토리에 배포 스크립트 및 설정 파일 포함
• Docker 및 Node.js 18 이상 환경에서 동작 가능

2. Oracle Cloud 인스턴스 설정

• Oracle 계정 생성 → Free Tier VM 인스턴스 생성 (1 CPU, 1 GB RAM, Ubuntu OS)
• OCI CLI 설치 및 인스턴스에 SSH 접속
• oci 명령어를 통해 리소스 생성 및 관리 가능

3. n8n 환경 구성

• n8n 설치: npm install -g n8n 또는 Docker Compose 사용
• 환경 변수 설정: N8N_HOST, N8N_PORT, NODE_ENV=production 필수
• n8n 설정 파일(n8n.config.ts): 데이터베이스 연결, 인증 설정, 워크플로우 저장 경로 정의

4. 보안 및 확장성 고려사항

• IAM 역할 생성: Compute Instance에 Object Storage 액세스 권한 부여
• SSH 키 보안: ~/.ssh/id_rsa 파일 암호화 및 .gitignore 추가
• 자동화 스크립트: deploy.sh 파일에서 pm2 사용하여 서비스 관리

5. 테스트 및 배포 검증

• n8n 워크플로우 테스트: curl http://localhost:5678으로 API 응답 확인
• OCI 모니터링 도구: CPU/메모리 사용량, n8n 로그(/var/log/n8n/) 실시간 확인
• 자동 스케일링 설정: Oracle Cloud의 Auto Scaling 기능을 통해 트래픽 증가 시 자동 확장

결론

• GitHub 템플릿 활용을 통해 30분 내 배포 가능
• IAM 역할 및 SSH 키 보안을 반드시 적용해 보안 취약점 방지
• OCI CLI와 Docker Compose를 결합한 자동화 스크립트는 반복 작업 효율성 향상
• n8n의 NODE_ENV=production 모드는 성능 최적화 및 보안 강화에 필수적