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 lintAny trivial errors (formatting, minor linting problems) will automatically be fixed.