Go Other
Switch branches/tags
Nothing to show
Clone or download
crgimenes Merge pull request #113 from gofn/improvements/google-cloud-provider
Add Google Compute Engine provder to gofn
Latest commit 8c88f4a Aug 7, 2018
Failed to load latest commit information.
docs/assets new logo asset Jun 9, 2018
examples add examples and documentation on google compute provider Aug 6, 2018
iaas add tests for google provider Aug 6, 2018
provision fix tests to match new structure Jul 6, 2018
ssh Removes some logs (#108) Jul 2, 2018
.gitignore fix tests Jan 26, 2017
.travis.yml fix travis execution by adding docker-machine as dependence Jul 11, 2018
Makefile finish implementation, but test broken Jan 25, 2017
README.md fix readme with new digital ocean api (#110) Jul 12, 2018
gofn.go fix merge conflicts Jul 11, 2018
gofn_test.go update gofn path Dec 26, 2017
test.sh go is package not CLI, removed vendor folder (#64) Jun 27, 2017



Build Status GoDoc Go Report Card codecov Join the chat at https://gitter.im/gofn/gofn Open Source Helpers

Function process via docker provider


go get github.com/gofn/gofn


package main

import (


func main() {
	wait := &sync.WaitGroup{}
	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")
	remoteBuild := flag.Bool("remoteBuild", false, "true or false")
	input := flag.String("input", "", "a string")
	parallels := runtime.GOMAXPROCS(-1) // use max allowed CPUs to parallelize
	for i := 0; i < parallels; i++ {
		go run(*contextDir, *dockerfile, *imageName, *remoteBuildURI, *volumeSource, *volumeDestination, wait, *remoteBuild, *input)

func run(contextDir, dockerfile, imageName, remoteBuildURI, volumeSource, volumeDestination string, wait *sync.WaitGroup, remote bool, input string) {
	buildOpts := &provision.BuildOptions{
		ContextDir: contextDir,
		Dockerfile: dockerfile,
		ImageName:  imageName,
		RemoteURI:  remoteBuildURI,
		StdIN:      input,
	containerOpts := &provision.ContainerOptions{}
	if volumeSource != "" {
		if volumeDestination == "" {
			volumeDestination = volumeSource
		containerOpts.Volumes = []string{fmt.Sprintf("%s:%s", volumeSource, volumeDestination)}
	if remote {
		key := os.Getenv("DIGITALOCEAN_API_KEY")
		if key == "" {
			log.Fatalln("You must provide an api key for digital ocean")
		do, err := digitalocean.New(key)
		if err != nil {
		buildOpts.Iaas = do

	defer wait.Done()
	stdout, stderr, err := gofn.Run(context.Background(), buildOpts, containerOpts)
	if err != nil {
	fmt.Println("Stderr: ", stderr)
	fmt.Println("Stdout: ", 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 send a string that will be written to the stdin of the container
go run main.go -contextDir=testDocker -imageName=python -dockerfile=Dockerfile -input "input string"

# or run in digital ocean
export DIGITALOCEAN_API_KEY="paste your key here"
go run main.go -contextDir=testDocker -imageName=python -dockerfile=Dockerfile -remoteBuild=true

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

  • remoteBuild is a boolean that indicates if have to run localally or in a machine in digital ocean Don't forget to export your api key.

  • -input is a string that will be written to the stdin of the container

  • -h Shows the list of parameters

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