You can install MDriven Turnkey on an Azure Web App when you want to run a Turnkey application in your own Microsoft Azure account.
Microsoft Azure hosts the web application, while MDriven Turnkey provides the application front end and MDrivenServer runs the model server. This page helps you choose a deployment layout and continue with the correct installation procedure.
Choose a deployment layout
You can deploy Turnkey and MDrivenServer either as two Azure Web Apps or together in one Azure Web App.
| Layout | What you deploy | When to use it |
|---|---|---|
| Two Azure Web Apps | One Web App contains Turnkey. A second Web App contains MDrivenServer. | Use this layout when you want Turnkey and MDrivenServer to run as separate Azure applications. |
| One Azure Web App | Turnkey is deployed to site\wwwroot. MDrivenServer is deployed to site\wwwroot\__MDrivenServer and exposed as the /__MDrivenServer virtual application.
|
Use this layout when you want both components in the same Azure Web App. |
For example, if your Azure application domain is https://example.azurewebsites.net, the single-Web-App layout makes MDrivenServer available at https://example.azurewebsites.net/__MDrivenServer/.
Install on Azure
Follow Install MDriven Server and Turnkey on Microsoft Azure for the complete procedure. It covers creating the Azure Web App or apps, obtaining the publish profile, placing the application files, configuring the virtual application for a combined installation, setting the MDrivenServer password, and deploying a model.
At a high level, you will:
- Sign in to the Azure portal and create the required Azure Web App or apps.
- Download the current MDriven Turnkey and MDrivenServer application packages from MDriven downloads.
- Deploy the application files to the appropriate
site\wwwrootlocation. - If both components share one Web App, create the
/__MDrivenServervirtual application with physical pathsite\wwwroot\__MDrivenServer. Set its type to Application; do not select the available checklist options. - Configure each deployed application as described in the installation guide, then upload your model to MDrivenServer.
- Confirm that your model contains an Index ViewModel. Each Turnkey application requires one.
Deploy and update the application files
Azure supports several publishing methods. If you use OneDrive deployment, follow Deploy Turnkey on your own Azure with OneDrive. That procedure also applies when you refresh an existing installation with newer MDriven Turnkey or MDrivenServer versions.
For a OneDrive deployment, place the Turnkey application's contents in the deployment folder and place the MDrivenServer application's contents in a folder named __MDrivenServer. Stop the Web App before synchronization to avoid deployment being blocked by locked files, then start it after the deployment completes.
Configure access after installation
After the site is deployed, you can use Openid AzureAD to protect a Turnkey application with Azure Active Directory. The configuration uses your Turnkey sign-on URL, application ID, and Azure AD authority.
Operate the Azure Web App
An Azure Web App runs within an App Service Plan. Review the Azure environment documentation before changing operating-system behavior, file-system use, or application settings. For additional MDriven guidance about running more than one Turnkey instance, see Scaling out Turnkey on Azure.