Deploying Mendix on Azure

Introduction

Before deploying your Mendix on Azure cluster, ensure all prerequisites are met. Once confirmed, you can proceed with the deployment.

Prerequisites

To deploy Mendix on Azure, make sure you have the following available:

• A Mendix platform account
• An Azure account with the following permissions:
  • Permission to grant admin consent on the Mendix on Azure portal app registration (e.g. Global Administrator in Entra ID)
  • Owner role assigned on the target subscription (temporary elevated Privileged Identity Management - PIM - access does not suffice)
• In case you want to integrate the Mendix on Azure environment into your existing corporate network, be sure to consider the network configuration options that cannot be changed after initial environment deployment

Deploying the Mendix on Azure offering from Azure Marketplace

To deploy the solution, perform the following steps:

1. Open the Mendix on Azure marketplace offering in the Azure Portal while signed into the correct Azure account.

2. Choose the Standard plan and proceed to the next step by clicking Create.

   

3. Deploy the offering in a resource group and Azure location (region) of your choosing. Keep in mind that the Azure location chosen here will be used to host all Mendix on Azure resources.

   

4. Finish the wizard by clicking Create in order to start the deployment of the managed application.

5. After deployment of the Mendix on Azure managed application has succesfully completed, please navigate to the Mendix on Azure portal by clicking on the Mendix on Azure Portal button or, alternatively, by using this direct link.

6. Connect to your Azure account by clicking Connect Azure Account, and then login with the same account that you used to deploy the Mendix on Azure offering.

   After successfully connecting the accounts, the Mendix Portal shows a list of clusters with the following possible statuses:

   • Ready to initialize clusters (=clusters that have not been initialized yet to start hosting Mendix apps)
   • Initialized cluster (=clusters ready to start hosting Mendix apps)
   • Failed clusters (= cluster that failed to initialize for any reason).

   

7. Identify the entry belonging to the Managed Application you deployed in previous steps. In the Actions column, click the dropdown menu icon, and then select Initialize.

   The preflight check launches to verify the conditions are in place to successfully initialize a Mendix on Azure cluster.

   

8. In the Preflight Check screen, click Next to be redirected to the Provision screen. When all preflight checks have passed, the status is displayed as Done in the Preflight Check section, as shown below:

   

9. In the Provision screen, optionally add any custom tags that will be used to tag deployed resoources and optionally review the configuration in the Advanced Options section.

   For more information, refer to the configuration documentation. The default settings suffice for a test deployment. Note that certain settings have influence on the Azure costs charged by Microsoft.

10. In the Review & Initialize screen, review the information and click Initialize.

    

    The initialization process takes approximately 15 minutes. It deploys resource into the managed resource group belonging to the Managed App that you created in step 3 above as shown below:

    

11. To view the cluster's initialization progress, click Details in the Actions column.

    

12. If there are deployment issues, the cluster status is Failed. To view details about which component(s) failed (if available), click Details.

    

    Some issues can be resolved by retrying the deployment. You can do this by clicking Rerun to manually re-trigger the cluster deployment. If the cluster still fails after a second rerun, a support ticket is automatically created with Mendix Support, and the Mendix team will contact you to resolve the issue.

    After the cluster is initialized successfully, the status of the cluster in the Portal changes to INITIALIZED. The cluster and its namespace are immediately available for deploying apps.

Deploying a Mendix App to a Mendix on Azure Cluster

After creating your cluster in Microsoft Azure, you can proceed to deploy your applications to it. The deployment process is identical to that used with Mendix on Kubernetes. For more information, see Deploying a Mendix App to a Mendix on Kubernetes Cluster.