Deploying Azure WebJob for Process Flow Runs

This document directs the user to configure the Process Flow Runs WebJob on Azure Portal. This web job replaces the Async Server. The Web Job runs on Continuous Mode and picks and executes any Process Flow Run record available at any instance.

The Process will be divided in two parts, Part 1 consist of the config file changes and Part 2 consist of Deploying web job on Azure Portal.

Following is the scope of Process Flow Run WebJob:

1. Only those Process Flow Run records with status as “Pending“ and ScheduledTaskId is -1 are executed.

2. The Scale of the job will always be “Single Instance“ and Type “Continuous“ on Azure Portal, more is discussed in this document.

Part 1: Code File Config Changes:

1. Extract the APTIFY_700_Database7.0.0 zipped file and go to the Core Database Setup folder containing the Utility folder.

2. Under the Utility folder search for ProcessFlowRunWebJob.exe.config and open the same in Notepad or Notepad ++

3. Configure the tags “AzureWebJobDashboard“ and “AzureWebJobStorage“ with Storage Account Connection String.

   

4. App Insights has been configured for these web jobs and logs can be found in App Insight log file. To enable the app insights, Instrumentation Key is required (Line 25 of the picture below). Refer to Configuring Serilog with Azure Application Insights to know more about App Insight.

   

   1. To get instrumentation key for App Insights, log into Azure portal and select the service Application Insights.

      

   2. Select the Application Insights for which you want to configure the logs.

      

   3. Under the overview tab you will find the Instrumentation key.

      

5. The below keys are required by web job to log into the database:

   1. UserDatabase = “Aptify

   2. EntitiesDatabase = “Aptify“

   3. SqlLogin and Password will be the credentials to log into the db.

   4. Server = Managed instance Endpoint (See Point 5.d.i to 5.d.iii)

      

      1. To get managed instance endpoint, log in to the Azure portal and select SQL Managed Instances Service.

         

      2. Select the instance to be connected with the web jobs

         

      3. Once you select the instance you will find Networking under Security and Endpoint on the right pane of screen as highlighted in the below screenshot.

         

6. Once all changes are done in config file, save and close it. Select all the code files and zip them, give the zipped file a meaningful name.

   

Part 2: Deploying the zipped code file on Azure Portal:

1. Open Microsoft Azure Portal, on the home page, click App Services.

   

2. Select the App Service through which your web job will run.

   

3. After selecting App Service on the newly opened right pane select “WebJobs“ under “Settings”

   

4. Under WebJobs, click + sign to add a new web job. A new pane Add WebJob opens on the right side of the screen. Under Name, give any meaningful name for the job.

   

5. Under File Upload, click upload button and a new window opens. Now select the zipped file created in Part 1.

   

6. Set the Scale to Single Instance.

   

7. Click OK, it may take few seconds for the job to be visible on the dashboard in Running Status. Now the ProcessFlowRun records will start executing as per their schedule.