How tf-landingzone/aws-lz-platform works
This repository is the Terraform engine for an AWS Landing Zone. Its main workflow turns YAML configuration into Terraform variables, then applies the platform stacks in documented order, with a landing-zone stack that orchestrates stacks 01–06. Separate account-provisioning paths run account-setup across individual accounts or launch Step Functions executions from a manifest. The README documents the stack capabilities and ordering; sampled scripts show variable generation and account orchestration. Terraform internals and workflow definitions were not sampled, so edges between those components reflect README statements only.
Main entry points: generate_stack_tfvars.py Stack variables · landing-zone Landing-zone orchestrator · deploy_accounts.py Fleet deployer · config YAML configuration
Components 21
Configuration
- YAML configuration
config - Landing-zone variables
scripts/generate_landing_zone_tfvars.py - Stack variables
scripts/generate_stack_tfvars.py
Landing Zone Platform
- Bootstrap stack
stacks/00-bootstrap - Organizations
stacks/01-organizations - Security
stacks/02-security - Networking
stacks/03-networking - Logging
stacks/04-logging - Operations
stacks/05-operations - Workload support
stacks/06-workload-support - Landing-zone orchestrator
stacks/landing-zone - Permission sets
stacks/permission-sets
Account Operations
- Account setup
stacks/account-setup - Fleet deployer
scripts/deploy_accounts.py - Pipeline launcher
scripts/sfn_launcher.py - Drift report
scripts/generate_drift_report.py
Shared Runtime
- HCL writer
scripts/hcl_writer.py - Deployment run state
Other components
- Platform operator
- AWS Step Functions
- AWS S3
Connections 28
- Platform operator → YAML configuration: edits
README.md - YAML configuration → Landing-zone variables: configures
README.md - YAML configuration → Stack variables: configures
README.md - Landing-zone variables → HCL writer: calls
scripts/generate_landing_zone_tfvars.py - Stack variables → HCL writer: uses
scripts/generate_stack_tfvars.py - Landing-zone variables → Landing-zone orchestrator: writes variables
scripts/generate_landing_zone_tfvars.py - Stack variables → Organizations: generates variables
README.md - Stack variables → Security: generates variables
README.md - Stack variables → Networking: generates variables
README.md - Stack variables → Logging: generates variables
README.md - Stack variables → Operations: generates variables
README.md - Stack variables → Workload support: generates variables
scripts/generate_stack_tfvars.py - Platform operator → Bootstrap stack: applies first
README.md - Landing-zone orchestrator → Organizations: orchestrates
README.md - Landing-zone orchestrator → Security: orchestrates
README.md - Landing-zone orchestrator → Networking: orchestrates
README.md - Landing-zone orchestrator → Logging: orchestrates
README.md - Landing-zone orchestrator → Operations: orchestrates
README.md - Landing-zone orchestrator → Workload support: orchestrates
README.md - Platform operator → Permission sets: deploys
README.md - Platform operator → Fleet deployer: runs
scripts/deploy_accounts.py - Fleet deployer → Account setup: plans and applies
scripts/deploy_accounts.py - Fleet deployer → Deployment run state: reads and writes
scripts/deploy_accounts.py - Fleet deployer → Drift report: produces report for
scripts/generate_drift_report.py - Platform operator → Pipeline launcher: launches
scripts/sfn_launcher.py - Pipeline launcher → AWS S3: uploads manifest
scripts/sfn_launcher.py - Pipeline launcher → AWS Step Functions: starts execution
scripts/sfn_launcher.py - Platform operator → Account setup: provisions account
README.md