blob: ac10a3781615253229f72d00b3903589d4a4317d (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
|
# Infra
This repository contains the infrastructure configuration for Python Discord, the file structure is as follows:
```yaml
playbook.yml # Root playbook pulling all roles together
inventory.yaml # Ansible Inventory file
ansible.cfg # Ansible Configurartion file
roles/ # Directory containing all Ansible roles
.github/
workflows/ # GitHub Actions Workflows for CI
requirements.txt # Python requirements
```
## Local Environment Setup
1. Create a virtual environment: `python -m venv venv`
1. Activate the virtual environment
- Windows: `.\venv\Scripts\activate`
- Note: [Ansible cannot run on Windows hosts natively](https://docs.ansible.com/ansible/latest/user_guide/windows_faq.html#can-ansible-run-on-windows)
- Linux: `source venv/bin/activate`
1. Update pip and builder deps: `python -m pip install --upgrade pip wheel setuptools`
1. Install project dependancies: `python -m pip install -r requirements.txt`
1. Install the pre-commit hook: `pre-commit install`
1. Create a `vault_passwords` file and write the vault password to it
## Documentation
Infrastructure-related documentation ("the big picture"), once a sufficient
level of infrastructure is established, can be found in [`docs/`](./docs/).
Documentation for our Ansible roles can be found in the `README.md` file of
each role, and role defaults (at `roles/myrole/defaults/main.yml`) contain a
commented view on which variables are configurable for the given role.
|
