Azure Ascension: Deploying Jekyll to the Cloud Kingdom
By IT-Journey Team
Deploy the IT-Journey Jekyll site to Azure Static Web Apps with a clean CI/CD pipeline and safe secrets handling.
Estimated reading time: 1 minutes
Table of Contents
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
- Confirm required GitHub secrets are set.
- Open the generated workflow in
.github/workflows/. - 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