How to run Logic Apps in a Docker container
Azure Logic Apps can run anywhere
You can run Azure Logic Apps anywhere, on the Azure Functions Runtime. This enables you to deploy and run Logic Apps on your local machine, in your own datacenter, or in another cloud. And you can also run Azure Logic Apps in a Docker container.
In this post, we'll run an Azure Logic App in a Docker container.
Prerequisites
If you want to follow along, you'll need the following:
- An Azure subscription (If you don't have an Azure subscription, create a free account before you begin)
- Create an Azure Logic App in VS Code with the newest extension by following this previous tip.
- Docker Desktop
- Postman for sending requests
Deploy a Logic App to a container
The Logic App is triggered by an HTTP trigger and creates a queue message in Azure Storage. Let's deploy the Logic App to a container.
- In VS Code, create a Dockerfile in the project of the Logic App. The file has no file extension, and is just called Dockerfile. It should have the following contents:
FROM mcr.microsoft.com/azure-functions/dotnet:3.0.14492-appservice
ENV AzureWebJobsStorage=<Your Azure Storage connection string>
ENV AZURE_FUNCTIONS_ENVIRONMENT Development
ENV AzureWebJobsScriptRoot=/home/site/wwwroot
ENV AzureFunctionsJobHost__Logging__Console__IsEnabled=true
ENV FUNCTIONS_V2_COMPATIBILITY_MODE=true
COPY ./bin/release/netcoreapp3.1/publish/ /home/site/wwwroot
Fill in your Azure Storage connection string for the AzureWebJobsStorage environment variable so that the Logic App in the container can use it.
2. Next, open the Terminal in VS Code and build and publish the project with these commands:
dotnet build -c release
dotnet publish -c release
- Now create the container image with this command:
docker build --tag local/workflowcontainer .
- Run the container with the following command. This makes the Logic App accessible through localhost:8080
docker run -e WEBSITE_HOSTNAME=localhost -p 8080:80 local/workflowcontainer
- Now for the most difficult part. We need to discover the URL for the HTTP trigger. To do that, we first need to get the masterKey to gain access to the Logic App. You can find this key in the Azure Storage Account that you've indicated in the Dockerfile. Go to the Azure Storage Account and navigate to Containers/azure-webjobs-secrets/{id} and open the host.json file.
"masterKey": {
"name": "master",
"value": "l6vZj8J3aLEZzOfTV7SiiP2H2eru96ajlzZNpoXm5WScABAoP1tlEg==",
"encrypted": false
}
Copy the value of the masterKey. We'll need that in the next step.
- Open Postman
- Create a new POST request for http://localhost:8080/runtime/webhooks/workflow/api/management/workflows/{your logic app workflow name}/triggers/manual/listCallbackUrl?api-version=2020-05-01-preview&code={masterKey value} and send it
The results from the post contain the URL of the HTTP trigger to call and the query parameters to add to the URL.
- Open a browser and trigger the Logic App with a URL like this: http://localhost:8080/api/{your logic app workflow name}/triggers/manual/invoke?api-version=2020-05-01-preview&sp={value for sp}&sv={value for sv}&sig={value for sig}&myqueuetext
The final querystring is a text, which the Logic App takes and puts in a new queue message in Azure Storage
That's it! The Logic App is now triggered and should run successfully and place a message on the Azure Storage queue, like in the image below:
Conclusion
Azure Logic Apps enable you to easily create complex workflows. Now, you can run Azure Logic Apps anywhere, including in a Docker container. Create a trial account today and go and check it out!