diff --git a/tech_docs/networking/iac_github_project.md b/tech_docs/networking/iac_github_project.md index 16bd81a..717f60f 100644 --- a/tech_docs/networking/iac_github_project.md +++ b/tech_docs/networking/iac_github_project.md @@ -1,3 +1,65 @@ +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. + +──────────────────────────────────────── +1. Daily Workflow (30 s) +──────────────────────────────────────── +$ make check # lint + schema + dry-run render +$ git add data/site-03.yml +$ git commit -m "Add Denver hub" + +That’s it. +CI does the rest: renders, diffs, pushes to Nornir. + +──────────────────────────────────────── +2. YAML Skeleton (copy-paste starter) +──────────────────────────────────────── +# data/site-XYZ.yml +hostname: "XYZ-ASR01" +license_level: "network-advantage" +domain_name: "corp.example" +name_servers: ["1.1.1.1", "8.8.8.8"] +tz_name: "EST" +tz_offset: -5 +tacacs_group: "GTAC" +tacacs_servers: + - { host: 10.10.10.1, key: "{{ vault_tacacs_key1 }}" } + - { host: 10.10.10.2, key: "{{ vault_tacacs_key2 }}" } + +interfaces: + Loopback0: { ip: "10.255.255.X/32" } + Tunnel100: + ip: "10.200.100.1/24" + tunnel_source: "Loopback0" +routing: + ospf: + - pid: 1, rid: "10.255.255.X" + bgp: + as: 65400, rid: "10.255.255.X" +qos: {} # leave empty if no QoS yet +acls: [] + +──────────────────────────────────────── +3. Quick Overrides +──────────────────────────────────────── +Need a one-off value? +Put it in the same YAML; deep-merge guarantees it wins over defaults. + +Example: +qos: + policy_maps: + - name: "WAN-OUT" + classes: + - name: "VOICE" + actions: + - { cmd: "priority percent", value: 10 } + +──────────────────────────────────────── +Remember +“Templates are frozen; YAML is the only thing that changes.” + +--- + ```plaintext ──────────────────────────────────────────── OPINIONATED, PRACTICAL GUIDE