How victorroe/project-zomboid-infrastructure-aws works
This repository provisions a Project Zomboid dedicated server on a single AWS EC2 instance using Terraform and Ansible. The main workflow is an operator applying Terraform, then connecting to the server using its public IP and game port. The README also identifies automatic game updates and snapshot-based backups as capabilities. The tree shows the relevant Terraform, Ansible, and backup-script paths, but no source excerpts were provided, so internal call relationships are not verified; dashed edges indicate documented or plausible workflow links.
Main entry points: project-zomboid-server-install.yml Server Installation · main.tf Terraform Config · output.tf Server Outputs · user_data.sh.tftpl Bootstrap Template
Components 13
Provisioning
- Terraform Config
terraform/main.tf - Configuration
terraform/variable.tf - Server Outputs
terraform/output.tf - Bootstrap Template
terraform/templates/user_data.sh.tftpl - EC2 Instance
Host Setup
- Server Installation
playbook/project-zomboid-server-install.yml - Host Variables
playbook/vars/main.yml - Host Validation
playbook/tasks/validate.yml - Admin Credentials
playbook/tasks/admin_password.yml
Server Operations
- Game Server
- Backup Script
script/destroy-and-backup.sh - AWS Snapshots
Other components
- Operator
Connections 15
- Operator → Terraform Config: applies
README.md - Terraform Config → Configuration: uses config
- Terraform Config → EC2 Instance: provisions
- Terraform Config → Bootstrap Template: configures bootstrap
- Operator → Server Outputs: reads IP
README.md - Server Outputs → EC2 Instance: exposes address
- Bootstrap Template → Server Installation: starts setup
- Server Installation → Host Variables: uses variables
- Server Installation → Host Validation: runs validation
- Server Installation → Admin Credentials: sets password
- Server Installation → Game Server: installs server
- Operator → Game Server: connects on 16261
README.md - Backup Script → AWS Snapshots: backs up
- Operator → Backup Script: runs operations
- Game Server → Game Server: updates automatically