func/docs
Luke Kingland c2e1b769cc
src: direct serialization of Function metadata as func.yaml (#641)
* src: directly serialize Function metadata as func.yaml

Functions now save directly to func.yaml using .Write().
Fixes a serialization error where defaults were not respected on load.
Moves runtime and template defaults into function constructor.
Extracts Function validation (was config validation) into separate functions.
Extracts associated test files (validation) into separate unit test files.
Updates schema generator to use Function

* comment spelling and re-enabling tests
2021-11-17 06:18:35 -08:00
..
guides src: direct serialization of Function metadata as func.yaml (#641) 2021-11-17 06:18:35 -08:00
knative rename function -> func (#217) 2020-11-06 12:47:30 +01:00
provisioning docs: major overhaul of docs (#284) 2021-03-24 14:07:09 +01:00
tls docs: Kind cluster provisioning and TLS 2020-08-18 10:01:16 +09:00
DEVELOPMENT.md doc: DEVELOPMENT.md (#432) 2021-07-23 07:01:45 -07:00
README.md doc: DEVELOPMENT.md (#432) 2021-07-23 07:01:45 -07:00
getting_started_kubernetes.md Change github.com links to the new home (#424) 2021-07-26 10:30:15 -07:00
getting_started_localhost.md docs: getting started with kubernetes, reorganization. 2020-08-18 10:01:16 +09:00
installing_cli.md Update installing_cli.md (#539) 2021-09-18 09:26:32 -07:00

README.md

Boson Functions

Telegram Image Analysis Demo Screencast

Telegram Image Analysis Demo Screencast

func is a Client Library and CLI for enabling the development of implicitly deployed, platform agnostic functions.

Functions can be written in the following languages:

  • Go (Golang)
  • Node.js (JavaScript)
  • Quarkus (Java)
  • SpringBoot (Java)
  • Python
  • Rust

Functions can be deployed on the following platforms:

  • Kubernetes
  • OpenShift
  • Localhost

Client Installation

Install the latest CLI

Functions can be created and managed using the CLI interactively, scripted, or by direct integration with the client library. The Function Developer's Guide and examples herein demonstrate the CLI-based approach.

For direct integration using the Go client library, it is advisible to first follow these CLI-based guides to become familiar with creating and deploying software in this way, and then proceed to the Function Integrator's Guide.

Platform Configuration

Getting Started with Kubernetes

Getting Started on Localhost

Functions are portable between different infrastructure configurations. While your Function itself remains the same, the platform upon which it is deployed will provide different services and guarantees. For instance, a Function deployed to your local host will not autoscale, nor be highly available nor externally routable by default. Deploying to a properly configured Kubernetes cluster would however provide these features. There is also variance within infrastrucutre types. For instance, a small kubernetes cluster will be limited in the amount of resources which will be ultimately available for allocation to your Function.

Function Development

Function Developer's Guide

Any code which provides one of a set of supported function signatures can be deployed to any of the supported platforms using this client library. No process boundary code, container, or configuration outside of the function itself is required.

At their most fundamental, a Function is a set of instructions which export a public function whose method signature conforms to one of the supported forms. It is implicitly deployed to a supported platform when created using the client library, and can be migrated between platforms without code changes. Runtime execution is handled by the platform, which may offer guarantees such as autoscaling and load balancing.

Contributing

We are always looking for contributions to the project from the Function Developer community. For more information on how to participate, see the Development Guide