Don't have Azure? Grab a free subscription.
A ton of us use Jekyll for our personal sites and/or blogs.
If you have already have an existing Jekyll based site that is hosted on GitHub, you can easily deploy that site to Azure App Services.
But why? If GitHub Pages is free, then why pay? You might want to:
- push your site to a private repo (instead of public).
- set up “real” SSL, compared to the workarounds.
- take advantage of deployment slots.
I’m sure there are more. Regardless, I think it's an interesting exercise using an incredibly common tool.
I’m assuming you already have a GitHub Pages site that uses Jekyll hosted on GitHub. If that is true, then the first thing that you’ll want to do is grab these three files.
deploy.cmd: a Kudu Deployment script that handles setup and deployment of the web site and ensures Ruby is installed
getruby.cmd: a site that ensure the latest version of Ruby is installed and ensures Jekyll has been built
.deployment: a configuration file that Kudu understands that calls the deploy.cmd script
Gemfile: you probably already have this but ensure it is there and if not then just copy mine.
Once you have these three files, ensure they are in the root of your public GitHub pages site (e.g.
You’ll want to go inside of your Azure Portal (or use the CLI tools) and create a Web App under App Service. Once the site is deployed, then go to Deployment Options and select GitHub, your project and press
You should see
Setup up Deployment Source… in the notification window. You’ll probably want to wait a good 15 to 20 minutes for Azure to setup everything. You can stay on the
Deployment Options blade and you should see the status of the deployment.
After a while you see a check mark that it completed successfully. Now you can navigate to the URL listed on the
And... you're done! Check it out. That was easy, right?!
Ready to go beyond Jekyll? Check out Azure's App Service documentation for language-specific quickstarts.
We'll be posting articles every day in April, so stay tuned! Or jump ahead and check out more tips and tricks now.