How oskarvid/terra-ble works
Key Components to Include:
Main System Components
• Terraform Infrastructure Layer
• Ansible Configuration Layer
• Target Infrastructure (Cloud/Local)
Component Organization
A. Terraform Section:
• Main Configuration (main.tf)
• Provider Configuration (providers.tf)
B. Ansible Section:
• Core Playbook (main.yml)
• Specialized Playbooks:
• Basic Configuration
• Disk Management
• Docker Setup
• Ansible Installation
• Cloud configuration integration (clouds.yml)
[Infrastructure Definition Layer]
• Terraform Components
• Provider Configuration
• Infrastructure Specs
• Ansible Components
• Main Playbook
• Specialized Playbooks
• Basic Config
• Disk Management
• Docker Setup
• Ansible Installation
Labels
• Clear component names
• File paths where relevant
• Brief descriptions of component purposes
Modular nature
• How main.yml imports other playbooks
• Optional/modular components
Infrastructure Flow
• Demonstrate the sequence:
1. Terraform provisioning
2. Ansible configuration
3. Target system state
Configuration Management
• How clouds.yml template integrates
• Local vs. remote execution paths
Modularity
• Use grouped containers to show related components
• Optional/required components
Level of Detail:
• Keep high-level architecture visible
• Major component relationships
• File names for key configuration files
• Execution flow and dependencies
• Abstract implementation details unless crucial