serverless terraform aws amazon-web-services openfaas terraform-module faasd

faasd for Amazon Web Services

This repo contains a Terraform Module for how to deploy a faasd instance on the AWS using Terraform.

faasd, a lightweight & portable faas engine, is OpenFaaS reimagined, but without the cost and complexity of Kubernetes. It runs on a single host with very modest requirements, making it fast and easy to manage. Under the hood it uses containerd and Container Networking Interface (CNI) along with the same core OpenFaaS components from the main project.

What's a Terraform Module?

A Terraform Module refers to a self-contained packages of Terraform configurations that are managed as a group. This repo is a Terraform Module and contains many "submodules" which can be composed together to create useful infrastructure patterns.

How do you use this module?

This repository defines a Terraform module, which you can use in your code by adding a module configuration and setting its source parameter to URL of this repository:

module "faasd" {
  source = "github.com/jsiebens/terraform-aws-faasd"

  name      = "faasd"
  vpc_id    = var.vpc_id
  subnet_id = var.subnet_id
  key_name  = var.key_name
}

Requirements

Name	Version
terraform	>= 1.0.0
aws	>= 3.30.0
random	>= 3.1.0

Providers

Name	Version
aws	>= 3.30.0
random	>= 3.1.0

Resources

Name	Type
aws_eip.faasd	resource
aws_eip_association.faasd	resource
aws_iam_instance_profile.faasd	resource
aws_iam_policy_attachment.faasd	resource
aws_iam_role.faasd	resource
aws_instance.faasd	resource
aws_security_group.faasd	resource
random_password.faasd	resource
aws_ami.ubuntu	data source

Inputs

Name	Description	Type	Default	Required
basic_auth_password	The basic auth password, if left empty, a random password is generated.	`string`	`null`	no
basic_auth_user	The basic auth user name.	`string`	`"admin"`	no
domain	A public domain for the faasd instance. This will the use of Caddy and a Let's Encrypt certificate	`string`	`""`	no
email	Email used to order a certificate from Let's Encrypt	`string`	`""`	no
instance_type	The instance type to use for the instance.	`string`	`"t2.micro"`	no
key_name	Key name of the Key Pair to use for the instance.	`string`	`null`	no
name	The name of the faasd instance.	`string`	n/a	yes
subnet_id	VPC Subnet ID to launch in.	`string`	n/a	yes
tags	A map of tags to assign to the resource.	`map(string)`	`{}`	no
vpc_id	VPC ID.	`string`	n/a	yes

Outputs

Name	Description
basic_auth_password	The basic auth password.
basic_auth_user	The basic auth user name.
gateway_url	The url of the faasd gateway
ipv4_address	The public IP address of the faasd instance

About

Terraform Module for how to deploy a faasd instance on Amazon Web Services