Back to blog

Migrating to MarkHazleton.com: A Comprehensive Guide

September 16, 20245 min read

Moving a blog from one domain to another is mostly a DNS exercise — until it isn't. Migrating from markhazleton.controlorigins.com to markhazleton.com on Azure Static Web Apps with Cloudflare DNS surfaced the small details that decide whether a cutover is clean or quietly breaks SEO.

Content Strategy Series — 8 articles
  1. Embracing Azure Static Web Apps for Static Site Hosting
  2. Migrating to MarkHazleton.com: A Comprehensive Guide
  3. Automate GitHub Profile with Latest Blog Posts
  4. Syntax Highlighting with Prism.js for XML, PUG, YAML, and C#
  5. Canonical URL Troubleshooting for Static Web Apps
  6. Developing MarkHazleton.com: Tools and Approach
  7. Getting Started with PUG: History and Future
  8. Mastering Blog Management Tools

Screaming Frog SEO Spider Tutorial

Migrating to MarkHazleton.com: A Comprehensive Guide

Subtitle: Streamline Your Blog Migration with Azure and Cloudflare

Summary

Moving a blog from one domain to another is mostly a DNS exercise — until it isn't. The cutover from markhazleton.controlorigins.com to markhazleton.com surfaced the small details that decide whether a migration is clean or quietly breaks SEO: where canonical URLs live, how Azure Static Web Apps handles custom domains, and the order in which Cloudflare DNS records have to flip. Worth walking through the moves I made and the ones I'd do differently next time.

Understanding the Migration Process

Migrating a website involves several key steps, including setting up the new hosting environment, transferring content, configuring DNS settings, and testing the new setup. Each of these steps is crucial to ensure that the website functions correctly on the new domain.

1. Setting Up Azure Static Web Apps

Azure Static Web Apps is a service that allows you to host static websites with ease. Here’s how to set it up:

  • Create a new Static Web App: Log into your Azure account and navigate to the Static Web Apps service. Click on 'Create' to start a new project.
  • Configure the deployment: Connect your GitHub repository to Azure to automate the deployment process. This ensures that any updates to your blog are automatically reflected on the live site.
  • Choose your build settings: Specify the build settings for your project, including the root directory and build commands.

2. Transferring Content

Once your hosting environment is ready, the next step is to transfer your blog content:

  • Backup your existing site: Before making any changes, ensure that you have a complete backup of your current site.
  • Migrate your files: Use an FTP client or Git to transfer your files to the new Azure environment.
  • Update configurations: Ensure that all configuration files are updated to reflect the new domain settings.

3. Configuring Cloudflare DNS

Cloudflare provides a robust DNS management service that can help improve your site’s performance and security:

  • Add your domain to Cloudflare: Sign up for a Cloudflare account and add your new domain.
  • Update DNS records: Configure the DNS settings to point to the Azure Static Web App.
  • Enable security features: Take advantage of Cloudflare’s security features such as SSL certificates and DDoS protection.

4. Testing and Finalizing the Migration

Before going live, it’s important to test your new setup:

  • Check all links and resources: Ensure that all internal links and resources are functioning correctly.
  • Test site performance: Use tools like Google PageSpeed Insights to test the performance of your site.
  • Monitor for issues: Keep an eye on your site’s analytics and error logs to catch any issues early.

Conclusion

Migrating your blog to a new domain can be a complex process, but with careful planning and execution, it can be done smoothly. By using Azure Static Web Apps and Cloudflare, you can ensure that your site is fast, secure, and reliable.

Reflections on the Migration

Migrating a blog to a new domain is one of those projects that looks straightforward on paper but reveals complexity at every turn. DNS propagation timing, redirect chains, SSL certificate provisioning — each step has its own failure modes that only surface under real conditions.

What made this migration manageable was leaning on Azure Static Web Apps for hosting and Cloudflare for DNS and caching. The combination handled most of the heavy lifting, leaving me to focus on content integrity and link preservation. The lesson I keep coming back to: invest the time upfront in testing redirects and validating links. The cost of broken URLs compounds quickly once search engines have indexed the old paths.