medusa/the_information_nexus
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update tech_docs/networking/iac_github_project.md

Browse Source
This commit is contained in:
medusa
2025-08-02 14:19:35 -05:00
parent e5748d3a31
commit ae4d0ca880
1 changed files with 10 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
tech_docs/networking/iac_github_project.md
View File

@@ -1,9 +1,9 @@
Here’s a one-page cheat-sheet you can tape to your monitor. Here’s a one-page cheat-sheet you can tape to your monitor.
It distills the whole document into three things you actually touch every day. It distills the whole document into three things you actually touch every day.
──────────────────────────────────────── ---
1. Daily Workflow (30 s) 1. Daily Workflow (30 s)
──────────────────────────────────────── ---
$ make check # lint + schema + dry-run render $ make check # lint + schema + dry-run render
$ git add data/site-03.yml $ git add data/site-03.yml
$ git commit -m "Add Denver hub" $ git commit -m "Add Denver hub"
@@ -11,9 +11,9 @@ $ git commit -m "Add Denver hub"
That’s it. That’s it.
CI does the rest: renders, diffs, pushes to Nornir. CI does the rest: renders, diffs, pushes to Nornir.
──────────────────────────────────────── ---
2. YAML Skeleton (copy-paste starter) 2. YAML Skeleton (copy-paste starter)
──────────────────────────────────────── ---
# data/site-XYZ.yml # data/site-XYZ.yml
hostname: "XYZ-ASR01" hostname: "XYZ-ASR01"
license_level: "network-advantage" license_level: "network-advantage"
@@ -39,9 +39,9 @@ routing:
qos: {} # leave empty if no QoS yet qos: {} # leave empty if no QoS yet
acls: [] acls: []
──────────────────────────────────────── ---
3. Quick Overrides 3. Quick Overrides
──────────────────────────────────────── ---
Need a one-off value? Need a one-off value?
Put it in the same YAML; deep-merge guarantees it wins over defaults. Put it in the same YAML; deep-merge guarantees it wins over defaults.
@@ -54,18 +54,17 @@ qos:
actions: actions:
- { cmd: "priority percent", value: 10 } - { cmd: "priority percent", value: 10 }
──────────────────────────────────────── ---
Remember Remember
“Templates are frozen; YAML is the only thing that changes.” “Templates are frozen; YAML is the only thing that changes.”
--- ---
```plaintext
──────────────────────────────────────────── ---
OPINIONATED, PRACTICAL GUIDE OPINIONATED, PRACTICAL GUIDE
“How to Ship the Right Config to Every ASR-1002 DMVPN Hub—Forever” “How to Ship the Right Config to Every ASR-1002 DMVPN Hub—Forever”
──────────────────────────────────────────── ---
```
0. One-Sentence Rule 0. One-Sentence Rule
Policy (templates) never changes per box; Data (YAML) is the **only** thing that changes. Policy (templates) never changes per box; Data (YAML) is the **only** thing that changes.