Microsoft Azure is an enterprise-grade cloud computing platform that is open and flexible. There are multiple ways to deploy Grav within Azure however this tutorial will walk through using Azure's Web App (PaaS).
First sign up for an account on Azure, you will receive access to free services plus £150 (UK) in credit to use for the first 30 days.
If you do not have a GitHub account set please sign up for one, the free plan is sufficient.
You need a copy of Grav in order to follow this tutorial, I would suggest downloading the basic Grav and Admin Plugin files, and creating a Github repository with those files
You should now have all the necessary components to deploy a working copy of Grav within Azure.
In addition to the Grav code you need a web.config file. The web.config file is an XML file that sits in the root folder of the Web App and generally contains the main settings and configuration for Web App.
An example web.config file is available here. This web.config file, covers off what the Web App should do with file formats such as .woff and .woff2, which are now part of the latest Font Awesome packs.
Grav have also included examples of the web.config files in their source files, you can find them located in the webserver-configs folder.
Once you have your web.config setup, you should upload this to your Grav GitHub repository, it needs to be at the root level.
A new blade will open, describing the Web App service. At the bottom of the page you will find a create button, when you initiate that another blade will open. You will be asked several questions.
My recommendation regarding the App Service Plan would be to select the Dev/Test F1 plan for testing purposes. The plan has some limitations but it will give you the ability to deploy your first Grav site on Azure without incurring any costs. In terms of the location I would select one that is close to your location. Also in this example I would avoid deploying Application Insights as it needs coded in order to integrate with Grav.
Your Web App should deploy within a few minutes.
Composer is a dependency manager for PHP. Composer will manage the dependencies you require on a project by project basis, meaning Composer will pull in all the required libraries, dependencies and for your application. As Grav is a PHP application we need to ensure the Composer is installed on the Web App for Grav to run properly.
In order to do this follow these steps:
- Open up your Web App - Click on the Extensions setting - Click on Add - Select Composer - Click OK
Once Composer has installed on your Web App you are now ready to deploy your code.
Now that your Web App is up and running and you have the code, it is time to deploy it. To do that open up the Web App within the Azure Portal.
Select GitHub as your source
You will be asked for credentials to your GitHub account and then presented with options about which repository and branch to pull from, select the options relevant for you
Azure will now start to pull your code from GitHub, within a few minutes your site should be live
If you wish to use your own website URL, please follow the official documentation.
By default all Azure Web Apps are unloaded if they are idle for some period of time. This is to help conserve resources. If you have selected a Basic or Standard plan you can enable the Always On mode, which will keep the app loaded all the time. The Always On setting can be found within the Application Settings blade in your Web App.
If you have selected one of the Free or Shared Web App Plans for your deployment you will be restricted in regards of storage space and compute resources you can use. To monitor these settings you should monitor the Quotas blade.
Found errors? Think you can improve this documentation? Simply click the Edit link at the top of the page, and then the icon on Github to make your changes.