https://github.com/olivergrabinski/scala-azure-fn

Simple example for writing Azure Functions in Scala
https://github.com/olivergrabinski/scala-azure-fn

azure azure-functions scala

Last synced: 2 months ago
JSON representation

Simple example for writing Azure Functions in Scala

• Host: GitHub
• URL: https://github.com/olivergrabinski/scala-azure-fn
• Owner: olivergrabinski
• Created: 2021-12-09T21:28:51.000Z (about 3 years ago)
• Default Branch: main
• Last Pushed: 2023-12-06T21:49:02.000Z (about 1 year ago)
• Last Synced: 2023-12-06T22:33:45.880Z (about 1 year ago)
• Topics: azure, azure-functions, scala
• Language: Scala
• Homepage:
• Size: 12.4 MB
• Stars: 3
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Scala Azure Function

While Scala is not an officially supported language for writing Azure Functions, we can leverage its interoperability with Java to easily write and deploy Azure Functions written in Scala. This relies mainly on the use of the Java library `azure-functions-java-library`.

This repository is a simple example of a working Azure Function written in Scala. You can use it as a template to write your own functions.

## How to run the Azure Function

1. Install the [azure-functions-core-tools](https://github.com/Azure/azure-functions-core-tools).

2. Build the app with `sbt assembly` at the root of the project.

3. Run your app locally `func host start --java` from within the `function-app` folder.

4. Deploy your app to Azure `func azure functionapp publish {function_app_name_in_Azure} --java`

## Notes

* As of writing, this function has been deployed to a Function App with runtime 4.0, and JRE 11 as worker runtime.

* The project is written in Scala 3, but this process can be very easily adapted to any previous Scala version.

## Tips

* If you observe that your code runs significantly faster outside an Azure Function than within, be aware that the JVM running the Functions starts with option `-XX:TieredStopAtLevel=1`. This can lead to a decrease in performance, depending on your application. To override this behavior, add `-XX:TieredStopAtLevel=4` to the `JAVA_OPT` application setting. Refer to the [Customize JVM paragraph](https://docs.microsoft.com/en-us/azure/azure-functions/functions-reference-java#customize-jvm) to find all JVM options set by a Function App.

* If you are running inside an Azure App Service plan, you can also consider setting initial and max heap memory settings according to the instance you are using. Refer to [Set Java runtime options](https://docs.microsoft.com/en-us/azure/app-service/configure-language-java?pivots=platform-linux#set-java-runtime-options) for more information. However, keep in mind that the values provided in the documentation might not suit your use case. If you encounter failures (i.e. worker dying), you might need to reduce the heap size.

## Documentation

* [Azure Functions Java developer guide](https://docs.microsoft.com/en-us/azure/azure-functions/functions-reference-java)

* [Library for Azure Java Functions](https://docs.microsoft.com/en-us/java/api/overview/azure/readme)

## Credit

This repo is based on a [blog post](https://web.archive.org/web/20210103161031/https://monteledwards.com/2018/10/07/deploying-scala-code-on-azure-functions/) by Montel Edwards. As of writing, the post is down and only accessible via the internet archive. In addition, its companion repo is no longer available.