terraform-aws-atlantis

This Terraform module automates the deployment of the Atlantis server on an ECS cluster with self-managed EC2 instances. It includes the configuration of an Application Load Balancer (ALB) for traffic routing. The module simplifies the process of setting up and managing Atlantis, enabling automated Terraform pull request workflows.

---

Architectural Diagram

---

Requirements

Name	Version
terraform	>= 1.6.0
aws	>= 5.5.0

Providers

Name	Version
aws	>= 5.5.0

Modules

Name	Source	Version
ecs_deployment	infraspecdev/ecs-deployment/aws	4.0.4

Resources

Name	Type
aws_iam_openid_connect_provider.google	resource
aws_iam_role.task_role	resource
aws_route53_record.record	resource
aws_security_group.alb	resource
aws_security_group.ecs	resource
aws_ecs_cluster.default	data source
aws_iam_policy_document.ecs_task_assume_policy	data source
aws_route53_zone.zone	data source
aws_ssm_parameter.environment	data source
aws_vpc.selected	data source

Inputs

Name	Description	Type	Default	Required
atlantis_docker_image	The Docker image to use for the Atlantis server	string	"ghcr.io/runatlantis/atlantis:v0.28.5"	no
atlantis_gh_user	The GitHub username used by Atlantis to access repositories	string	n/a	yes
atlantis_repo_allowlist	Comma delimited string containing repos to use atlantis	string	n/a	yes
atlantis_url	Full URL for the Atlantis server	string	n/a	yes
ecs_cluster_name	The name of the ECS cluster	string	"default"	no
ecs_launch_type_cpu	EC2 instance CPU	number	null	no
ecs_launch_type_memory	EC2 instance memory	number	null	no
ecs_service_desired_count	(Optional) Number of instances of the task definition to place and keep running.	number	null	no
private_subnet_ids	List of Private subnet ids to deploy Atlantis server.	list(string)	n/a	yes
public_subnet_ids	List of Public subnet ids to deploy application load balancers.	list(string)	n/a	yes
thumbprint_list	The thumbprint of the OIDC provider	list(string)	[ "e252aa6e92432f32cbc1b182056627c239652678" ]	no
vpc_id	VPC ID for creating Atlantis Resources.	string	n/a	yes

Outputs

Name	Description
atlantis_url	The URL for Atlantis.