documentdb-cluster

cloudposse/documentdb-cluster/aws

Terraform Module HCL AWS

Terraform module to provision a DocumentDB cluster on AWS

Install
module "documentdb-cluster" {
source = "cloudposse/documentdb-cluster/aws"
version = "1.0.1"
}
⭐ Source on GitHub 📦 Registry page
README

Terraform module to provision an Amazon DocumentDB cluster. > [!TIP] > #### 👽 Use Atmos with Terraform > Cloud Posse uses atmos to easily orchestrate multiple environments using Terraform. > Works with Github Actions, Atlantis, or Spacelift. > > > Watch demo of using Atmos with Terraform > > Example of running atmos to manage infrastructure from our Quick Start tutorial. > Usage For a complete example, see examples/complete. For automated tests of the complete example using bats and Terratest (which tests and deploys the example on AWS), see test. ```hcl module "documentdb_cluster" { source = "cloudposse/documentdb-cluster/aws" # Cloud Posse recommends pinning every module to a specific version # version = "x.x.x" namespace = "eg" stage = "testing" name = "docdb" cluster_size = 3 master_us

Inputs (50)
NameTypeDescriptionDefault
subnet_idslist(string)List of VPC subnet IDs to place DocumentDB instances in required
vpc_idstringVPC ID to create the cluster in (e.g. `vpc-a22222ee`) required
external_security_group_id_listlist(string)List of external security group IDs to attach to the Document DB[]
reader_dns_namestringName of the reader endpoint CNAME record to create in the parent DNS zone specif""
ssm_parameter_enabledboolWhether an SSM parameter store value is created to store the database password.false
allowed_security_groupslist(string)List of existing Security Groups to be allowed to connect to the DocumentDB clus[]
enabledboolSet to false to prevent the module from creating any resourcesnull
descriptor_formatsanyDescribe additional descriptors to be output in the `descriptors` output map. Ma{}
instance_classstringThe instance class to use. For more details, see https://docs.aws.amazon.com/doc"db.r4.large"
label_key_casestringControls the letter case of the `tags` keys (label names) for tags generated by null
allow_ingress_from_selfboolAdds the Document DB security group itself as a source for ingress rules. Usefulfalse
manage_master_user_passwordboolWhether to manage the master user password using AWS Secrets Manager.null
egress_protocolstringDocumentDB protocol for egress (e.g. `-1`, `tcp`)"-1"
master_passwordstring(Required unless a snapshot_identifier is provided) Password for the master DB unull
preferred_maintenance_windowstringThe window to perform maintenance in. Syntax: `ddd:hh24:mi-ddd:hh24:mi`."Mon:22:00-Mon:23:00"
auto_minor_version_upgradeboolSpecifies whether any minor engine upgrades will be applied automatically to thetrue
ca_cert_identifierstringThe identifier of the CA certificate for the DB instancenull
tagsmap(string)Additional tags (e.g. `{'BusinessUnit': 'XYZ'}`). Neither the tag keys nor the t{}
ssm_parameter_path_prefixstringThe path prefix for the created SSM parameter e.g. '/docdb/master-password/dev'."/docdb/master-password/"
allowed_cidr_blockslist(string)List of CIDR blocks to be allowed to connect to the DocumentDB cluster[]
contextanySingle object for setting entire context at once. See description of individual { "additional_tag_map": {}, "attribu
namestringID element. Usually the component or solution name, e.g. 'app' or 'jenkins'. Thinull
… and 10 more inputs
Outputs (12)
arn — Amazon Resource Name (ARN) of the cluster
master_host — DB master hostname
security_group_arn — ARN of the DocumentDB cluster Security Group
master_password — Password for the master DB user. If `manage_master_user_password` is set to true, this will be set t
endpoint — Endpoint of the DocumentDB cluster
reader_endpoint — A read-only endpoint of the DocumentDB cluster, automatically load-balanced across replicas
cluster_members — List of DocumentDB Instances that are a part of this cluster
replicas_host — DB replicas hostname
security_group_id — ID of the DocumentDB cluster Security Group
security_group_name — Name of the DocumentDB cluster Security Group
master_username — Username for the master DB user
cluster_name — Cluster Identifier
Resources (7)
aws_docdb_clusteraws_docdb_cluster_instanceaws_docdb_cluster_parameter_groupaws_docdb_subnet_groupaws_security_groupaws_security_group_rulerandom_password
Details
FrameworkTerraform Module
LanguageHCL
Version1.0.1
Cloud AWS
★ Stars70
Forks99
Total downloads1.0M
Inputs50
Outputs12
Resources7
Examples2
LicenseApache-2.0
Namespacecloudposse
Updated