OpenSearch domains should have at least three data nodes¶
This control checks whether OpenSearch domains are configured with at least three data nodes and zoneAwarenessEnabled is true. This control fails for an OpenSearch domain if instanceCount is less than 3 or zoneAwarenessEnabled is false.
How to fix¶
Attribute cluster_config[0].zone_awareness_enabled of aws_opensearch_domain must be true.
Implementation options¶
Choose the option that matches how you manage Terraform. All options satisfy this control.
Option 1: Open source module (terraform-aws-modules)¶
If you use terraform-aws-modules/opensearch/aws, configure the required module inputs to satisfy this control. You can later migrate to the compliance.tf module with minimal changes because it is compatible by design.
module "opensearch" {
source = "terraform-aws-modules/opensearch/aws"
version = ">=2.0.0,<3.0.0"
domain_name = "abc123"
ebs_options = {
ebs_enabled = true
volume_size = 64
volume_type = "gp3"
}
engine_version = "OpenSearch_2.11"
cluster_config = {
zone_awareness_enabled = true
}
}
Option 2: Terraform AWS provider resources¶
If you manage resources directly, configure the relevant Terraform AWS provider resources to meet this control. See docs for the resources involved: aws_opensearch_domain.
resource "aws_opensearch_domain" "this" {
advanced_security_options {
enabled = true
internal_user_database_enabled = false
master_user_options {
master_user_name = "admin"
master_user_password = "ChangeMe123!"
}
}
cognito_options {
enabled = true
identity_pool_id = "us-east-1:12345678-1234-1234-1234-123456789012"
role_arn = "arn:aws:iam::123456789012:role/CognitoAccessForAmazonOpenSearch"
user_pool_id = "us-east-1_Example"
}
domain_name = "pofix-example"
log_publishing_options {
cloudwatch_log_group_arn = "arn:aws:logs:us-east-1:123456789012:log-group:example-log-group"
log_type = "AUDIT_LOGS"
}
log_publishing_options {
cloudwatch_log_group_arn = "arn:aws:logs:us-east-1:123456789012:log-group:example-log-group"
log_type = "ES_APPLICATION_LOGS"
}
vpc_options {
security_group_ids = ["sg-abc12345"]
subnet_ids = [element(["subnet-abc123", "subnet-def456"], 0)]
}
cluster_config {
instance_count = 3
instance_type = "m5.large.search"
zone_awareness_enabled = true
}
}
Which option should I choose?
- Compliance.tf module (recommended): controls enforced by default and mapped to frameworks.
- Open source module (
terraform-aws-modules): compatible by design with compliance.tf. Same variable names for an easy, low-change migration path when you are ready. - Terraform AWS provider resources: manage Terraform resources directly.
Tool mappings¶
Use these identifiers to cross-reference this control across tools, reports, and evidence.
Compliance.tf (CTF) Control:
opensearch_domain_data_node_fault_tolerancePowerpipe Controls:
aws_compliance.control.es_domain_data_nodes_min_3,aws_compliance.control.opensearch_domain_data_node_fault_tolerance