Hugo on Alok's Notes

Hugo Site CI CD Deployment Guide (GitHub Actions + AWS)

Wed, 24 Jun 2026 14:26:35 +0530

Hugo Site CI/CD Deployment Guide (GitHub Actions + AWS)

Overview

This document describes the complete process for deploying a Hugo static website using:

GitHub
GitHub Actions
Amazon S3
Amazon CloudFront
AWS Certificate Manager (ACM)
Amazon Route53

The resulting architecture is:

GitHub Repository
        |
        v
GitHub Actions
        |
        v
S3 Bucket (Private)
        |
        v
CloudFront Distribution
        |
        v
CloudFront Function
(Index.html Rewrite)
        |
        v
notes.chintanspace.com

Phase 1 - Prepare Hugo Site

Verify Hugo Build

Run locally:

Setup Hugo

Sat, 20 Jun 2026 13:11:56 +0530

Install Hugo

winget install Hugo.Hugo.Extended
hugo version

Install Go

winget install GoLang.Go
go version

Check if git is installed

git --version

Desired folder structure

knowledge/
│
├── book-site/
│   ├── content/docs
│   ├── themes/
│   ├── hugo.toml
│   └── ...
│
├── notes-site/
│   ├── content/docs
│   ├── themes/
│   ├── hugo.toml
│   └── ...
│
├── .github/
│   └── workflows/
│
└── README.md

Create knowledge repository folder

mkdir C:\projects\knowledge
cd C:\projects\knowledge

Create sites

hugo new site book-site
hugo new site notes-site

knowledge/
├── book-site/
└── notes-site/

Initialize Git at the Root

cd knowledge
git init

Add themes

cd knowledge

git submodule add https://github.com/alex-shpak/hugo-book.git book-site/themes/hugo-book

git submodule add https://github.com/adityatelange/hugo-PaperMod.git notes-site/themes/PaperMod

Repository now looks like:

Test

Sat, 20 Jun 2026 13:11:56 +0530

Hello World