Featured image of post Automating Hugo Deployments with a Custom Python Script
Website Security Automation Python

Automating Hugo Deployments with a Custom Python Script

Simplifying site management post-launch with lightweight tools.

Moving Forward: Streamlining Hugo Deployments

It’s been a few days since my Hugo-powered site went live, and I’m thrilled with how everything has come together. But now it’s time to focus on making the management process as smooth as possible.

Today, I want to share my first post-launch development: a lightweight Python script I built to automate Hugo site deployments. It’s called Hugo Deploy Manager, and it’s designed to simplify the deployment process for multiple Hugo sites.

Why Automation Matters

One of the things I love about Hugo is how simple and lightweight it is. But deploying changes manually—especially for multiple sites—can quickly become tedious. That’s where automation comes in. By automating the deployment process, I can:

  • Save time.
  • Reduce errors.
  • Focus more on creating content and less on site maintenance.

Introducing Hugo Deploy Manager

To address this, I created Hugo Deploy Manager, a Python utility that automates Hugo site deployments via FTP. It’s available as a public repository here:
https://github.com/ejrojas/hugo_deploy_manager

Features:

  • Automated FTP deployment for Hugo sites.
  • Support for managing multiple sites.
  • Configurable deployment settings per site.
  • Detailed logging for easy troubleshooting.
  • Command-line interface for flexibility.
  • Support for scheduled deployments using cron.

How It Works

The script relies on two configuration files to manage deployments:

  1. Global Configuration (sites_config.yaml)
    Defines the base path to Hugo sites and lists the sites to manage.
  2. Site-specific Configuration (deploy_config.yaml)
    Each Hugo site needs its own configuration file with details like FTP credentials and paths.

Basic Commands:

  • Deploy all configured sites:
   python deploy.py
  • List all configured sites:
python deploy.py --list-sites
  • Deploy a specific site:
python deploy.py --site site1

Automating Deployments:

With cron, you can schedule deployments to run automatically. For example:

0 2,14 * * * cd /path/to/hugo_deploy_manager && python deploy.py

Final Thoughts

I’m excited to see where this project goes, not just for my own site but for other Hugo users who might find it helpful. The simplicity of Hugo combined with the power of automation makes managing static sites a joy.

If you’re interested, check out the repository and give it a try: https://github.com/ejrojas/hugo_deploy_manager

Stay tuned for more updates as I continue to refine this tool and document my experiences. Let’s keep building!