Skip to content

2025 11 17 Azure Ascension Jekyll Deployment Quest

Rise, cloud wanderer! This quest guides you through deploying the IT-Journey Jekyll site to Azure Static Web Apps, wiring up CI/CD, and verifying a clean production build.

🎯 Quest Objectives

Primary Objectives

  • Provision Azure Static Web Apps - Create the app and link to GitHub
  • Configure Build & Deploy - Ensure Jekyll build works in CI
  • Secure Secrets - Store keys safely in GitHub
  • Verify Production - Confirm the deployed site loads correctly

🗺️ Quest Prerequisites

📋 Knowledge Requirements

  • Basic GitHub workflow familiarity
  • Comfort with terminal commands
  • Understanding of static sites

🛠️ System Requirements

  • Azure account with permissions to create Static Web Apps
  • GitHub account with repo access

🧙‍♂️ Chapter 1: Prepare the Repository

Ensure dependencies are installed:

bundle install

Verify local build:

bundle exec jekyll build

☁️ Chapter 2: Deploy with the Azure Helper Script

Use the built-in deployment script:

../../scripts/deployment/azure-jekyll-deploy.sh setup
../../scripts/deployment/azure-jekyll-deploy.sh deploy --app-name <your-app-name> --github-repo <your-repo-url>

Follow the prompts for Azure authentication and GitHub workflow setup.

🔐 Chapter 3: Secrets & Workflow Verification

  1. Confirm required GitHub secrets are set.
  2. Open the generated workflow in .github/workflows/.
  3. Trigger a deploy by pushing a small change.

✅ Chapter 4: Validate the Deployment

  • Visit the Azure-provided URL
  • Confirm /quests/ loads correctly
  • Check logs for a successful build

🏁 Quest Completion Checklist

  • Azure Static Web App created and linked
  • CI/CD pipeline runs successfully
  • Site is accessible in production