This repository contains the infrastructure configuration for Python Discord, the file structure is shown below, with well known files omitted for brevity:
.github/
└── workflows/ # GitHub Actions Workflows for CI
ansible/
├── host_vars/ # Host specific Ansible variables
├── inventory/ # Ansible Inventory files
├── local_testing/ # Vagrant configuration to test Ansible playbook locally using VMs
├── roles/ # Directory containing all Ansible roles
├── .ansible-lint # Configuration for ansible lint
├── ansible.cfg # Ansible Configurartion file
└── playbook.yml # Root playbook pulling all roles together
dns/
├── zones/ # Zone configuration for each supported DNS Zone
└── production.yaml # Configuration for OctoDNS planning and deployment
docs/
└── meeting_notes/ # Minutes for previous devops meetings
kubernetes/
├── cluster-wide-secrets/ # Kubernetes secrets shared by multiple pods across namespaces
├── namespaces/ # Kubernetes manifests, separated by namespace
└── scripts/ # Scripts used to lint manifests in CI
.pre-commit-config.yaml # pre-commit configuration
pyproject.toml # tooling dependencies
server_bootstrap.sh # A bash script used to init our bare metal servers
Infrastructure-related documentation ("the big picture"), can be found in docs/.
Many folders have a README.md file within them, which have more detailed explanations on what
that folder, and the files within, is used for.
To lint everything with pre-commit locally, run the command
$ uv run task lint
Any trivial errors (formatting, minor linting problems) will automatically be fixed.