Terraform으로 AWS에 배포
n8n v2.47요약
terraform-aws-n8n은 프로덕션급 멀티 메인(multi-main) n8n 인스턴스를 AWS에 배포하는 Terraform 모듈입니다. 이 모듈은 n8n이 다른 곳에서 문서화한 수동 쿠버네티스 설정과 다릅니다.
terraform-aws-n8n은 프로덕션급 멀티 메인(multi-main) n8n 인스턴스를 AWS에 배포하는 Terraform 모듈입니다. n8n의 Helm 차트를 실행하는 Amazon EKS 클러스터를 프로비저닝하며, 관리형 PostgreSQL(RDS), Redis(ElastiCache), 공유 파일 저장소용 S3를 함께 구성합니다.
이 모듈은 n8n이 다른 곳에서 문서화한 수동 쿠버네티스 설정과 다릅니다. 해당 가이드는 단일 n8n 인스턴스를 위한 매니페스트를 직접 작성하는 방법을 안내합니다. 반면 이 모듈은 고가용성 및 오토스케일링 배포를 자동화하며, n8n Solutions 팀이 독립적으로 유지 관리합니다.
프리릴리즈 모듈
terraform-aws-n8n은 프리릴리즈 상태입니다. 모듈이 첫 번째 안정 버전(1.0)에 도달하기 전에 호환성을 깨는 변경이 있을 수 있습니다.
기능 제공 범위
이 모듈이 배포하는 기본 멀티 메인 토폴로지는 다음에서 사용할 수 있습니다.
- 셀프 호스팅: Enterprise
n8n_main_hpa_min_replicas = 1로 설정하면 메인 Pod 하나만 실행하며, 이 경우 Business 플랜 라이선스만 필요합니다. 이 모드에서는 메인 Pod의 오토스케일링 최댓값이 1로 고정되고 업그레이드에 Recreate 전략이 사용됩니다. 업그레이드 및 유지 관리 중에는 에디터, REST API, 예약 트리거에 다운타임이 발생할 수 있습니다.
아키텍처#
사용자와 인바운드 웹훅은 EKS 클러스터 앞단의 Application Load Balancer로 들어옵니다. 클러스터 내부에서는 n8n Helm 차트가 세 개의 개별 배포를 실행합니다.
- 메인 Pod: 리더 선출, 에디터 UI, REST API를 처리합니다.
- 웹훅 프로세서 Pod: 인바운드 트리거를 처리합니다.
- 워커 Pod: 워크플로 실행을 수행하며, KEDA를 사용해 Redis 큐 깊이에 따라 스케일링됩니다.
상태는 클러스터 외부의 관리형 서비스에 저장됩니다. 워크플로 데이터는 RDS PostgreSQL, 리더 선출과 워커 큐는 ElastiCache Redis, 바이너리 데이터는 S3에 저장됩니다. AWS Certificate Manager(ACM)는 로드 밸런서용 TLS 인증서를 발급합니다.
AWS는 EKS Pod Identity를 통해 Pod에 권한을 부여합니다(Load Balancer Controller, Cluster Autoscaler, EBS CSI 드라이버, n8n 자체의 S3 접근에 해당).
사전 요구 사항#
- n8n 라이선스 키: 기본 멀티 메인 토폴로지에는 Enterprise 라이선스가,
n8n_main_hpa_min_replicas = 1로 설정하는 경우에는 Business 라이선스가 필요합니다. - EKS 및 ALB 용도로 태그가 지정된 퍼블릭 및 프라이빗 서브넷이 있는 기존 VPC. 모듈은 VPC를 생성하지 않습니다. AWS 인프라 사용자 지정을 참조하세요.
aws,kubernetes,helm프로바이더가 구성된 Terraform CLI 1.11 이상.- DNS 옵션: 모듈이 ACM 인증서를 발급하고 DNS 레코드를 직접 관리할 수 있도록 하는 Route 53 호스티드 존(
route53_zone_id), 또는 다른 제공업체에서 검증을 마친 인증서(certificate_arn) 중 하나.
사용법#
빈 폴더에서 실행 중인 인스턴스까지 단계별로 안내하는 가이드는 AWS에 첫 n8n 인스턴스 배포를 참조하세요. 아래 구성은 필요한 최소 입력값 집합입니다.
module "n8n" {
source = "n8n-io/n8n/aws"
version = "~> 0.5.0"
aws_region = "us-east-1"
cluster_name = "n8n-cluster"
n8n_domain = "n8n.example.com"
n8n_license_key = var.n8n_license_key
# Bring your own VPC.
vpc_id = module.vpc.vpc_id
private_subnets = module.vpc.private_subnets
public_subnets = module.vpc.public_subnets
vpc_cidr_block = module.vpc.vpc_cidr_block
# EKS node group autoscaling bounds. You pay for node_min nodes at all times.
node_min = 3
node_max = 6
# Set exactly one of these for DNS and TLS.
route53_zone_id = "Z0123456789ABCDEFGHIJ"
# certificate_arn = aws_acm_certificate_validation.n8n.certificate_arn
}
n8n_license_key와 같은 민감한 값은 시크릿 관리자에서 전달하세요. 모듈이 키를 Helm 릴리즈에 기록하므로 Terraform 상태는 암호화되고 접근이 제어되는 백엔드에 저장해야 합니다. 버전 관리에 커밋하는 .tfvars 파일에 키를 하드코딩하지 마세요.
시작 규모 선택#
모듈에는 세 가지 규모 예제가 포함되어 있습니다. 하나를 시작점으로 선택한 다음 노드 유형, 개수, 데이터베이스 크기를 조정하세요.
| small (기본값) | medium | large | |
|---|---|---|---|
| 대상 규모 | 개발 환경 또는 소규모 팀 | 하루 약 500만~1,500만 건 실행 | 하루 약 5,000만~6,000만 건 이상 실행 |
| 노드 유형 | t3.xlarge | m6i.2xlarge | m7i.4xlarge |
| 노드(최소/최대) | 3/6 | 5/15 | 10/50 |
| 데이터베이스 | RDS db.t3.small | RDS db.m6g.2xlarge | Aurora PostgreSQL I/O-Optimized |
| Redis | cache.t3.medium | cache.r6g.large | cache.r6g.large |
| 월 예상 비용(온디맨드) | 약 $440 | 약 $2,000 | 약 $21,000 이상 |
토폴로지 변형 두 가지도 예제로 제공됩니다. split-ingress(AWS 인프라 사용자 지정 참조)와, 레이블이 지정된 별도의 워커 풀을 실행하는 알파 단계 n8n 기능인 worker-pools입니다.
지원#
이 모듈은 오픈 소스이며, n8n Enterprise 지원 서비스와는 별개로 n8n Solutions 팀이 독립적으로 유지 관리합니다. 버그 보고나 기능 요청은 GitHub 이슈에 등록하세요. 유지 관리자는 SLA 없이 최선의 노력으로 분류합니다. 모듈과 관련 없는 일반적인 n8n 질문은 n8n 커뮤니티 포럼을 이용하세요.
이 섹션의 문서#
- AWS에 첫 n8n 인스턴스 배포: 빈 폴더에서 실행 중인 인스턴스까지 단계별로 안내하는 가이드입니다.
- AWS에서 스케일링 및 고가용성 운영: 멀티 메인, 워커 오토스케일링, Redis 고가용성을 구성합니다.
- AWS에서 Enterprise 기능 구성: S3 실행 데이터, Prometheus 메트릭, OpenTelemetry 트레이싱, 로그 스트리밍, 외부 시크릿을 연결합니다.
- AWS 인프라 사용자 지정: 자체 VPC, 데이터베이스, 캐시, 클러스터를 사용하거나 인그레스를 분리하거나 사용자 지정 n8n 이미지를 사용합니다.
- AWS 배포 유지 관리 및 삭제: 암호화 키를 관리하고, 데이터베이스 TLS를 검증하고, 삭제 방지를 구성합니다.