InfoGrab DocsInfoGrab Docs

AWS에 첫 n8n 인스턴스 배포

요약

이 안내는 terraform-aws-n8n 모듈의 small 예시를 사용하여 빈 폴더에서 AWS의 실행 중인 n8n 인스턴스까지 여섯 단계로 안내합니다. 리포지터리를 클론하지 않습니다. terraform apply부터 접속 가능한 에디터까지 약 30분이 걸립니다.

이 안내는 terraform-aws-n8n 모듈의 small 예시를 사용하여 빈 폴더에서 AWS의 실행 중인 n8n 인스턴스까지 여섯 단계로 안내합니다. main.tf 파일 하나를 작성한 다음 terraform init, terraform plan, terraform apply를 실행합니다.

리포지터리를 클론하지 않습니다. 예시는 Terraform Registry의 n8n-io/n8n/aws에 있으며, terraform init이 이를 다운로드합니다. 예시에 VPC와 프로바이더 설정이 포함되어 있으므로, 이 페이지의 구성이 작성해야 하는 Terraform의 전부입니다.

terraform apply부터 접속 가능한 에디터까지 약 30분이 걸립니다.

Note

기능 제공 범위

이 모듈이 배포하는 기본 멀티 메인 토폴로지는 다음에서 사용할 수 있습니다.

  • 셀프 호스팅: Enterprise

n8n_main_hpa_min_replicas = 1로 설정하여 메인 Pod 하나로 실행하는 경우 Business 라이선스도 사용할 수 있습니다. 이 모드에서 달라지는 내용은 AWS에서 확장 및 고가용성 운영을 참조하십시오.

사전 요구 사항#

시작하기 전에 다음이 준비되어 있어야 합니다.

  • Terraform CLI 1.11 이상이 설치되어 있습니다.
  • AWS CLI가 설치되어 있고, EKS, RDS, ElastiCache, IAM, VPC, KMS, S3, ACM, Route 53 리소스를 생성할 수 있는 자격 증명으로 구성되어 있습니다.
  • 상위 영역이 AWS Route 53에서 호스팅되는 도메인이 있습니다. 호스팅 영역 ID가 필요합니다. 예를 들어 n8n.example.com에서 n8n을 실행하려면 example.com의 호스팅 영역이 필요합니다.
  • n8n Enterprise 라이선스 키가 있습니다. n8n_main_hpa_min_replicas = 1로 설정하는 경우 Business 라이선스 키도 사용할 수 있습니다.

1단계: 프로젝트 폴더 생성#

Terraform은 실행한 폴더를 기준으로 동작하므로 빈 폴더에서 시작합니다.

mkdir n8n-aws
cd n8n-aws

2단계: 배포 규모 선택#

terraform-aws-n8n 모듈은 세 가지 규모 예시를 제공합니다. 이 안내에서는 개발 환경이나 소규모 팀 인스턴스에 적합한 small을 배포합니다.

small(기본값) medium large
대상 규모 개발 환경 또는 소규모 팀 하루 약 500만~1,500만 실행 하루 약 5,000만~6,000만 이상 실행
노드 유형 t3.xlarge m6i.2xlarge m7i.4xlarge
월 예상 비용(온디맨드) ~$440 ~$2,000 ~$21,000+

Pod 수, 데이터베이스 크기, 예약 인스턴스 요금을 포함한 전체 비교는 Terraform으로 AWS에 배포의 규모 표를 참조하십시오. 어떤 규모를 선택할지 확실하지 않다면 small로 시작합니다. small에서 medium으로 옮기는 것은 간단하지만, large로 옮기려면 인프라 변경이 필요합니다.

더 큰 규모를 배포하려면 main.tf의 모듈 source가 해당 예시의 하위 경로를 가리키도록 합니다. examples/medium은 small과 같은 입력을 받고, examples/large는 certificate_arn과 aurora_instance_class를 추가로 받습니다.

3단계: main.tf 생성#

프로젝트 폴더에 main.tf 파일 하나를 만듭니다. 이 파일은 레지스트리의 small 예시를 0.5.0 버전으로 고정하여 모듈로 참조합니다.

variable "n8n_license_key" {
  type      = string
  sensitive = true
}

module "n8n" {
  source  = "n8n-io/n8n/aws//examples/small"
  version = "0.5.0"

  n8n_domain      = "n8n.example.com"
  route53_zone_id = "<hosted-zone-id>"
  n8n_license_key = var.n8n_license_key

  # Applied to every resource, for cost tracking and ownership.
  tags = {
    Environment = "development"
    Owner       = "platform-team"
  }

  # aws_region   = "eu-west-1"   # optional, defaults to us-east-1
  # cluster_name = "n8n-cluster" # optional, 14 characters or fewer
}

output "n8n_url" {
  description = "The URL to open once the load balancer finishes provisioning."
  value       = module.n8n.n8n_url
}

output "n8n_encryption_key" {
  description = "Back this up in a password manager. n8n emits it once."
  value       = module.n8n.n8n_encryption_key
  sensitive   = true
}

cluster_name은 14자 이하여야 합니다. 모듈이 <cluster-name>-redis 형태의 ElastiCache 클러스터 ID를 만들고, AWS는 이 ID를 20자로 제한하기 때문입니다.

4단계: 값 설정#

main.tf에서 다음을 교체합니다.

  • n8n_domain을 n8n을 실행할 도메인으로 교체합니다.
  • route53_zone_id를 해당 도메인의 상위 영역 호스팅 영역 ID로 교체합니다.
  • tags를 조직에서 비용 추적과 소유권 표시에 사용하는 태그로 교체합니다.

그런 다음 라이선스 키가 파일에 남지 않도록 환경 변수로 제공합니다.

export TF_VAR_n8n_license_key="<your-license-key>"

5단계: Terraform 초기화#

terraform init

이 명령은 n8n 모듈, VPC 모듈, aws, kubernetes, helm 프로바이더를 다운로드합니다.

6단계: 계획 및 적용#

Terraform이 생성할 내용을 미리 확인합니다.

terraform plan

계획을 검토한 다음 적용합니다.

terraform apply

메시지가 표시되면 yes를 입력하거나, 확인을 건너뛰려면 -auto-approve를 추가합니다. 프로비저닝에는 약 20~25분이 걸리고, 그 후 로드 밸런서에 접속할 수 있게 되기까지 약 5분이 더 필요합니다.

완료되면 n8n_url 출력의 URL을 엽니다.

terraform output -raw n8n_url

n8n이 설정 화면을 표시합니다. 이메일, 이름과 성, 비밀번호를 입력하여 소유자 계정을 만듭니다. 설문을 완료하거나 건너뛰면 워크스페이스로 이동합니다.

Warning

암호화 키를 지금 저장하십시오

n8n은 암호화 키를 한 번만 생성합니다. 이 키가 없으면 저장된 모든 자격 증명을 읽을 수 없게 되며, 누구도 복구해 줄 수 없습니다. 다음 단계로 넘어가기 전에 terraform output -raw n8n_encryption_key를 실행하여 값을 비밀번호 관리자에 저장합니다.

Terraform 상태 파일 보호#

Terraform은 프로젝트 폴더에 terraform.tfstate 파일을 기록합니다. 이 파일은 인프라를 기록하며, n8n 암호화 키, 데이터베이스 비밀번호, 라이선스 키 같은 시크릿을 평문으로 저장합니다. 출력을 sensitive로 표시해도 터미널에서만 가려질 뿐 상태 파일에서는 가려지지 않습니다.

다음 두 가지 규칙을 따릅니다.

  • terraform.tfstate를 버전 관리에 커밋하지 않습니다.
  • 간단한 체험을 넘어서는 용도라면, 암호화, 버전 관리, 상태 잠금, 엄격한 접근 제어가 구성된 HCP Terraform 또는 S3 버킷에 상태를 원격으로 저장합니다.

정리#

이 예시가 생성한 모든 리소스를 삭제하려면 다음을 실행합니다.

terraform destroy

메시지가 표시되면 yes를 입력하거나 -auto-approve를 추가합니다.

small 예시는 terraform destroy가 깔끔하게 실행되도록 삭제에 적합한 기본값을 제공합니다. RDS 인스턴스는 최종 스냅샷을 건너뛰고, S3 버킷은 강제로 삭제됩니다. 설정을 프로덕션으로 옮기기 전에 이 값을 검토합니다. 프로덕션 값은 AWS 배포 유지 관리 및 삭제를 참조하십시오. 또한 모듈은 삭제 후 7일 뒤에 KMS 키를 삭제하도록 예약하므로, 보존된 스냅샷에서의 복구가 불가능해집니다.

관련 리소스#

인스턴스는 모듈의 기본값으로 실행 중입니다. 이후에는 다음을 참조합니다.

AWS에 첫 n8n 인스턴스 배포

n8n v2.47
원문 보기

요약

이 안내는 terraform-aws-n8n 모듈의 small 예시를 사용하여 빈 폴더에서 AWS의 실행 중인 n8n 인스턴스까지 여섯 단계로 안내합니다. 리포지터리를 클론하지 않습니다. terraform apply부터 접속 가능한 에디터까지 약 30분이 걸립니다.

이 안내는 terraform-aws-n8n 모듈의 small 예시를 사용하여 빈 폴더에서 AWS의 실행 중인 n8n 인스턴스까지 여섯 단계로 안내합니다. main.tf 파일 하나를 작성한 다음 terraform init, terraform plan, terraform apply를 실행합니다.

리포지터리를 클론하지 않습니다. 예시는 Terraform Registry의 n8n-io/n8n/aws에 있으며, terraform init이 이를 다운로드합니다. 예시에 VPC와 프로바이더 설정이 포함되어 있으므로, 이 페이지의 구성이 작성해야 하는 Terraform의 전부입니다.

terraform apply부터 접속 가능한 에디터까지 약 30분이 걸립니다.

Note

기능 제공 범위

이 모듈이 배포하는 기본 멀티 메인 토폴로지는 다음에서 사용할 수 있습니다.

  • 셀프 호스팅: Enterprise

n8n_main_hpa_min_replicas = 1로 설정하여 메인 Pod 하나로 실행하는 경우 Business 라이선스도 사용할 수 있습니다. 이 모드에서 달라지는 내용은 AWS에서 확장 및 고가용성 운영을 참조하십시오.

사전 요구 사항#

시작하기 전에 다음이 준비되어 있어야 합니다.

  • Terraform CLI 1.11 이상이 설치되어 있습니다.
  • AWS CLI가 설치되어 있고, EKS, RDS, ElastiCache, IAM, VPC, KMS, S3, ACM, Route 53 리소스를 생성할 수 있는 자격 증명으로 구성되어 있습니다.
  • 상위 영역이 AWS Route 53에서 호스팅되는 도메인이 있습니다. 호스팅 영역 ID가 필요합니다. 예를 들어 n8n.example.com에서 n8n을 실행하려면 example.com의 호스팅 영역이 필요합니다.
  • n8n Enterprise 라이선스 키가 있습니다. n8n_main_hpa_min_replicas = 1로 설정하는 경우 Business 라이선스 키도 사용할 수 있습니다.

1단계: 프로젝트 폴더 생성#

Terraform은 실행한 폴더를 기준으로 동작하므로 빈 폴더에서 시작합니다.

mkdir n8n-aws
cd n8n-aws

2단계: 배포 규모 선택#

terraform-aws-n8n 모듈은 세 가지 규모 예시를 제공합니다. 이 안내에서는 개발 환경이나 소규모 팀 인스턴스에 적합한 small을 배포합니다.

small(기본값) medium large
대상 규모 개발 환경 또는 소규모 팀 하루 약 500만~1,500만 실행 하루 약 5,000만~6,000만 이상 실행
노드 유형 t3.xlarge m6i.2xlarge m7i.4xlarge
월 예상 비용(온디맨드) ~$440 ~$2,000 ~$21,000+

Pod 수, 데이터베이스 크기, 예약 인스턴스 요금을 포함한 전체 비교는 Terraform으로 AWS에 배포의 규모 표를 참조하십시오. 어떤 규모를 선택할지 확실하지 않다면 small로 시작합니다. small에서 medium으로 옮기는 것은 간단하지만, large로 옮기려면 인프라 변경이 필요합니다.

더 큰 규모를 배포하려면 main.tf의 모듈 source가 해당 예시의 하위 경로를 가리키도록 합니다. examples/medium은 small과 같은 입력을 받고, examples/large는 certificate_arn과 aurora_instance_class를 추가로 받습니다.

3단계: main.tf 생성#

프로젝트 폴더에 main.tf 파일 하나를 만듭니다. 이 파일은 레지스트리의 small 예시를 0.5.0 버전으로 고정하여 모듈로 참조합니다.

variable "n8n_license_key" {
  type      = string
  sensitive = true
}

module "n8n" {
  source  = "n8n-io/n8n/aws//examples/small"
  version = "0.5.0"

  n8n_domain      = "n8n.example.com"
  route53_zone_id = "<hosted-zone-id>"
  n8n_license_key = var.n8n_license_key

  # Applied to every resource, for cost tracking and ownership.
  tags = {
    Environment = "development"
    Owner       = "platform-team"
  }

  # aws_region   = "eu-west-1"   # optional, defaults to us-east-1
  # cluster_name = "n8n-cluster" # optional, 14 characters or fewer
}

output "n8n_url" {
  description = "The URL to open once the load balancer finishes provisioning."
  value       = module.n8n.n8n_url
}

output "n8n_encryption_key" {
  description = "Back this up in a password manager. n8n emits it once."
  value       = module.n8n.n8n_encryption_key
  sensitive   = true
}

cluster_name은 14자 이하여야 합니다. 모듈이 <cluster-name>-redis 형태의 ElastiCache 클러스터 ID를 만들고, AWS는 이 ID를 20자로 제한하기 때문입니다.

4단계: 값 설정#

main.tf에서 다음을 교체합니다.

  • n8n_domain을 n8n을 실행할 도메인으로 교체합니다.
  • route53_zone_id를 해당 도메인의 상위 영역 호스팅 영역 ID로 교체합니다.
  • tags를 조직에서 비용 추적과 소유권 표시에 사용하는 태그로 교체합니다.

그런 다음 라이선스 키가 파일에 남지 않도록 환경 변수로 제공합니다.

export TF_VAR_n8n_license_key="<your-license-key>"

5단계: Terraform 초기화#

terraform init

이 명령은 n8n 모듈, VPC 모듈, aws, kubernetes, helm 프로바이더를 다운로드합니다.

6단계: 계획 및 적용#

Terraform이 생성할 내용을 미리 확인합니다.

terraform plan

계획을 검토한 다음 적용합니다.

terraform apply

메시지가 표시되면 yes를 입력하거나, 확인을 건너뛰려면 -auto-approve를 추가합니다. 프로비저닝에는 약 20~25분이 걸리고, 그 후 로드 밸런서에 접속할 수 있게 되기까지 약 5분이 더 필요합니다.

완료되면 n8n_url 출력의 URL을 엽니다.

terraform output -raw n8n_url

n8n이 설정 화면을 표시합니다. 이메일, 이름과 성, 비밀번호를 입력하여 소유자 계정을 만듭니다. 설문을 완료하거나 건너뛰면 워크스페이스로 이동합니다.

Warning

암호화 키를 지금 저장하십시오

n8n은 암호화 키를 한 번만 생성합니다. 이 키가 없으면 저장된 모든 자격 증명을 읽을 수 없게 되며, 누구도 복구해 줄 수 없습니다. 다음 단계로 넘어가기 전에 terraform output -raw n8n_encryption_key를 실행하여 값을 비밀번호 관리자에 저장합니다.

Terraform 상태 파일 보호#

Terraform은 프로젝트 폴더에 terraform.tfstate 파일을 기록합니다. 이 파일은 인프라를 기록하며, n8n 암호화 키, 데이터베이스 비밀번호, 라이선스 키 같은 시크릿을 평문으로 저장합니다. 출력을 sensitive로 표시해도 터미널에서만 가려질 뿐 상태 파일에서는 가려지지 않습니다.

다음 두 가지 규칙을 따릅니다.

  • terraform.tfstate를 버전 관리에 커밋하지 않습니다.
  • 간단한 체험을 넘어서는 용도라면, 암호화, 버전 관리, 상태 잠금, 엄격한 접근 제어가 구성된 HCP Terraform 또는 S3 버킷에 상태를 원격으로 저장합니다.

정리#

이 예시가 생성한 모든 리소스를 삭제하려면 다음을 실행합니다.

terraform destroy

메시지가 표시되면 yes를 입력하거나 -auto-approve를 추가합니다.

small 예시는 terraform destroy가 깔끔하게 실행되도록 삭제에 적합한 기본값을 제공합니다. RDS 인스턴스는 최종 스냅샷을 건너뛰고, S3 버킷은 강제로 삭제됩니다. 설정을 프로덕션으로 옮기기 전에 이 값을 검토합니다. 프로덕션 값은 AWS 배포 유지 관리 및 삭제를 참조하십시오. 또한 모듈은 삭제 후 7일 뒤에 KMS 키를 삭제하도록 예약하므로, 보존된 스냅샷에서의 복구가 불가능해집니다.

관련 리소스#

인스턴스는 모듈의 기본값으로 실행 중입니다. 이후에는 다음을 참조합니다.