InfoGrab DocsInfoGrab Docs

AWS에서 Enterprise 기능 구성

요약

terraform-aws-n8n 모듈은 AWS 배포에서 n8n의 여러 Enterprise 기능을 연결하는 Terraform 입력값을 제공합니다. S3에 실행 데이터를 저장하려면 n8n 2.27.0 이상과 feat:executionDataS3 권한이 있는 Enterprise 라이선스가 필요합니다.

terraform-aws-n8n 모듈은 AWS 배포에서 n8n의 여러 Enterprise 기능을 연결하는 Terraform 입력값을 제공합니다. 이 페이지에서는 각 기능의 모듈별 설정을 다룹니다. 각 기능이 무엇을 하는지, 어떻게 사용하는지는 링크된 n8n 기능 페이지를 참고합니다.

S3의 실행 데이터#

Note

기능 제공 여부

S3에 실행 데이터를 저장하려면 n8n 2.27.0 이상과 feat:executionDataS3 권한이 있는 Enterprise 라이선스가 필요합니다.

모듈은 항상 n8n의 바이너리 데이터를 S3에 저장합니다. n8n 2.27.0부터는 실행 데이터를 PostgreSQL 대신 같은 버킷으로 옮길 수 있으며, 대규모 환경에서 데이터베이스 쓰기 부하를 줄여 줍니다.

module "n8n" {
  # ...other inputs...

  n8n_execution_data_storage_mode = "s3" # default: "database"
  n8n_image_tag                   = "2.27.4"
}

새 실행만 S3로 이동합니다. 백필(backfill)은 없으며, 모드를 다시 바꿔도 어느 모드에서든 이미 기록된 데이터에는 영향이 없습니다. n8n이 외부 스토리지를 사용하는 방식은 외부 스토리지 사용을 참고합니다.

Warning

S3 실행 데이터에는 자동 백업이 없습니다

PostgreSQL과 달리 모듈은 S3 버킷의 버전을 관리하거나 백업하지 않습니다. 실행 기록이 중요하다면 버킷(s3_bucket_name 출력)에 S3 버전 관리나 복제 규칙을 직접 추가합니다.

수명 주기 규칙을 추가한다면 바이너리 데이터 객체에만 적용되도록 범위를 지정합니다. n8n은 S3의 실행 데이터를 자체 실행 정리 설정으로 직접 정리합니다. n8n이 아직 참조하는 데이터가 삭제될 수 있으므로 실행 데이터에는 수명 주기 규칙을 추가하지 않습니다.

Prometheus 메트릭#

n8n_metrics_enabled = true로 설정하면 n8n의 기본 제공 Prometheus 엔드포인트가 차트가 이미 UI와 API에 사용하는 포트 5678의 /metrics에 노출됩니다. n8n이 노출하는 항목은 Prometheus 메트릭 활성화를 참고합니다. 모듈은 스크레이핑을 구성하지 않습니다. n8n-main Service에 스크레이프 어노테이션을 추가하거나, Prometheus Operator를 실행한다면 ServiceMonitor를 만듭니다.

n8n 자체의 /metrics 엔드포인트는 멀티 메인 토폴로지에서 사용할 수 있는 Bull 큐 깊이를 보고하지 않습니다. redis_exporter_enabled = true로 설정하면 릴리즈와 함께 redis_exporter가 배포되어 포트 9121에서 큐 깊이를 redis_key_size{key="<prefix>:jobs:wait"}와 redis_key_size{key="<prefix>:jobs:active"}로 노출합니다. KEDA가 워커를 스케일링할 때 기준으로 삼는 큐 깊이와 같은 값입니다.

OpenTelemetry 트레이싱#

Note

Preview 상태

n8n의 OpenTelemetry 트레이싱은 변경될 수 있으며 프로덕션 사용은 권장하지 않습니다.

n8n_otel_enabled = true로 설정하면 모든 n8n 컨테이너에서 n8n의 워크플로 및 노드 트레이싱이 켜집니다. n8n_otel_exporter_otlp_endpoint가 OpenTelemetry 컬렉터의 기본 URL을 가리키도록 설정합니다(n8n이 /v1/traces를 직접 덧붙입니다).

module "n8n" {
  # ...other inputs...

  n8n_otel_enabled                = true
  n8n_otel_exporter_otlp_endpoint = "http://otel-collector.observability.svc.cluster.local:4318"
}

모듈은 컬렉터를 배포하지 않습니다. 업스트림 open-telemetry/opentelemetry-collector Helm 차트 등으로 별도로 배포합니다. 사용할 수 있는 튜닝 변수와 n8n이 트레이싱하는 대상은 OpenTelemetry로 실행 트레이싱을 참고합니다.

로그 스트리밍#

Note

기능 제공 여부

로그 스트리밍에는 n8n 2.19.0 이상과 Enterprise 라이선스가 필요합니다.

로그 스트리밍 대상을 UI 대신 Terraform으로 구성하려면 n8n_log_streaming_managed_by_env = true로 설정합니다.

module "n8n" {
  # ...other inputs...

  n8n_log_streaming_managed_by_env = true
  n8n_log_streaming_destinations = [
    {
      type             = "webhook"
      label            = "Audit events"
      enabled          = true
      subscribedEvents = ["n8n.audit", "n8n.workflow"]
      url              = "https://hooks.example.com/n8n"
      method           = "POST"
    },
  ]
}

n8n은 시작할 때마다 이 대상을 다시 적용하며, UI의 Log Streaming 설정은 읽기 전용이 됩니다. n8n_log_streaming_managed_by_env를 다시 false로 설정하면 마지막으로 적용된 대상은 유지되지만 UI 액세스는 복원됩니다.

외부 시크릿#

n8n의 외부 시크릿 기능은 런타임에 외부 볼트에서 워크플로 자격 증명 값을 가져옵니다. feat:externalSecrets 권한이 있는 Enterprise 라이선스가 필요하며 기본적으로 켜져 있습니다(n8n_external_secrets_enabled = true). 해당 기능이 포함된 라이선스에서도 끄려면 false로 설정합니다.

볼트 제공자 연결은 어떤 경우에도 n8n UI(Settings > External Secrets)에서 수동으로 하는 단계입니다. Terraform으로 이 연결을 만들 수는 없습니다. 모듈이 할 수 있는 일은 n8n Pod의 Pod Identity 역할에 특정 AWS Secrets Manager 시크릿에 대한 읽기 권한을 부여하는 것이며, 이렇게 하면 UI에서 정적 IAM 사용자 키를 붙여 넣는 대신 자동 자격 증명 감지를 선택할 수 있습니다.

module "n8n" {
  # ...other inputs...

  n8n_external_secrets_aws_enabled      = true
  n8n_external_secrets_aws_secret_names = ["prod/n8n/stripe", "prod/n8n/hubspot"]
}

n8n_external_secrets_aws_secret_names는 필수이며 와일드카드를 허용하지 않습니다. n8n의 AWS Secrets Manager 연동에는 읽을 수 있는 시크릿을 제한할 다른 방법이 없으므로 모든 시크릿 이름을 명시적으로 나열합니다.

자격 증명 오버라이트#

자격 증명 오버라이트를 사용하면 공유 자격 증명 필드를 미리 구성하고 사용자에게서 숨길 수 있습니다. JSON 페이로드는 직접 관리하는 Kubernetes Secret로 제공하고, n8n_credentials_overwrite_secret_ref로 참조합니다.

module "n8n" {
  # ...other inputs...

  n8n_credentials_overwrite_secret_ref = {
    name = kubernetes_secret_v1.credentials_overwrite.metadata[0].name
  }
}

n8n은 이 파일을 시작할 때 한 번만 읽습니다. Secret의 내용을 교체한 뒤에는 main, worker, webhook 프로세서 Deployment를 재시작해 변경 사항을 반영합니다.

관련 리소스#

AWS에서 Enterprise 기능 구성

n8n v2.47
원문 보기

요약

terraform-aws-n8n 모듈은 AWS 배포에서 n8n의 여러 Enterprise 기능을 연결하는 Terraform 입력값을 제공합니다. S3에 실행 데이터를 저장하려면 n8n 2.27.0 이상과 feat:executionDataS3 권한이 있는 Enterprise 라이선스가 필요합니다.

terraform-aws-n8n 모듈은 AWS 배포에서 n8n의 여러 Enterprise 기능을 연결하는 Terraform 입력값을 제공합니다. 이 페이지에서는 각 기능의 모듈별 설정을 다룹니다. 각 기능이 무엇을 하는지, 어떻게 사용하는지는 링크된 n8n 기능 페이지를 참고합니다.

S3의 실행 데이터#

Note

기능 제공 여부

S3에 실행 데이터를 저장하려면 n8n 2.27.0 이상과 feat:executionDataS3 권한이 있는 Enterprise 라이선스가 필요합니다.

모듈은 항상 n8n의 바이너리 데이터를 S3에 저장합니다. n8n 2.27.0부터는 실행 데이터를 PostgreSQL 대신 같은 버킷으로 옮길 수 있으며, 대규모 환경에서 데이터베이스 쓰기 부하를 줄여 줍니다.

module "n8n" {
  # ...other inputs...

  n8n_execution_data_storage_mode = "s3" # default: "database"
  n8n_image_tag                   = "2.27.4"
}

새 실행만 S3로 이동합니다. 백필(backfill)은 없으며, 모드를 다시 바꿔도 어느 모드에서든 이미 기록된 데이터에는 영향이 없습니다. n8n이 외부 스토리지를 사용하는 방식은 외부 스토리지 사용을 참고합니다.

Warning

S3 실행 데이터에는 자동 백업이 없습니다

PostgreSQL과 달리 모듈은 S3 버킷의 버전을 관리하거나 백업하지 않습니다. 실행 기록이 중요하다면 버킷(s3_bucket_name 출력)에 S3 버전 관리나 복제 규칙을 직접 추가합니다.

수명 주기 규칙을 추가한다면 바이너리 데이터 객체에만 적용되도록 범위를 지정합니다. n8n은 S3의 실행 데이터를 자체 실행 정리 설정으로 직접 정리합니다. n8n이 아직 참조하는 데이터가 삭제될 수 있으므로 실행 데이터에는 수명 주기 규칙을 추가하지 않습니다.

Prometheus 메트릭#

n8n_metrics_enabled = true로 설정하면 n8n의 기본 제공 Prometheus 엔드포인트가 차트가 이미 UI와 API에 사용하는 포트 5678의 /metrics에 노출됩니다. n8n이 노출하는 항목은 Prometheus 메트릭 활성화를 참고합니다. 모듈은 스크레이핑을 구성하지 않습니다. n8n-main Service에 스크레이프 어노테이션을 추가하거나, Prometheus Operator를 실행한다면 ServiceMonitor를 만듭니다.

n8n 자체의 /metrics 엔드포인트는 멀티 메인 토폴로지에서 사용할 수 있는 Bull 큐 깊이를 보고하지 않습니다. redis_exporter_enabled = true로 설정하면 릴리즈와 함께 redis_exporter가 배포되어 포트 9121에서 큐 깊이를 redis_key_size{key="<prefix>:jobs:wait"}와 redis_key_size{key="<prefix>:jobs:active"}로 노출합니다. KEDA가 워커를 스케일링할 때 기준으로 삼는 큐 깊이와 같은 값입니다.

OpenTelemetry 트레이싱#

Note

Preview 상태

n8n의 OpenTelemetry 트레이싱은 변경될 수 있으며 프로덕션 사용은 권장하지 않습니다.

n8n_otel_enabled = true로 설정하면 모든 n8n 컨테이너에서 n8n의 워크플로 및 노드 트레이싱이 켜집니다. n8n_otel_exporter_otlp_endpoint가 OpenTelemetry 컬렉터의 기본 URL을 가리키도록 설정합니다(n8n이 /v1/traces를 직접 덧붙입니다).

module "n8n" {
  # ...other inputs...

  n8n_otel_enabled                = true
  n8n_otel_exporter_otlp_endpoint = "http://otel-collector.observability.svc.cluster.local:4318"
}

모듈은 컬렉터를 배포하지 않습니다. 업스트림 open-telemetry/opentelemetry-collector Helm 차트 등으로 별도로 배포합니다. 사용할 수 있는 튜닝 변수와 n8n이 트레이싱하는 대상은 OpenTelemetry로 실행 트레이싱을 참고합니다.

로그 스트리밍#

Note

기능 제공 여부

로그 스트리밍에는 n8n 2.19.0 이상과 Enterprise 라이선스가 필요합니다.

로그 스트리밍 대상을 UI 대신 Terraform으로 구성하려면 n8n_log_streaming_managed_by_env = true로 설정합니다.

module "n8n" {
  # ...other inputs...

  n8n_log_streaming_managed_by_env = true
  n8n_log_streaming_destinations = [
    {
      type             = "webhook"
      label            = "Audit events"
      enabled          = true
      subscribedEvents = ["n8n.audit", "n8n.workflow"]
      url              = "https://hooks.example.com/n8n"
      method           = "POST"
    },
  ]
}

n8n은 시작할 때마다 이 대상을 다시 적용하며, UI의 Log Streaming 설정은 읽기 전용이 됩니다. n8n_log_streaming_managed_by_env를 다시 false로 설정하면 마지막으로 적용된 대상은 유지되지만 UI 액세스는 복원됩니다.

외부 시크릿#

n8n의 외부 시크릿 기능은 런타임에 외부 볼트에서 워크플로 자격 증명 값을 가져옵니다. feat:externalSecrets 권한이 있는 Enterprise 라이선스가 필요하며 기본적으로 켜져 있습니다(n8n_external_secrets_enabled = true). 해당 기능이 포함된 라이선스에서도 끄려면 false로 설정합니다.

볼트 제공자 연결은 어떤 경우에도 n8n UI(Settings > External Secrets)에서 수동으로 하는 단계입니다. Terraform으로 이 연결을 만들 수는 없습니다. 모듈이 할 수 있는 일은 n8n Pod의 Pod Identity 역할에 특정 AWS Secrets Manager 시크릿에 대한 읽기 권한을 부여하는 것이며, 이렇게 하면 UI에서 정적 IAM 사용자 키를 붙여 넣는 대신 자동 자격 증명 감지를 선택할 수 있습니다.

module "n8n" {
  # ...other inputs...

  n8n_external_secrets_aws_enabled      = true
  n8n_external_secrets_aws_secret_names = ["prod/n8n/stripe", "prod/n8n/hubspot"]
}

n8n_external_secrets_aws_secret_names는 필수이며 와일드카드를 허용하지 않습니다. n8n의 AWS Secrets Manager 연동에는 읽을 수 있는 시크릿을 제한할 다른 방법이 없으므로 모든 시크릿 이름을 명시적으로 나열합니다.

자격 증명 오버라이트#

자격 증명 오버라이트를 사용하면 공유 자격 증명 필드를 미리 구성하고 사용자에게서 숨길 수 있습니다. JSON 페이로드는 직접 관리하는 Kubernetes Secret로 제공하고, n8n_credentials_overwrite_secret_ref로 참조합니다.

module "n8n" {
  # ...other inputs...

  n8n_credentials_overwrite_secret_ref = {
    name = kubernetes_secret_v1.credentials_overwrite.metadata[0].name
  }
}

n8n은 이 파일을 시작할 때 한 번만 읽습니다. Secret의 내용을 교체한 뒤에는 main, worker, webhook 프로세서 Deployment를 재시작해 변경 사항을 반영합니다.

관련 리소스#