Continuous Deployment of Azure Functions with Slots

Time for another post in our series about Azure Functions. This is the fifth post in the series about Azure Functions:

In part 3, I showed you how to set up deployment of Azure Functions from source control. In some scenarios, deploying into a running function or deploying all changes isn't the desired behavior. Luckily, Functions now support deployment slots like normal Azure Web Apps.

Please notice that deployments slots are currently in preview and therefore not recommended for production. We have experienced a couple of problems with Function slots like functions stopping to consume messages from service bus and more.

To start utilizing deployment slots, you must enable it on the Function app settings screen:

Enable deployment slots

Once enabled, you can create a new slot by clicking the plus icon next to the Slots tree node and inputting a name. For this example, I'll create a slot named staging:

Create new deployment slot

Since we want every commit deployed on staging before swapping to production, you will need to disconnect source control deployment from the production slot (if already set up as shown in part 3). Like in part 3 of this series, set up deployment from source control (or whatever way you prefer to deploy) in your new staging slot. For details see part 3.

Would your users appreciate fewer errors?

➡️ Reduce errors by 90% with elmah.io error logging and uptime monitoring ⬅️

All changes should now be deployed to staging. When everything is working and tested, you can swap the staging and production slots by clicking the Swap button:

Swap deployment slots

Azure supports a feature called Auto Swap, which automatically swaps deployment slots when new changes are deployed to a slot. The end result will be similar to just setting up automatic deployments directly on your production slot, but there are benefits of putting a staging slot in the mix. We've noticed that timed functions running at the time of deployment, sometimes skip one or more iterations. While that could be considered a bug, it actually makes sense. When deploying a new build of your function, files need to be overwritten on disk, which creates a bit of downtime on your function app. Deployment slots are a great way to eliminate this downtime, since you deploy in the background and swap when the deployment is successful.

Monitor your deployments with elmah.io for Azure!

➡️ elmah.io for Azure Functions ⬅️

Auto Swap is available through the Application settings view on the staging slot:

Set up auto swap

That's it! All changes are now deployed to staging and automatically swapped into production. But wait a minute! Doesn't two deployment slots (production and staging) means that your function app is deployed in two instances? It sure does. In scenarios where you have timed functions (and other types as well), you only want your functions running on production. Luckily, functions provide a mechanism for disabling functions by app settings. To set it up, add the Disable attribute on your function class:

[Disable("IS_DISABLED")]
public static class MyFunctions
{
    ...
}

When looking at the generated function.json, the disabled field now looks like this:

{
  ...
  "disabled": "IS_DISABLED",
  ...
}

IS_DISABLED should match an application setting on your function app. To set it up, add a new slot setting on both slots. In this case staging:

Disable function on staging

Notice the value 1 (true) as well as the check in Slot Setting. Similar, you will need the same setting on your production slot, but with the value 0. Functions are now disabled on staging and enabled on production.

There's a bug in the portal, showing both the production and staging functions as disabled. Apparently, portal doesn't know that the disabled field can be populated from app settings yet, and therefore marks it as disabled when not a boolean.

elmah.io: Error logging and Uptime Monitoring for your web apps

This blog post is brought to you by elmah.io. elmah.io is error logging, uptime monitoring, deployment tracking, and service heartbeats for your .NET and JavaScript applications. Stop relying on your users to notify you when something is wrong or dig through hundreds of megabytes of log files spread across servers. With elmah.io, we store all of your log messages, notify you through popular channels like email, Slack, and Microsoft Teams, and help you fix errors fast.

See how we can help you monitor your website for crashes Monitor your website