在 AWS 上配置 Enterprise 功能
terraform-aws-n8n 模块提供若干 Terraform 输入,用于为 AWS 部署接入 n8n 的 Enterprise 功能。本页介绍每个功能在模块中的特定设置。各功能的作用和用法,请参阅所链接的 n8n 功能页面。
在 S3 中存储执行数据
提示
功能可用性
在 S3 中存储执行数据需要 n8n 2.27.0 或更高版本,以及带有 feat:executionDataS3 授权项的 Enterprise 许可证。
模块始终把 n8n 的二进制数据存放在 S3 中。从 n8n 2.27.0 起,您可以把执行数据卸载到同一个存储桶,而不是 PostgreSQL,从而在大规模下减轻数据库写入压力:
module "n8n" {
# ...其他输入...
n8n_execution_data_storage_mode = "s3" # 默认:"database"
n8n_image_tag = "2.27.4"
}
只有新的执行会转移到 S3:没有回填,把模式切换回去也不会影响已经按任一模式写入的数据。n8n 如何使用外部存储,请参阅使用外部存储。
警告
S3 中的执行数据没有自动备份
与 PostgreSQL 不同,模块不会为 S3 存储桶启用版本控制或备份。如果执行历史对您很重要,请自行为该存储桶(s3_bucket_name 输出)添加 S3 版本控制或复制规则。
如果您添加生命周期规则,请把它的范围限定为仅二进制数据对象。n8n 会使用自己的执行清理设置,在 S3 中修剪执行数据;不要为此添加生命周期规则,因为那可能会删除 n8n 仍在引用的数据。
Prometheus 指标
设置 n8n_metrics_enabled = true,即可在端口 5678 的 /metrics 上公开 n8n 内置的 Prometheus 端点。chart 已经用该端口提供 UI 和 API。n8n 会公开哪些内容,请参阅启用 Prometheus 指标。模块不会配置抓取:请向 n8n-main Service 添加抓取注解,或者在运行 Prometheus Operator 时创建 ServiceMonitor。
在多 main 拓扑中,n8n 自己的 /metrics 端点不会报告可用的 Bull 队列深度。设置 redis_exporter_enabled = true,即可在该 release 旁部署一个 redis_exporter。它会在端口 9121 上把队列深度公开为 redis_key_size{key="<prefix>:jobs:wait"} 和 redis_key_size{key="<prefix>:jobs:active"}。这与 KEDA 用来扩缩 worker 的队列深度相同。
OpenTelemetry 跟踪
提示
预览状态
n8n 中的 OpenTelemetry 跟踪可能会变化,不建议用于生产环境。
设置 n8n_otel_enabled = true,即可在每个 n8n 容器上打开 n8n 的工作流和节点跟踪。把 n8n_otel_exporter_otlp_endpoint 指向您的 OpenTelemetry collector 的基址 URL(n8n 会自行追加 /v1/traces):
module "n8n" {
# ...其他输入...
n8n_otel_enabled = true
n8n_otel_exporter_otlp_endpoint = "http://otel-collector.observability.svc.cluster.local:4318"
}
模块不会部署 collector。请单独部署一个,例如使用上游的 open-telemetry/opentelemetry-collector Helm chart。可用的调优变量以及 n8n 会跟踪哪些内容,请参阅使用 OpenTelemetry 跟踪执行。
日志流式传输
提示
功能可用性
日志流式传输需要 n8n 2.19.0 或更高版本,以及 Enterprise 许可证。
设置 n8n_log_streaming_managed_by_env = true,即可从 Terraform 而不是 UI 配置日志流式传输目的地:
module "n8n" {
# ...其他输入...
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 的 External Secrets 外部密钥功能会在运行时从外部保管库解析工作流凭据的值。它需要带有 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" {
# ...其他输入...
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 集成没有其他办法限制它可以读取哪些密钥。
凭据覆盖
凭据覆盖让您可以预先配置共享的凭据字段,并对用户隐藏它们。请通过您自己管理的 Kubernetes Secret 提供 JSON 负载,并用 n8n_credentials_overwrite_secret_ref 引用它:
module "n8n" {
# ...其他输入...
n8n_credentials_overwrite_secret_ref = {
name = kubernetes_secret_v1.credentials_overwrite.metadata[0].name
}
}
n8n 只在启动时读取该文件一次。轮换 Secret 的内容后,请重启 main、worker 和 webhook 处理器 Deployment,以应用变更。