Skip to content

Commit 3a0df60

Browse files
Hugo version bump & network diagram guide
1 parent e53d893 commit 3a0df60

File tree

6 files changed

+29
-30
lines changed

6 files changed

+29
-30
lines changed

.devcontainer/Dockerfile

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ FROM mcr.microsoft.com/devcontainers/base:ubuntu
33

44
ENV DEBIAN_FRONTEND=noninteractive
55
ENV SHELL=/usr/bin/zsh
6-
ENV HUGO_VERSION 0.145.0
6+
ENV HUGO_VERSION 0.147.5
77

88
RUN apt-get update -y && apt-get install -y \
99
wget \

.github/workflows/hugo.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ jobs:
3232
build:
3333
runs-on: ubuntu-latest
3434
env:
35-
HUGO_VERSION: 0.145.0
35+
HUGO_VERSION: 0.147.5
3636
steps:
3737
- name: Install Hugo CLI
3838
run: |

Dockerfile

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
FROM ubuntu:latest
33

44
ENV DEBIAN_FRONTEND=noninteractive
5-
ENV HUGO_VERSION=0.145.0
5+
ENV HUGO_VERSION=0.147.5
66

77
RUN apt-get update -y && apt-get install -y \
88
wget \

site/content/posts/network-diagram-guide/01-intro/featured.svg

Lines changed: 5 additions & 0 deletions
Loading
Lines changed: 21 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
+++
22
title = "Network Diagram Guide - Intro"
3-
date = "2025-06-02"
3+
date = "2025-06-12"
44
description = "A guide to drawing better Network Diagrams"
55
tags = [
66
"network engineering",
@@ -14,7 +14,6 @@ series = [
1414
]
1515
series_order = 1
1616
showComments = "true"
17-
draft = "true"
1817
+++
1918

2019
## Introduction
@@ -27,44 +26,39 @@ This article deals with the tools I have used to document, plan & draw diagrams.
2726

2827
Excel as a Network Diagram tool? I have surprisingly seen topology diagrams in excel before but generally it is used to draw up Elevation/Rack diagrams and data center floor plans.
2928

29+
Excel does shine here as it is very quick to mock something up and make quick changes while planning a build, but you should move this data to a proper DCIM product once you've completed your planning and are ready to build.
3030

31+
See an example Excel file below to see an example of what I have used in the past to plan a rack build. Also comes with an automatically updating Data tab that you can export as a CSV to import into another system once you're ready
3132

32-
Let's start with the bane of every Network Engineers existence, Excel. We have all had to deal with an IP address spreadsheet sometime in our lives.
33+
[Example File](./static/cc-rack-design.xlsx)
3334

34-
It is very easy to spin up a basic network source of truth these days.
35+
## Excalidraw
3536

36-
Where Excel is does shine is its speed
37+
[Excalidraw](https://excalidraw.com/) is a free online & open source whiteboard. It is now my replacement for the old MSPaint or a Physical whiteboard (especially in a post covid world). It is very quick to open up and start drawing whatever you want. Great for concepts or just having that nice whiteboard look on a presentation or wiki article. Being able to export as a SVG file as well ensures your drawing looks great no matter what size it is.
3738

38-
## Visio
39+
All the images on this blog have been drawn using it!
3940

41+
## Visio
4042

41-
## draw.io
43+
Visio is the defacto tool that most engineers have come across in their careers to draw pretty much any type of diagram you can think of. It's great for Elevation, Physical, Logical, Data Flow, etc. diagrams and has the most vendor provided stencils of any solution. The downside of course is that it is not free, and the place you are working at may not have it included in their 365 subscription.
4244

45+
## diagrams.net
4346

44-
## Excalidraw
47+
[diagrams.net](https://app.diagrams.net/) (previously draw.io) is a free web-based diagram tool that is pretty much functionally the same as Visio. Compared to Visio it does offer a lot of advantages a few disadvantages:
4548

49+
Advantages:
4650

47-
## other
51+
- Free
52+
- Runs on your browser, also has an optional offline App
53+
- Ability to export as SVG
54+
- Integration with GitHub, Notion & Confluence/JIRA
4855

49-
The ready to go example lab for this article is the [basic-nornir](https://github.com/commitconfirmed/npa-showcases/tree/main/examples/basic-nornir) topology. Navigate into this directory and execute `manage.sh build` & `manage.sh run`
56+
Disadvantages:
5057

51-
{{< alert >}}
52-
**Note:** If this is your first time here, see the [NPA Showcases](/npa-showcases) documentation for initial installation steps on your local machine or a GitHub codespace
53-
{{< /alert >}}
58+
- Limited Networking Vendor and other Stencils
5459

55-
## Topology
60+
This is my personal tool of choice these days to do my Network Diagramming unless I need to present very specific diagrams that go down to the physical hardware level.
5661

57-
The folder structure of our Nornir server is below
62+
## Tips & Tricks
5863

59-
| File | Description |
60-
| --- | --- |
61-
| `/app/config.yml` | Our basic Nornir config file |
62-
| `/app/inventory/defaults.yml` | Default inventory variables, applies to all hosts |
63-
| `/app/inventory/groups.yml` | Group inventory variables, applies to hosts in this group |
64-
| `/app/inventory/hosts.yml` | Host inventory variables, specific to the host |
65-
| `/app/tasks/task-inventory.py` | Example task showing inventory management |
66-
| `/app/tasks/task-napalm.py` | Example task to interact with devices using NAPALM plugin |
67-
| `/app/tasks/task-netmiko.py` | Example task to interact with devices using NETMIKO plugin |
68-
| `/app/tasks/task-scrapli.py` | Example task to interact with devices using SCRAPLI plugin |
69-
| `/app/templates/ceos1.j2` | Jinja2 template for our cEOS device |
70-
| `/app/templates/crpd1.j2` | Jinja2 template for our cRPD device |
64+
TBD
Binary file not shown.

0 commit comments

Comments
 (0)