gitter-badger/gofn

Function process via container provider (serverless minimalist)

Function process via container provider

Premise

• Software makes a task
• After processing it dies
• Must put on stdout (print) a string formatted as JSON

Install

go get github.com/nuveo/gofn

Example

package main

import (
	"flag"
	"fmt"
	"log"

	"github.com/nuveo/gofn"
	"github.com/nuveo/gofn/provision"
)

func main() {

	contextDir := flag.String("contextDir", "./", "a string")
	dockerfile := flag.String("dockerfile", "Dockerfile", "a string")
	imageName := flag.String("imageName", "", "a string")
	remoteBuildURI := flag.String("remoteBuildURI", "", "a string")
	volumeSource := flag.String("volumeSource", "", "a string")
	volumeDestination := flag.String("volumeDestination", "", "a string")
	flag.Parse()

	stdout, err := gofn.Run(&provision.BuildOptions{
		ContextDir: *contextDir,
		Dockerfile: *dockerfile,
		ImageName:  *imageName,
		RemoteURI:  *remoteBuildURI,
	}, &provision.VolumeOptions{
		Source:	  *volumeSource,
		Destination: *volumeDestination,
	})
	if err != nil {
		log.Println(err)
	}

	fmt.Println(stdout)
}

Run Example

	cd examples
	go run main.go -contextDir=testDocker -imageName=python -dockerfile=Dockerfile
	# or using volume
	go run main.go -contextDir=testDocker -imageName=python -dockerfile=Dockerfile -volumeSource=/tmp -volumeDestination=/tmp
	# or using remote Dockerfile
	go run main.go -remoteBuildURI=https://github.com/gofn/dockerfile-python-example.git -imageName="pythonexample"

You can also compile with go build or build and install with go install command then run it as a native executable.

Example Parameters

• -contextDir is the root directory where the Dockerfile, scripts, and other container dependencies are, by default current directory "./".

• -imageName is the name of the image you want to start, if it does not exist it will be automatically generated and if it exists the system will just start the container.

• -dockerFile is the name of the file containing the container settings, by default Dockerfile

• volumeSource is the directory that will be mounted as a data volume. By default is empty string indicating his not used.

• volumeDestination is the path mounted inside the container. By default is empty string indicating his not used but if only omitted, volumeSource is used.

• remoteBuildURI is remote URI containing the Dockerfile to build.By default is empty. More details on docker api docs

• -h Shows the list of parameters

gofn generates the images with "gofn/" as a prefix.