To make the most of this tutorial, sign up for Serverless Framework’s dashboard account for free:
Back in October, Oracle first announced the open source Fn Project at the JavaOne conference. Since then, the team here at Serverless has kept a keen eye on it.
More function providers means more freedom for FaaS users & less vendor lock-in. This is one of our driving principles behind the Serverless Framework.
So, it was only natural to bring the Fn Project into the growing list of Serverless function providers 🎉
The Fn Project uses a vendor agnostic approach, leveraging containers to allow organizations run Fn either on premise or in their cloud of choice.
Another driving force behind the project is: a clear separation of serverless & container orchestration is important. So, whether you're on Kubernetes or any other provider, Fn is agnostic when it comes to your container orchestration of choice.
Watch this 10 minute video for a quick overview on the project, and see a sweet demo of their Fn Flow component:
The platform is container-native, enabling users to write functions in any programming language, with excellent support for local development and testing. Fn even allows devs to “bring their own Dockerfile” such that ANY containerized code can be used as a function.
Fn Server is the Functions-as-a-Service system that allows developers to easily build, deploy, and scale their functions into a multi-cloud environment
The Fn Load Balancer (Fn LB) allows operators to deploy clusters of Fn servers and route traffic to them intelligently. Most importantly, it will route traffic to nodes where hot functions are running (to ensure optimal performance), as well as distribute load if traffic to a specific function increases.
Fn FDK’s (Function Development Kits) are aimed at quickly bootstrapping functions in all languages, providing a data binding model for function inputs, making it easier to test your functions, and laying the foundation for building more complex serverless applications.
Fn Flow allows developers to build and orchestrate higher-level workflows of functions, all inside their programming language of choice. It makes it easy to use parallelism, sequencing/chaining, error handling, fan in/out, etc., without learning complicated external models built with long JSON or YAML templates.
For more information on the Fn Project and why they built it, I highly recommend checking out this post.
Starting today, you can now deploy your Fn functions using the Serverless Framework and the familiar
serverless.yml config we have all grown to know and love.
Make sure you have the Serverless Framework installed on your machine:
# Install serverless framework if you haven't already npm i serverless -g
Then, create a new service with the
sls create command and supply the newly added
# Create a new Serverless Service/Project $ serverless create --template fn-nodejs --path new-fn-project # Change into the newly created directory $ cd new-fn-project # Install fn provider dependency $ npm install # Install the function code dependencies $ cd hello && npm install
Fn functions run in Docker containers, so you need a running fn service in order to run it.
See the guide on installing Fn to finish setup.
The Fn Project structure is similar to all other Serverless Framework providers, with one tiny difference. Instead of a
handler property pointing to where the code lives, the function code location is driven by convention.
The function key will reference the folder path, and inside that folder path it will look for a
func.[Your Runtime] (a.k.a
So, the below serverless.yml is looking for a
./hello/func.js file when
sls deploy is run:
# The `service` block is the name of the service service: name: hello-world # The `provider` block defines where your service will be deployed provider: name: fn plugins: - serverless-fn # The `functions` block defines what code to deploy functions: hello: # <- hello references the ./hello folder and the func.js file inside name: hello version: 0.0.1 format: json runtime: node events: - http: path: /hello-there
To deploy, simply run the deploy command:
Use this method when you have updated your Function, Event or Resource configuration in
serverless.yml and you want to deploy that change (or multiple changes at the same time) to your Fn cluster.
The Serverless Framework translates all syntax in
serverless.yml to Fn calls to provision your functions.
For each function in your
serverless.yml file, Fn will create an Fn Function.
For example, let's take the following example
service: hello-world functions: # Your "Functions" hello: name: hi version: 0.0.1 runtime: go events: - http: path: /hello
When deploying that file, Fn will provide you with one endpoint that you can hit at:
Here’s what you need to get started with the Fn plugin now:
If you have questions or comments about the integration, we'd love to hear from you in the comments below or over on the serverless forums.
Can't wait to see what you build!
David Wells is a developer at Serverless, Inc.