InfoGrab DocsInfoGrab Docs

AWS 배포 유지 관리 및 삭제

요약

terraform-aws-n8n 모듈은 업그레이드, 장애 복구, 배포 폐기 시 가장 중요한 암호화 키와 데이터베이스 보호 설정을 관리합니다. 기본적으로 모듈은 RDS 인스턴스와 S3 버킷을 암호화하기 위한 KMS 키를 직접 생성하고 관리합니다.

terraform-aws-n8n 모듈은 업그레이드, 장애 복구, 배포 폐기 시 가장 중요한 암호화 키와 데이터베이스 보호 설정을 관리합니다. 이 페이지에서는 해당 설정을 다룹니다. 업그레이드 및 삭제(destroy) 문제 해결 절차는 GitHub에 있는 모듈의 업그레이드 가이드와 삭제 체크리스트를 참조하세요.

자체 KMS 키 사용#

기본적으로 모듈은 RDS 인스턴스와 S3 버킷을 암호화하기 위한 KMS 키를 직접 생성하고 관리합니다. 예를 들어 중앙 보안 팀이 관리하는 키처럼 이미 보유한 키로 암호화하려면 다음과 같이 설정합니다.

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-..."

boolean 값과 ARN을 함께 설정합니다. boolean 값만 설정하면 모듈이 자체 키를 생성하지 않을 뿐이며, ARN만 설정하면 무시됩니다.

Note

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 서버 인증서가 Node.js가 기본적으로 신뢰하지 않는 Amazon 자체 인증 기관으로 연결되기 때문입니다. 연결을 암호화할 뿐 아니라 서버 신원까지 검증하려면 다음과 같이 설정합니다.

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 키#

모듈은 terraform destroy 이후 관리 중인 KMS 키를 즉시 삭제하지 않고 7일 뒤에 삭제되도록 예약합니다. 삭제가 예약되면 영구 손실은 7일의 대기 기간이 끝나야 발생하지만, 키는 예약된 즉시 사용할 수 없게 됩니다. destroy가 완료된 후 키를 다시 사용하려면 삭제를 취소하고 키를 활성화한 다음, 다시 apply하기 전에 Terraform 상태로 가져와야 합니다.

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

삭제 대기 중인 키는 스냅샷이나 S3 객체가 보존되어 있어도 복구를 막습니다

모듈 자체 KMS 키로 암호화된 RDS 스냅샷과 S3 객체는 키가 PendingDeletion 상태가 되면 복호화할 수 없습니다. 암호화된 백업이 terraform destroy 이후에도 유지되어야 한다면 모듈 외부에서 보존용 KMS 키를 관리하세요. 기존 배포의 경우 destroy 전에 해당 키로 RDS 스냅샷을 복사하고 S3 객체를 재암호화하거나 복사하세요. 구성된 키를 변경해도 기존 데이터는 재암호화되지 않습니다.

삭제 방지와 삭제 절차#

모듈의 기본 설정은 삭제하기 쉬운 값이므로, 예제 배포를 깔끔하게 destroy할 수 있습니다.

설정 기본값 프로덕션 값
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

네 가지 설정 모두 기존 배포에서 제자리 변경(in-place change)이며 리소스 교체를 강제하지 않습니다. terraform destroy를 실행하기 전에 이 설정을 적용하세요. Terraform은 아직 적용되지 않은 구성이 아니라 상태에 저장된 값을 사용합니다. 따라서 .tfvars 파일을 수정한 직후 바로 destroy를 실행하면 이전 값이 그대로 사용됩니다.

관련 리소스#

AWS 배포 유지 관리 및 삭제

n8n v2.47
원문 보기

요약

terraform-aws-n8n 모듈은 업그레이드, 장애 복구, 배포 폐기 시 가장 중요한 암호화 키와 데이터베이스 보호 설정을 관리합니다. 기본적으로 모듈은 RDS 인스턴스와 S3 버킷을 암호화하기 위한 KMS 키를 직접 생성하고 관리합니다.

terraform-aws-n8n 모듈은 업그레이드, 장애 복구, 배포 폐기 시 가장 중요한 암호화 키와 데이터베이스 보호 설정을 관리합니다. 이 페이지에서는 해당 설정을 다룹니다. 업그레이드 및 삭제(destroy) 문제 해결 절차는 GitHub에 있는 모듈의 업그레이드 가이드와 삭제 체크리스트를 참조하세요.

자체 KMS 키 사용#

기본적으로 모듈은 RDS 인스턴스와 S3 버킷을 암호화하기 위한 KMS 키를 직접 생성하고 관리합니다. 예를 들어 중앙 보안 팀이 관리하는 키처럼 이미 보유한 키로 암호화하려면 다음과 같이 설정합니다.

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-..."

boolean 값과 ARN을 함께 설정합니다. boolean 값만 설정하면 모듈이 자체 키를 생성하지 않을 뿐이며, ARN만 설정하면 무시됩니다.

Note

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 서버 인증서가 Node.js가 기본적으로 신뢰하지 않는 Amazon 자체 인증 기관으로 연결되기 때문입니다. 연결을 암호화할 뿐 아니라 서버 신원까지 검증하려면 다음과 같이 설정합니다.

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 키#

모듈은 terraform destroy 이후 관리 중인 KMS 키를 즉시 삭제하지 않고 7일 뒤에 삭제되도록 예약합니다. 삭제가 예약되면 영구 손실은 7일의 대기 기간이 끝나야 발생하지만, 키는 예약된 즉시 사용할 수 없게 됩니다. destroy가 완료된 후 키를 다시 사용하려면 삭제를 취소하고 키를 활성화한 다음, 다시 apply하기 전에 Terraform 상태로 가져와야 합니다.

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

삭제 대기 중인 키는 스냅샷이나 S3 객체가 보존되어 있어도 복구를 막습니다

모듈 자체 KMS 키로 암호화된 RDS 스냅샷과 S3 객체는 키가 PendingDeletion 상태가 되면 복호화할 수 없습니다. 암호화된 백업이 terraform destroy 이후에도 유지되어야 한다면 모듈 외부에서 보존용 KMS 키를 관리하세요. 기존 배포의 경우 destroy 전에 해당 키로 RDS 스냅샷을 복사하고 S3 객체를 재암호화하거나 복사하세요. 구성된 키를 변경해도 기존 데이터는 재암호화되지 않습니다.

삭제 방지와 삭제 절차#

모듈의 기본 설정은 삭제하기 쉬운 값이므로, 예제 배포를 깔끔하게 destroy할 수 있습니다.

설정 기본값 프로덕션 값
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

네 가지 설정 모두 기존 배포에서 제자리 변경(in-place change)이며 리소스 교체를 강제하지 않습니다. terraform destroy를 실행하기 전에 이 설정을 적용하세요. Terraform은 아직 적용되지 않은 구성이 아니라 상태에 저장된 값을 사용합니다. 따라서 .tfvars 파일을 수정한 직후 바로 destroy를 실행하면 이전 값이 그대로 사용됩니다.

관련 리소스#