Fortinet TECWorkshop Template - MVP2

Welcome!
Please check-in for this workshop to proceed (REQUIRED)

This site will explain how to use the Hugo Web Framework & the “reLearn” Theme to effectively organize & deliver Fortinet TEC Workshops & Product demos in a consistent, simple, and visually appealing format.

The beauty of this framework lies in its simplicity. Within approx 30 mins, anybody can have a site up and running. Content is created via Markdown files, and the workshop guide layout is simply a directory structure.

Follow along on this simple tutorial to get up and running with a Hugo formatted site for your TEC Workshop/training/demo content today!

Learning Objectives

  • Setup UserRepo on your system & Build container with Hugo & CentralRepo
  • Learn to work in Hugo to create your content to display proper information flow for your TEC Workshop/demo/training
  • Publish your Hugo site to GitHub pages via a CI/CD model

Hugo and Fortinet TECWorkshops - Visually

  • The purpose of this workflow is to simplify creation of Fortinet TECWorkshop guides while providing an example CI/CD development environment with maximum re-usability
  • Here’s a visual representation of our process which will be fully explained in each chapter
FTNT-hugoFlow
fortinet-hugo (Container)xhugodCentralRepod/layoutsd/staticd/themes/hugo-relearn-themed/contentd/publicf/config.tomlmyTECWkshp (local)dcontent dscriptsddocsfconfig.tomlfDockerfileContenCreation
GitHub Pages
https://fortinetcloudcse.github.io/myTECWkshp
     1: Repo:
      - Request: (email)
      - Create: script w/ Jenkins CI/CD
      - Clone & BranchmyTECWkshp
2: Build Container

MyWorkshopRepo:
- /content - markdown pages
- /scripts - docker cmd
- /docs - hugo built html
-  config.toml - page frontmatter
-  DockerFile - docker build instructions
Jenkins:
- FortiDevSec Scan
Script:
- Branch Protection
- GH Pages w/ /docs folder
- Hugo Install
- Central Repo:
  • layouts - Fortinet customizations
  • static - Fortinet customizations
  • themes - Hugo reLearn theme
3: Run Container
- interactive CLI login
- disk mounts
  • content:content
  • docs:public
  • config.toml:config.toml
- public port 1313 to local OS
4: Hugo:
Content creation
+ build
- Create Hugo Content
- Hugo build (public: docs)
5: GitHub Push
(auto publish
to GH pages)
Git:
- Refresh Main
- PR
- Merge & Push
- Action -->  publish /docs