Skip to main content

BIRCH System Architecture

This page documents the verified production architecture for the BIRCH backend as of the agent document API rollout.

Verified production components​

ComponentValue
Public hostnamebirchbackend.ihrailsoftware.com
AWS account018772930825
AWS regionus-east-2
Load balancerbirchbackend-lb
Target groupbirchbackend-tg
Current healthy targeti-00f8b6f49c1e4edac:5056
Current production containerbirch_backend_candidate
Production image018772930825.dkr.ecr.us-east-2.amazonaws.com/birch_backend:latest
Rollback containerbirch_backend on port 5055

Important architecture lessons​

  • Public DNS resolves to ALB IPs, not EC2 instance IPs.
  • ALB target group health is the source of truth for live traffic.
  • EC2 running, SSM Online, and ALB target healthy are different states.
  • The previous production container used Docker Hub while the new build pipeline pushes to ECR.
  • Blue/green-style candidate deployment is safer than replacing the live container in place.