Back

Creating the Azure Functions Updates Twitterbot

Azure Functions Updates component diagram

TL;DR

Go to https://twitter.com/az_func_updates and follow that account to stay up to date with new Azure Functions releases!

What I'm trying to solve

The Azure Functions ecosystem consists of a lot of moving parts. There's the runtime, core tools, VS templates, Webjobs SDK and its dozen or so extensions, definitions for writing functions using TypeScript and much more.

As a developer, it's important you are aware of the latest releases and what is compatible with one another. I've spent quite some time troubleshooting incompatible runtimes and packages in the past, and it would be great if this experience can be improved.

The idea

I was thinking about a way to notify developers about new releases related to Azure Functions. Almost all of the Azure Functions components are on GitHub so I can use the GitHub API to check for latest releases.

Since the IT community is very active on Twitter that can be the communication channel, so the idea of an Azure Functions Updates Twitterbot was born.

Surely this does not solve the issue of dealing with incompatible components, but it does help a bit in spreading the information about new releases and knowing when to update which exact piece of the puzzle.

The implementation

Since I'm a big fan of Azure Functions myself, I wanted to use this service as the backend for the Twitterbot. Logic Apps could also have been a valid option for a part of it, but I prefer to have local debugging and testing which is easily done with Azure Functions.

The design of the application is as follows:

Azure Functions Updates component diagram

Storage: Azure Table Storage

The application needs to store two things:

  1. The GitHub repositories to check for new releases.
  2. The latest release for each of the repositories to compare against.

Both require very little storage. I decided on using Azure Table Storage since that is easy to setup & use and it is also very performant.

The repositories to check are stored in the RepositoryConfigurations table:

Azure Storage Table with repository configurations

The release information retrieved from GitHub is stored in the Releases table:

Azure Storage Table with release info from GitHub

I'm not storing the entire GitHub Release object, only the properties I need (or plan to use soon).

Compute: Azure Functions

As mentioned before I'm using Azure Functions for the compute part of this application. In specific I'm using the Durable Functions extension to control the flow of the application. A timer trigger starts the ReleaseUpdateOrchestration function each hour.

The flow (in pseudo code) is as follows:

- GetRepositoryConfigurations
- for each of the repositories:
    - GetLatestReleaseFromGitHub
    - GetLatestReleaseFromHistory
- for each of the repositories:
    - if release from GitHub is not equal to release from History
        - SaveLatestRelease
        - PostUpdate

The orchestrator function uses the fan-out/fan-in pattern since it can call the same activity functions for each of the configured repositories in parallel.

GitHub API

For the GitHub integration, I'm using Octokit, an excellent GitHub API client library for .NET.

The usage is the following:

var client = new GitHubClient(new ProductHeaderValue("SomeApplicationIdentifier"));

var latestRelease = await client.Repository.Release.GetLatest(
    repoConfiguration.RepositoryOwner,
    repoConfiguration.RepositoryName);

I'm doing unauthenticated requests which means the application is rate limited at 60 requests per hour. I'm far from that number of repositories to check, but it's good to be aware this doesn't scale very well. For authenticated requests, the rate limiting is set much higher, at 5000 requests per hour.

Twitter API

To have an application post tweets, you need a Twitter developer account and set up a Twitter application. There is quite some documentation about this (almost too much), but it's quite easy to follow when you go through the getting started docs. You basically need to fill in a couple of online forms and promise you won't do any evil with you Twitterbot.

To post the updates to Twitter from my function app I'm using Tweetinvi. I found this Twitter client library for .NET Core very easy to use:

var creds = new TwitterCredentials(
     consumerApiKey, 
     consumerApiSecret, 
     accessToken, 
     accessTokenSecret);

var tweetMessage = CreateMessage(newRelease);

var tweet = Auth.ExecuteOperationWithCredentials(creds, () =>
{
    return Tweet.PublishTweet(tweetMessage);
});

Overall development experience

I built this application in about 6 evenings over the last month. I find it quite amazing that thanks to the work of others, who have built these cloud services and client libraries, I can make something like this in such little time.

Development was mostly done in Visual Studio 2019 Preview and a bit of VS Code. I've set up a CI/CD pipeline in Azure DevOps so as soon as I merge to master a new release is built and deployed to Azure.

Azure Devops CD pipeline

It was certainly an enjoyable experience to make this, and I hope you will benefit from it.

I already have plans to extend the application beyond GitHub release updates. So in time, there will be some significant upgrades.

Resources & feedback

The full source code of the Azure Functions Updates Twitterbot is found in the az-func-updates repo on GitHub.

If you have feature requests or suggestions, feel free to add those as an issue, so we can discuss it.