n8n 中文文档

在 AWS 上扩展并以高可用运行

terraform-aws-n8n 模块默认以队列模式部署 n8n,并使用多主设置实现高可用。本页介绍该拓扑中模块特有的设置:多 main 许可、worker 自动扩缩和 Redis 高可用。

多主设置

默认情况下,模块会运行多个 main Pod,并需要 Enterprise 许可证。设置 n8n_main_hpa_min_replicas = 1 即可改为运行单个 main Pod,此时只需要 Business 计划许可证,因为该模式下会禁用 n8n 的多 main 领导者选举功能。

警告

单 main 模式在升级时会停机

当 n8n_main_hpa_min_replicas = 1 时,main Pod 的自动扩缩上限会被强制设为 1,升级使用 Recreate 策略,Pod disruption budget 允许驱逐仅有的那个 main。升级和维护期间,编辑器、REST API 和定时触发器会出现停机。请安排维护窗口。

main Pod 前面的任何负载均衡器或 Ingress 都需要启用会话保持(粘性会话),以便浏览器保持连接到同一个 main Pod。模块自己的 Ingress 默认会设置此项。如果您使用自己的 Ingress,请参阅自定义 AWS 基础设施。

Worker 自动扩缩

Worker Pod 使用 KEDA 根据 Redis 队列深度扩缩,模块会自动安装 KEDA。要检查某个 worker 的自动扩缩器能否访问 Redis:

kubectl -n n8n get scaledobject

健康的扩缩器会报告 READY=True。如果报告 READY=False,请查看 KEDA operator 日志以了解原因:

kubectl -n keda logs -l app=keda-operator | grep -i 'connection to redis'

提示

Worker HPA 的 TARGETS 列可能产生误导

对于由 KEDA 支持的 worker HPA,kubectl get hpa 的 TARGETS 列经常显示 <unknown>,即使自动扩缩工作正常。请改用 kubectl get scaledobject 检查扩缩器的健康状况。

如果您启用Redis 传输中加密,KEDA 的队列深度触发器会自动使用与 worker 相同的加密、已认证连接。

Redis 高可用

默认情况下,模块把 Redis 置备为单节点 aws_elasticache_cluster。对于 worker 队列和多 main 领导者选举,这都是单点故障。设置 redis_high_availability_enabled = true,即可改为置备一个复制组(一个主节点和一个副本),并在两个 Availability Zone 之间自动故障转移:

module "n8n" {
  # ...
  redis_high_availability_enabled = true
  redis_node_type                 = "cache.r6g.large"
}

两个节点都使用 redis_node_type,因此启用高可用大约会使 Redis 费用翻倍。

警告

高可用并不能防止 Pod 重启

Redis 故障转移大约会在 20 秒内提升副本,但 Redis 复制是异步的,因此如果副本尚未收到最近的队列写入,这些写入可能会丢失。不过,每个 main、worker 和 webhook Pod 仍会重启:一旦 Redis 不可达的时间超过 QUEUE_BULL_REDIS_TIMEOUT_THRESHOLD(默认 10 秒),n8n 的 Redis 客户端就会退出进程。这是快速失败设计,而不是崩溃循环。Kubernetes 会立即把每个 Pod 拉起来。如果 Redis 可用,恢复通常在一分钟内完成。

避免故障转移期间重启

设置 n8n_redis_timeout_threshold 可以提高 n8n 在退出之前等待 Redis 的时间。实际可用的预算比您设置的数字更粗,因为每次失败的连接尝试大约需要 11.1 秒(1 秒重试间隔加上 10 秒连接超时):

您设置的值 实际预算 退出前的重连次数
10000(默认) 11.1 秒 1
30000 33.2 秒 3
60000 66.4 秒 6

故障转移之后,过期的 Redis 端点可能因为 DNS 缓存而比故障转移本身更久才能解析。把阈值设为 60000 在实践中可以解决这一点,Pod 会记录 Recovered Redis connection,而不是重启:

module "n8n" {
  # ...
  redis_high_availability_enabled = true
  n8n_redis_timeout_threshold     = 60000
}

这是一种取舍,不是没有代价的收益:同一个阈值也决定了面对真正已失效的 Redis 时,Pod 会等待多久才重启。对 worker 来说,这通常是可以接受的取舍,因为 Redis 无论哪种情况都不可达时,重启也没有帮助。

切换拓扑

在正在运行的部署上切换 redis_high_availability_enabled 会销毁现有缓存并创建一个新缓存。当时排队中或正在进行的一切都会丢失。请把这当作维护窗口操作:停止新工作进入 n8n,让 worker 排空,并在应用之前确认 Redis 中的 bull:jobs:wait、bull:jobs:active 和 bull:jobs:delayed 都为空。

Redis 驱逐策略

模块把 Redis 的 maxmemory-policy 设为 noeviction(redis_maxmemory_policy),而不是 ElastiCache 的 volatile-lru 默认值。在内存压力下,noeviction 的 Redis 会以内存不足错误拒绝新的写入,而不是悄悄驱逐队列键(例如任务锁)。这样,Redis 已满会表现为写入失败和任务锁续期失败,而不是队列数据在没有说明的情况下消失。请同时为队列和 n8n 的缓存规划 Redis 内存,因为两者共享同一个实例。

Redis 传输中加密和 AUTH

默认情况下,Redis 位于私有子网中,前面是只允许 VPC 流量的安全组,没有 TLS,也没有密码。设置 redis_transit_encryption_enabled = true 即可同时加上两者:模块会启用 TLS、生成 AUTH 令牌,并把它配置到每个 n8n 容器上。

terraform output -raw redis_auth_token

相关资源

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。