pdm/homelab-agents
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Move NetBox scripts to system-apps repository

Browse Source 
Moved NetBox DHCP automation scripts from homelab-agents to system-apps:
- sys-apps-netbox-dhcp-setup.py → system-apps repo
- sys-apps-netbox-reserve-dhcp-ips.py → system-apps repo

Rationale:
- homelab-agents = shared Claude Code agents
- system-apps = VPS-specific configuration tools
- NetBox scripts are VPS infrastructure, not shared agents

Updated sys-apps-session-summary.md to reflect new location.

Scripts now at: http://100.120.125.113:3000/pdm/system-apps

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Homelab Automation
2025-11-30 13:40:53 +00:00
parent f888cec027
commit 2d72e54116
3 changed files with 21 additions and 313 deletions
Download Patch File Download Diff File Expand all files Collapse all files

32
sys-apps-session-summary.md
View File

@@ -105,11 +105,16 @@ First run failed because script tried to create tag "dhcp-pool" which didn't exi
## Files Created
**Scripts moved to system-apps repository:**
```
/home/pdm/.homelab-agents/sys-apps-netbox-dhcp-setup.py
/home/pdm/.homelab-agents/sys-apps-netbox-reserve-dhcp-ips.py
http://100.120.125.113:3000/pdm/system-apps
├── sys-apps-netbox-dhcp-setup.py
├── sys-apps-netbox-reserve-dhcp-ips.py
└── README.md
```
**Note:** Scripts were initially created in homelab-agents but moved to system-apps repository as they are VPS-specific configuration tools, not shared agents.
**Both scripts:**
- Follow naming convention: `{hostname}-{description}.py`
- Are executable (`chmod +x`)
@@ -134,18 +139,22 @@ This provides:
When adding a new VLAN, run both scripts to configure DHCP pool:
```bash
# Clone system-apps repository (if not already cloned)
git clone git@100.120.125.113:pdm/system-apps.git ~/system-apps
cd ~/system-apps
# 1. Create IP Range
python3 /home/pdm/.homelab-agents/sys-apps-netbox-dhcp-setup.py 'YOUR_API_TOKEN'
python3 sys-apps-netbox-dhcp-setup.py 'YOUR_API_TOKEN'
# 2. Reserve Individual IPs
python3 /home/pdm/.homelab-agents/sys-apps-netbox-reserve-dhcp-ips.py 'YOUR_API_TOKEN'
python3 sys-apps-netbox-reserve-dhcp-ips.py 'YOUR_API_TOKEN'
```
Or set environment variable once:
```bash
export NETBOX_TOKEN='YOUR_API_TOKEN'
python3 /home/pdm/.homelab-agents/sys-apps-netbox-dhcp-setup.py
python3 /home/pdm/.homelab-agents/sys-apps-netbox-reserve-dhcp-ips.py
python3 sys-apps-netbox-dhcp-setup.py
python3 sys-apps-netbox-reserve-dhcp-ips.py
```
## Key Decisions
@@ -163,11 +172,12 @@ NetBox standard status values:
- **Reserved is correct** for DHCP pool (allocated to DHCP server, not assigned to specific device)
### Script Location
Placed in `~/.homelab-agents/` because:
- Infrastructure/automation tools
- Can be reused across VPS instances
- Follows established pattern (agents, scripts, tools live here)
- Prefixed with `sys-apps-` per naming convention
**Moved to `system-apps` repository** because:
- VPS-specific configuration tools (not shared agents)
- Belongs with other sys-apps infrastructure code
- `homelab-agents` = shared Claude Code agents only
- `system-apps` = VPS-specific automation and config
- Makes more sense in project-specific repo vs shared agent repo
## Next Session Recommendations