dargo

README

dargo

Deploy apps directly to docker.

Why?

Inspired from Kelsey Hightower's presentation at dotGo 2016 of Kargo library, I wanted also be able to deploy applications directly to Docker Swarm

Usage

Check out the example app in example. It's as simple as:

package main

import (
	"fmt"

	"github.com/brimstone/dargo"
)

func main() {
	dargo.DeployAndExit(dargo.DeployOptions{
		Tags: []string{"hello-dargo"},
	})
	fmt.Println("Hello world!")
}

Documentation

Overview

Package dargo enables applications to deploy themselves to a Docker engine.

Index

• Variables
• func Deploy(o DeployOptions) error
• func DeployAndExit(o DeployOptions)
• type DeployOptions

Examples

• DeployAndExit

Variables

var Enable bool

Enable determines if we should deploy when Deploy() is called

Functions

func Deploy

func Deploy(o DeployOptions) error

Deploy deploys to the Docker engine reachable via environment variables and defaults.

func DeployAndExit

func DeployAndExit(o DeployOptions)

DeployAndExit checks to see if we're Enabled, then calls Deploy, logging Fatal errors, then exiting

Example

package main

import (
	"fmt"

	"github.com/brimstone/dargo"
)

func main() {
	dargo.DeployAndExit(dargo.DeployOptions{
		Tags: []string{"hello-dargo"},
	})

	fmt.Println("Hello world!")
}

Types

type DeployOptions

type DeployOptions struct {
	Tags       []string
	Foreground bool
}

DeployOptions control attributes about the resulting Docker Image