1.3 KiB
1.3 KiB
A Django app for managing computer equipment.
Installation
Install system dependencies:
sudo apt install python-dev libldap2-dev libsasl2-dev bind9-utils
Use mise to manage Python and uv:
mise trust
mise install
Install Python dependencies with uv:
uv sync
Run migrations and start the development server:
uv run python manage.py migrate
uv run python manage.py runserver
mise.toml sets DJANGO_DEBUG=1; without it DEBUG is off. Local overrides go in
mdbsite/local_settings.py.
Production
MDB runs on sega under edb-infra's mdb role (roles/mdb.md there): gunicorn from a
release directory per commit, its settings in the file MDB_SETTINGS names
(/etc/mdb/settings.py), which mdbsite/settings.py executes last. A push to main that
passes the tests and prek deploys itself while the repository variable DEPLOY_SEGA is true
(.gitea/workflows/ci.yaml). The DNS and DHCP sync runs as root on sega:
sudo mdb-sync.
Development tasks
Dump test data:
uv run python manage.py dumpdata mdb --natural-foreign --indent=4 > mdb/fixtures/test_data.json
Features
- Creates DHCPD configuration files
- Creates DNS zone files for BIND
- Netboots hosts marked PXE installable, by setting their DHCP boot filename
- Partial IPv6 support