ec2-userdata-ad-join

andreswebs/ec2-userdata-ad-join/aws

Terraform Module HCL AWS

Generates a user-data script for dynamically joining and un-joining Windows EC2 instances to an Active Directory domain

Install

module "ec2-userdata-ad-join" {

source = "andreswebs/ec2-userdata-ad-join/aws"

version = "0.1.0"

}

plain text: /constructs/tfmod-andreswebs-ec2-userdata-ad-join-aws/install.txt

⭐ Source on GitHub 📦 Registry page

README

terraform-aws-ec2-userdata-ad-join Generates a user-data script for dynamically joining and un-joining Windows EC2 instances to an Active Directory domain. Configuration The user-data script will fetch configuration values from SSM parameters. These parameters are assumed to already exist in the environment. Default parameter names used by the module are: - /ad-join/domain - /ad-join/username - /ad-join/password - /ad-join/dns-servers The parameter names are configured from Terraform variables. (See the input values below.) The "username" and "password" parameters must contain credentials from an AD user with enough permissions to join machines to the domain. IAM permissions The user-data script assumes that the EC2 instance role has the proper permissions to access these parameters. The f

Inputs (7)

Name	Type	Description	Default
ad_ssm_parameter_name_domain	string	Name suffix of the SSM parameter containing the AD domain name	`"/domain"`
ad_ssm_parameter_name_username	string	Name suffix of the SSM parameter containing the AD username	`"/username"`
ad_ssm_parameter_name_password	string	Name suffix of the SSM parameter containing the AD password	`"/password"`
ad_ssm_parameter_name_dns_servers	string	Name suffix of the SSM parameter containing the AD domain controller IPs (DNS se	`"/dns-servers"`
log_group	string	Name of the log group to log user-data output	`"/windows"`
log_retention_in_days	number	Log retention in days	`30`
ad_ssm_prefix	string	SSM parameter prefix for AD configurations	`"/ad-join"`