Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ciscodevnet/appdynamics-terraform-ecs-fargate
AppDynamics: ECS Fargate instrumentation using Terraform
https://github.com/ciscodevnet/appdynamics-terraform-ecs-fargate
appdynamics ecs fargate terraform
Last synced: 3 months ago
JSON representation
AppDynamics: ECS Fargate instrumentation using Terraform
- Host: GitHub
- URL: https://github.com/ciscodevnet/appdynamics-terraform-ecs-fargate
- Owner: CiscoDevNet
- License: apache-2.0
- Created: 2021-02-24T12:21:41.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2021-08-03T22:49:32.000Z (over 3 years ago)
- Last Synced: 2024-04-10T16:21:27.616Z (10 months ago)
- Topics: appdynamics, ecs, fargate, terraform
- Language: HCL
- Homepage:
- Size: 52.7 KB
- Stars: 9
- Watchers: 4
- Forks: 8
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: security-groups/sg-main.tf
Awesome Lists containing this project
README
# AppDynamics: ECS Fargate instrumentation using Terraform
Amazon Elastic Container Service (ECS) is a scalable container management service that makes it easy to run, stop, and manage Docker containers on Amazon EC2 clusters.
This project demonstrates how AppDynamics agents can be embedded into an existing ECS/Fargate setup using Terraform.
The primary considerations that went into the design of this project are:
- Customers' existing container images and/or the image build process should be unaltered.
- The deployment process must remain immutable.
- Idempotency - customers should get the same instrumentation result even if the terraform config is applied multiple times.
- AppDynamics access key must be stored and accessed from AWS secret manager, not as plaintext.
In addition, we leveraged on AWS CloudFormation's `DependsOn` attribute to:
- Dynamically acquire the AppDynamics agent image from DockerHub. You may copy the image to your prefered registry.
- Copy the content of the agent image into an ephemeral volume, then
- Mount the shared volume into the main application's container at runtime.
# Resources
This demo creates the following AWS resources:
- VPC
- One public and one private subnet per AZ
- Routing tables for the subnets
- Internet Gateway for public subnets
- NAT gateways with attached Elastic IPs for the private subnet
- Security groups - that allows access to the specified container port
- An Application Load Balancer (ALB) - with listeners for port 80
- An ECS cluster with a service - including auto-scaling policies for CPU and memory usage
- Task definition to run docker containers - an init container for `AppDynamics` and the main container application
- IAM execution role
- Secrets - Creates secrets in Secret Manager
(Source: https://aws.amazon.com/de/blogs/compute/task-networking-in-aws-fargate/)
# AppDynamics Specific Changes
- The main logic is in the `template/app.json.tpl` file. Please review the `DependsOn` section and the AppDynamics environment variables.
- Create AppDyamics secret in `secrets.auto.tfvars` Remove .example from the file name.
- Populate `appdynamics.auto.tfvars` with your controller credentials and the agent's container registry.
# Run it
First, you will need to set up the Terraform provider to talk to your AWS account. Please refer to `main.tf`
```yaml
provider "aws" {
access_key = var.aws-access-key
secret_key = var.aws-secret-key
region = var.aws-region
version = "~> 2.0"
}
```
You can also leave out access_key and secret_key; then Terraform will use the profile values stored in your .aws/config.
Next, execute the following commands:
#### Initialise Terraform
`$ terraform init`
#### View Proposed execution plan
`$ terraform plan`
#### Executes the Terraform run
`$ terraform apply`
#### Delete all
`$ terraform destroy`