维护并拆除 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,仍然会使用旧值。