Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/meltwater/terraform-aws-asg-dns-handler
Terraform module for dynamically setting hostnames following a pattern on instances in AWS Auto Scaling Groups
https://github.com/meltwater/terraform-aws-asg-dns-handler
asg asg-dns-handler automation-drone clientdata-no coe-universal-solutions department-130 department-460 lifecycle-maintenance purpose-library team-a-team team-foundation terraform terraform-module usage-public
Last synced: 2 days ago
JSON representation
Terraform module for dynamically setting hostnames following a pattern on instances in AWS Auto Scaling Groups
- Host: GitHub
- URL: https://github.com/meltwater/terraform-aws-asg-dns-handler
- Owner: meltwater
- License: apache-2.0
- Created: 2019-01-07T22:00:43.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2024-11-28T12:04:00.000Z (about 2 months ago)
- Last Synced: 2025-01-12T08:12:12.399Z (9 days ago)
- Topics: asg, asg-dns-handler, automation-drone, clientdata-no, coe-universal-solutions, department-130, department-460, lifecycle-maintenance, purpose-library, team-a-team, team-foundation, terraform, terraform-module, usage-public
- Language: Python
- Homepage: https://registry.terraform.io/modules/meltwater/asg-dns-handler
- Size: 85 KB
- Stars: 76
- Watchers: 16
- Forks: 46
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# ASG DNS handler | [](https://cloud.drone.io/meltwater/terraform-aws-asg-dns-handler)
This Terraform module sets up everything necessary for dynamically setting hostnames following a certain pattern on instances spawned by AWS Auto Scaling Groups (ASGs).
Learn more about our motivation to build this module in our blog post [Dynamic Route53 records for AWS Auto Scaling Groups with Terraform](https://underthehood.meltwater.com/blog/2020/02/07/dynamic-route53-records-for-aws-auto-scaling-groups-with-terraform/).
## Maintainers
This repository and the module it houses are maintained Foundation Missions A-Team. Should you encounter issues or require changes to code maintained in this repository, please reachout through an issue that is part of this project.
## Requirements
- [Terraform](https://www.terraform.io/downloads.html) 0.12+ and [Terraform AWS provider](https://github.com/terraform-providers/terraform-provider-aws) 2.0+ use v2+ releases
- [Terraform](https://www.terraform.io/downloads.html) 0.11 and below, [Terraform AWS provider](https://github.com/terraform-providers/terraform-provider-aws) 2.0.14 and below use v1.x releases
## How do I use it?
Create an ASG and set the `asg:hostname_pattern` tag for example like this:
```
asg-test-#instanceid.asg-handler-vpc.testing@Z3QP9GZSRL8IVA
```
`#instanceid` is converted by a Lambda function within this module to the actual AWS instance_id that corresponds to the launched instance. The `@` symbol is used to split the FQDN from the Route 53 zone_id.
This could be interpolated in Terraform like this:
```hcl
tag {
key = "asg:hostname_pattern"
value = "${var.hostname_prefix}-#instanceid.${var.vpc_name}.testing@${var.internal_zone_id}"
propagate_at_launch = true
}
```
Once you have your ASG set up, you can just invoke this module and point to it:
```hcl
module "clever_name_autoscale_dns" {
source = meltwater/asg-dns-handler/aws"
version = "~> 2.0"
# use_public_ip = true
# route53_record_ttl = 300
autoscale_handler_unique_identifier = "clever_name"
autoscale_route53zone_arn = "ABCDEFGHIJ123"
vpc_name = "my_vpc"
}
```
## How does it work?
The module sets up these things:
1. A SNS topic
2. A Lambda function
3. A topic subscription sending SNS events to the Lambda function
The Lambda function then does the following:
- Fetch the `asg:hostname_pattern` tag value from the ASG, and parse out the hostname and Route53 zone ID from it.
- If it's an instance being **created**
- Fetch internal IP from EC2 API
- Create a Route53 record pointing the hostname to the IP
- Set the Name tag of the instance to the initial part of the generated hostname
- If it's an instance being **deleted**
- Fetch the internal IP from the existing record from the Route53 API
- Delete the record
## Setup
Add `initial_lifecycle_hook` definitions to your `aws_autoscaling_group` resource , like so:
```hcl
resource "aws_autoscaling_group" "my_asg" {
name = "myASG"
vpc_zone_identifier = var.aws_subnets
min_size = var.asg_min_count
max_size = var.asg_max_count
desired_capacity = var.asg_desired_count
health_check_type = "EC2"
health_check_grace_period = 300
force_delete = false
launch_configuration = aws_launch_configuration.my_launch_config.name
lifecycle {
create_before_destroy = true
}
initial_lifecycle_hook {
name = "lifecycle-launching"
default_result = "ABANDON"
heartbeat_timeout = 60
lifecycle_transition = "autoscaling:EC2_INSTANCE_LAUNCHING"
notification_target_arn = module.autoscale_dns.autoscale_handling_sns_topic_arn
role_arn = module.autoscale_dns.agent_lifecycle_iam_role_arn
}
initial_lifecycle_hook {
name = "lifecycle-terminating"
default_result = "ABANDON"
heartbeat_timeout = 60
lifecycle_transition = "autoscaling:EC2_INSTANCE_TERMINATING"
notification_target_arn = module.autoscale_dns.autoscale_handling_sns_topic_arn
role_arn = module.autoscale_dns.agent_lifecycle_iam_role_arn
}
tag {
key = "asg:hostname_pattern"
value = "${var.hostname_prefix}-#instanceid.${var.vpc_name}.testing@${var.internal_zone_id}"
propagate_at_launch = true
}
}
module "autoscale_dns" {
source = "meltwater/asg-dns-handler/aws"
version = "2.1.7"
autoscale_handler_unique_identifier = "my_asg_handler"
autoscale_route53zone_arn = var.internal_zone_id
vpc_name = var.vpc_name
}
```
## Developers Guide / Contributing
Please read [CONTRIBUTING.md](CONTRIBUTING.md) to understand how to submit pull requests to us, and also see our [Code of Conduct](CODE_OF_CONDUCT.md).
## Difference between Lifecycle action
Lifecycle_hook can have `CONTINUE` or `ABANDON` as default_result. By setting default_result to `ABANDON` will terminate the instance if the lambda function fails to update the DNS record as required. `Complete_lifecycle_action` in lambda function returns `LifecycleActionResult` as `CONTINUE` on success to Lifecycle_hook. But if lambda function fails, Lifecycle_hook doesn't get any response from `Complete_lifecycle_action` which results in timeout and terminates the instance.
At the conclusion of a lifecycle hook, the result is either ABANDON or CONTINUE.
If the instance is launching, CONTINUE indicates that your actions were successful, and that the instance can be put into service. Otherwise, ABANDON indicates that your custom actions were unsuccessful, and that the instance can be terminated.
If the instance is terminating, both ABANDON and CONTINUE allow the instance to terminate. However, ABANDON stops any remaining actions, such as other lifecycle hooks, while CONTINUE allows any other lifecycle hooks to complete.
## License and Copyright
This project was built at Meltwater. It is licensed under the [Apache License 2.0](LICENSE).