n8n 中文文档

维护并拆除 AWS 部署

terraform-aws-n8n 模块管理加密密钥和数据库保护设置。这些设置在升级、从事件中恢复或停用部署时最为重要。本页介绍这些设置。分步的升级和销毁排障,请参阅模块在 GitHub 上的升级指南和销毁核对清单。

使用您自己的 KMS 密钥

默认情况下,模块会创建并管理自己的 KMS 密钥,用于加密 RDS 实例和 S3 存储桶。要改为使用您已经拥有的密钥(例如由中央安全团队控制的密钥)进行加密:

create_db_kms_key = false
db_kms_key_arn    = "arn:aws:kms:eu-west-1:123456789012:key/1a2b3c4d-..."

create_s3_kms_key = false
s3_kms_key_arn    = "arn:aws:kms:eu-west-1:123456789012:key/1a2b3c4d-..."

请同时设置布尔值和 ARN:只设置布尔值会阻止模块创建自己的密钥,只设置 ARN 则会被忽略。

提示

CloudWatch Logs 日志组需要自己的密钥策略语句

RDS 可以通过 grant(授权)使用您的密钥,但 CloudWatch Logs 会拒绝密钥策略中没有明确写出区域 Logs 服务主体的密钥。没有该语句时,模块的 postgresql 日志组会回退到 CloudWatch 自己的托管密钥,而不是您的密钥。请添加一条语句,向 logs.<region>.amazonaws.com 主体授予 kms:Encrypt、kms:Decrypt、kms:ReEncrypt*、kms:GenerateDataKey* 和 kms:DescribeKey,然后把 db_logs_kms_key_enabled = true 和 db_logs_kms_key_arn 设为同一密钥。

验证 PostgreSQL TLS 证书

默认情况下,n8n 与模块 RDS 实例之间的连接已加密但未验证(DB_POSTGRESDB_SSL_REJECT_UNAUTHORIZED=false),因为 RDS 服务器证书链接到 Amazon 自己的证书颁发机构,而 Node.js 默认不信任它。要在加密连接的同时验证服务器身份:

db_postgresdb_ssl_reject_unauthorized = true
db_postgresdb_ssl_ca_pem              = file("${path.module}/global-bundle.pem")

从 AWS 信任存储 https://truststore.pki.rds.amazonaws.com 下载合并的 CA 证书包。模块会把它以只读方式挂载到每个 n8n Pod 上,并把 DB_POSTGRESDB_SSL_CA_FILE 指向它。

terraform destroy 之后的 KMS 密钥

模块会把其托管 KMS 密钥安排在 terraform destroy 之后 7 天删除,而不是立即删除。密钥一旦被安排删除就无法使用,尽管永久丢失要等到 7 天窗口结束才会发生。要在一次已完成的 destroy 之后重新使用密钥,请取消删除、启用它,并在重新 apply 之前把它导入回 Terraform state:

aws kms cancel-key-deletion --key-id <key-id>
aws kms enable-key --key-id <key-id>

警告

处于待删除状态的密钥会阻止恢复,即使保留了快照或 S3 对象也一样

一旦密钥进入 PendingDeletion,用模块自己的 KMS 密钥加密的 RDS 快照和 S3 对象就无法解密。如果需要加密备份在 terraform destroy 之后仍然可用,请在模块之外管理一把保留的 KMS 密钥。对于现有部署,请在销毁之前用该密钥复制 RDS 快照,并重新加密或复制 S3 对象;更改已配置的密钥不会重新加密现有数据。

删除保护与拆除

模块默认使用便于拆除的设置,以便示例部署可以被干净地销毁:

设置 默认值 生产值
db_deletion_protection false true
db_skip_final_snapshot true false(同时设置 db_final_snapshot_identifier)
db_delete_automated_backups true false
s3_force_destroy true false

这四项在现有部署上都是原地变更,不会强制替换。请在运行 terraform destroy 之前应用这些设置。Terraform 使用的是 state 中的值,而不是尚未应用的配置。因此,编辑 .tfvars 文件后立即运行 destroy,仍然会使用旧值。

相关资源

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