Skip to main content

Internal infrastructure handbook

Atlas Infra

Shared AWS and Terraform foundations for the events ingestion API, dashboard backend, Kafka UI, and the operational workflows around them.

Open handbookView updates
Internet
   |
   v
Public ALB (HTTPS)
   |- atlas-ingest...  -> ECS Fargate events ingestion
   |- atlas-back...    -> ECS Fargate dashboard backend -> PostgreSQL RDS
   `- atlas-kafka...   -> ECS Fargate Kafka UI
                           |
                           v
                    Amazon MSK (Kafka)
                      |- internal IAM + TLS
                      |- public IAM + TLS
                      `- optional MSK Connect -> S3

Start here

Operate the platform without digging through the repo

Overview

System overview

Understand the topology, the runtime services, and how the shared edge routes traffic.

Runbook

Bootstrap remote state

Prepare the S3 backend and DynamoDB lock table before the first Terraform init.

Runbook

Deploy environment

Follow the operator path for ECR bootstrap, plan, apply, and post-apply steps.

Reference

Module catalog

Browse the Terraform modules, their responsibilities, and their critical interfaces.

Provisioned here

Network, ingress, compute, streaming, data, and monitoring

This repository owns the shared Atlas AWS footprint, not the application repositories themselves.

IngressALB, TLS, host-based routing, access logs
ComputeECS/Fargate for events, dashboard backend, and Kafka UI
Data and streamingMSK, optional MSK Connect, PostgreSQL RDS, runtime secrets
OperationsCloudWatch logs, alarms, budgets, and runbooks