Deploy the Hexo Boilerplate
Deploy a Hexo single-page application to Azion from the Hexo Boilerplate template, which creates a GitHub repository, an application, and a function.
You can deploy a Hexo single-page application (SPA) to Azion from the Hexo Boilerplate template in Azion Console. To create an application without a template, refer to Applications quickstart.
The template automates the steps from repository management to deployment. It uses Hexo 6.3.0.
The deployment creates an application and its domain to host your project. It also creates a function for custom logic and a GitHub repository for the source code. The template uses Functions, and its usage can generate costs. For more information, refer to Pricing.
Prerequisites
- An Azion account. To create one, refer to Create an account.
- Access to Azion Console. To sign in, refer to Access Azion Console.
- A GitHub account. Azion connects to it and creates the project’s repository there.
Deploy the template
The Hexo Boilerplate opens as a configuration form in Azion Console, and an asterisk marks each mandatory field.
To deploy the template:
Go to Hexo Boilerplate in Azion Console. The configuration form opens.
A window opens to confirm the installation of the Azion GitHub App, which connects your GitHub account with Azion. In that window, define the app’s permissions and repository access.
Enter a unique name that you can remember. The storage bucket and the function that the template creates take the same name. If the name is already in use, the platform returns an error message.
A window shows the deployment logs while it runs. When the deployment completes, the page shows the application’s details, a browser link to it, and options to continue.
The deployment script also commits the deployment details to the repository, including the version deployed and its timestamp. These commits keep a history of the project’s deployments.
The link can take a few minutes to start serving the application, while its configuration propagates across Azion’s distributed infrastructure. If the page does not load, wait a few minutes and open the link again.
Update the project
The GitHub repository that the Hexo Boilerplate creates holds the project’s dependencies and a GitHub Action for continuous deployment. Every push to the repository deploys automatically.
To update the deployed project, push your changes to that repository. Azion deploys them, and the application serves the new version.
Manage the application
The settings that the Hexo Boilerplate applies may not fit your application. You can change any of them at any time from Azion Console.
To open the application’s settings:
Access Azion Console > Applications. The list shows every application you created, in alphabetical order.
To find it in a long list, search by its name. The search filters the list by application name only.
The application opens on a page that holds every setting you can configure. For more information, refer to Main Settings, Rules Engine for Applications, and Device Groups.
Add a custom domain
The Hexo Boilerplate deployment assigns the application a workload domain in the format xxxxxxxxxx.map.azionedge.net, which a browser can open. To serve the application from a domain you own, add a custom domain. For more information, refer to Domains.