# victorroe/project-zomboid-infrastructure-aws architecture

> Architecture diagram of the GitHub repository victorroe/project-zomboid-infrastructure-aws, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/victorroe/project-zomboid-infrastructure-aws
- Repository: https://github.com/victorroe/project-zomboid-infrastructure-aws

## Overview

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: [`playbook/project-zomboid-server-install.yml`](https://github.com/victorroe/project-zomboid-infrastructure-aws/blob/main/playbook/project-zomboid-server-install.yml) (Server Installation), [`terraform/main.tf`](https://github.com/victorroe/project-zomboid-infrastructure-aws/blob/main/terraform/main.tf) (Terraform Config), [`terraform/output.tf`](https://github.com/victorroe/project-zomboid-infrastructure-aws/blob/main/terraform/output.tf) (Server Outputs), [`terraform/templates/user_data.sh.tftpl`](https://github.com/victorroe/project-zomboid-infrastructure-aws/blob/main/terraform/templates/user_data.sh.tftpl) (Bootstrap Template)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_provisioning["Provisioning"]
  node_terraform["Terraform Config<br/>[main.tf]"]
  node_variables["Configuration<br/>[variable.tf]"]
  node_outputs["Server Outputs<br/>[output.tf]"]
  node_user_data["Bootstrap Template<br/>[user_data.sh.tftpl]"]
  node_aws_instance["EC2 Instance"]
end

subgraph group_host_setup["Host Setup"]
  node_ansible_playbook["Server Installation"]
  node_ansible_vars["Host Variables<br/>[main.yml]"]
  node_validation["Host Validation<br/>[validate.yml]"]
  node_admin_password["Admin Credentials<br/>[admin_password.yml]"]
end

subgraph group_operations["Server Operations"]
  node_game_server["Game Server"]
  node_backup_script["Backup Script"]
  node_snapshots[("AWS Snapshots")]
end

node_operator(("Operator"))

node_operator -->|"applies"| node_terraform
node_terraform -.->|"uses config"| node_variables
node_terraform -.->|"provisions"| node_aws_instance
node_terraform -.->|"configures bootstrap"| node_user_data
node_operator -->|"reads IP"| node_outputs
node_outputs -.->|"exposes address"| node_aws_instance
node_user_data -.->|"starts setup"| node_ansible_playbook
node_ansible_playbook -.->|"uses variables"| node_ansible_vars
node_ansible_playbook -.->|"runs validation"| node_validation
node_ansible_playbook -.->|"sets password"| node_admin_password
node_ansible_playbook -.->|"installs server"| node_game_server
node_operator -->|"connects on 16261"| node_game_server
node_backup_script -.->|"backs up"| node_snapshots
node_operator -.->|"runs operations"| node_backup_script
node_game_server -.->|"updates automatically"| node_game_server

click node_terraform "https://github.com/victorroe/project-zomboid-infrastructure-aws/blob/main/terraform/main.tf"
click node_variables "https://github.com/victorroe/project-zomboid-infrastructure-aws/blob/main/terraform/variable.tf"
click node_outputs "https://github.com/victorroe/project-zomboid-infrastructure-aws/blob/main/terraform/output.tf"
click node_user_data "https://github.com/victorroe/project-zomboid-infrastructure-aws/blob/main/terraform/templates/user_data.sh.tftpl"
click node_ansible_playbook "https://github.com/victorroe/project-zomboid-infrastructure-aws/blob/main/playbook/project-zomboid-server-install.yml"
click node_ansible_vars "https://github.com/victorroe/project-zomboid-infrastructure-aws/blob/main/playbook/vars/main.yml"
click node_validation "https://github.com/victorroe/project-zomboid-infrastructure-aws/blob/main/playbook/tasks/validate.yml"
click node_admin_password "https://github.com/victorroe/project-zomboid-infrastructure-aws/blob/main/playbook/tasks/admin_password.yml"
click node_backup_script "https://github.com/victorroe/project-zomboid-infrastructure-aws/blob/main/script/destroy-and-backup.sh"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_terraform,node_variables,node_outputs,node_user_data,node_aws_instance toneBlue
class node_ansible_playbook,node_ansible_vars,node_validation,node_admin_password toneAmber
class node_game_server,node_backup_script,node_snapshots toneMint
class node_operator toneIndigo
```

## Components

### Provisioning

- [Terraform Config](https://github.com/victorroe/project-zomboid-infrastructure-aws/blob/main/terraform/main.tf): `terraform/main.tf`
- [Configuration](https://github.com/victorroe/project-zomboid-infrastructure-aws/blob/main/terraform/variable.tf): `terraform/variable.tf`
- [Server Outputs](https://github.com/victorroe/project-zomboid-infrastructure-aws/blob/main/terraform/output.tf): `terraform/output.tf`
- [Bootstrap Template](https://github.com/victorroe/project-zomboid-infrastructure-aws/blob/main/terraform/templates/user_data.sh.tftpl): `terraform/templates/user_data.sh.tftpl`
- **EC2 Instance**

### Host Setup

- [Server Installation](https://github.com/victorroe/project-zomboid-infrastructure-aws/blob/main/playbook/project-zomboid-server-install.yml): `playbook/project-zomboid-server-install.yml`
- [Host Variables](https://github.com/victorroe/project-zomboid-infrastructure-aws/blob/main/playbook/vars/main.yml): `playbook/vars/main.yml`
- [Host Validation](https://github.com/victorroe/project-zomboid-infrastructure-aws/blob/main/playbook/tasks/validate.yml): `playbook/tasks/validate.yml`
- [Admin Credentials](https://github.com/victorroe/project-zomboid-infrastructure-aws/blob/main/playbook/tasks/admin_password.yml): `playbook/tasks/admin_password.yml`

### Server Operations

- **Game Server**
- [Backup Script](https://github.com/victorroe/project-zomboid-infrastructure-aws/blob/main/script/destroy-and-backup.sh): `script/destroy-and-backup.sh`
- **AWS Snapshots**

### Other components

- **Operator**

## Connections

- Operator → Terraform Config: applies (evidence: `README.md`)
- Terraform Config → Configuration: uses config
- Terraform Config → EC2 Instance: provisions
- Terraform Config → Bootstrap Template: configures bootstrap
- Operator → Server Outputs: reads IP (evidence: `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 (evidence: `README.md`)
- Backup Script → AWS Snapshots: backs up
- Operator → Backup Script: runs operations
- Game Server → Game Server: updates automatically
