Developing an Azure Function in Go
In a previous post I have presented a case for Go as a business language. Among several arguments, the most prominent one was putting an end to the massive waste of resources consumed by other technologies used in business. This time, I’m going to explore the use of Go in a serverless cloud environment as a way to push resource efficiency to the extreme with the minimal cost possible.
Serverless computing is a type of PAAS (Platform As A Service) that, in addition to a runtime environment, also offers on-demand provisioning, automatic scalability, and zero downtime deployability. In other words, a serverless app doesn’t consume runtime resources like memory, networking and disk operations unless it is triggered by an event like a HTTP request or a message broker. In case the demand increases, it automatically scales from 1 to N instances in a totally transparent way. It may have longer response times while deploying or auto-scaling, but it remains available all the time. Despite the name, serverless does use servers. The only difference is that you don’t worry about them. It is also known as Function As A Service (FaaS) but this term is limited given what we can achieve these days with serverless apps.
But not every application can be serverless. Everything is ephemeral. Saving files on disk, even log files, is pointless. Keeping things in memory or any other kind of internal state is hopeless. We have to rely on other cloud services for storage, computing, monitoring, etc. These limitations are actually good for the sake of scalability. If the application works in a serverless environment it probably works well in Kubernetes and other auto-provisioning technologies.
The main cloud service providers (AWS, Google Cloud, and Azure) offer serveless support, but I’m going to focus on Azure, which is the one I have more experience with. To keep things short, I’m going to divide this tutorial in two parts:
- Part 1 is about what is inside of a Go serverless application
- In Part 2 we deploy and run the app as an Azure Function
Let’s start with the business scenario we are going to implement as a Go serverless app:
Imagine you have enough savings to pay 20% upfront for a new house. This way your mortgage will be affordable enough to keep your monthly costs low. You found a nice house listed at $600,000, for which you could pay $120,000 up front from your savings. You make an offer and realize that you are not the only one. There is an auction going on that will actually deteriorate your financial plans. You liked the house so you want to make a better offer by lowering your down payment to 15% or 10% and use the rest to increase your offer. Our Go serverless app will help you to calculate your affordable offer.
To calculate the offer we use the following formula:
maxBid = listingPrice + (savings - (listingPrice x downPayment) - closingCosts)
where:
listingPrice
is the initial price of the house, as announced by the seller. It can also be an appraisal, which is more realistic.maxBid
is the maximum bid you can make. Any amount between the listing price and the maximum bid can be an affordable offer.savings
is the total amount you have saved over the years.downPayment
is the percentage of the appraisal approved by your financial institution to give directly to the seller as down payment. It is a value ranging from 5 to 20 (percent).closingCosts
is the cost of the transaction that includes legal services, taxes, fees, etc.
WARNING: The goal here is to teach Go, not real estate, so use this calculation in real life at your own risk.
First, let’s wrap this formula in Go functions (/offer/business.go):
Now, let’s call the functions CalcMaxBid
and CalcMargin
from a HTTP handler that reacts to requests with GET parameters and responds with JSON (/offer/controller.go):
This handler receives a simple get request such as:
/offer?savings=100000&listingPrice=600000&downPayment=10&closingCosts=20000
and returns a json response such as:
In addition to the request parameters, the response includes:
margin
: your savings after removing the downpayment and the closing costsmaximumBid
: the margin added to the listing price
To serve the handler, we call it from the entry point (/buyersmarket.go):
Notice that Go is very explicit about everything that is going on. There is no annotation making magical things and no frameworks making design decisions on your behalf. When we write explicit code we communicate it better to other developers. When we read explicit code we understand and maintain it better. Yet, explicit Go code is probably shorted than the equivalent in many languages used in business.
The code is available on GitHub. The project structure is very simple:
/offer/business.go
/offer/controller.go
/buyersmarket.go
/go.mod
The Go files are in the sequence presented in this article. We also have go.mod
to define the module, the Go version, and the dependencies. To build the repo, simply run:
$ go build buyersmarket.go
Then, run the resulting artifact:
$ ./buyersmarket
To test it, call the URL using curl
:
$ curl 'http://localhost:8080/offer?savings=100000&listingPrice=600000&downPayment=10&closingCosts=20000'
In part 2, we are going to explain how to deploy it as an Azure Function. Stay tuned!