application

README

Stellar Application Service

The Stellar application service provides a simple way of launching container workloads.

Format

Stellar applications are represented in JSON format for portability and interoperatbility.

{
    "name": "example-application",
    "labels": [
        "env=prod",
        "region=us-east"
    ],
    "services": [
        {
            "name": "redis",
            "image": "docker.io/library/redis:alpine",
            "process": {
                "uid": 0,
                "gid": 0,
                "args": ["redis-server"]
            },
            "labels": [
                "env=prod"
            ],
            "network": true,
            "mounts": [
                {
                    "type": "bind",
                    "source": "/mnt/data",
                    "destination": "/data",
                    "options": ["rbind"]
                }
            ]
        },
        {
            "name": "processor",
            "image": "docker.io/ehazlett/processor:alpine",
            "process": {
                "args": ["--debug"],
                "env": ["PROCS=4"]
            },
            "resources": {
                "cpu": 0.1,
                "memory": 128
            },
            "network": true
        },
        {
            "name": "ui",
            "image": "docker.io/ehazlett/ui:alpine",
            "network": true,
            "instances": 4,
	    "endpoints": [
                {
                    "service": "ui",
                    "protocol": "http",
                    "host": "example.com",
                    "port": 8080,
                    "tls": false
                }
            ]

        }
    ]
}

Documentation

Index

• Variables
• func New(cfg *stellar.Config, agent *element.Agent) (*service, error)
• type AppSorter
  • func (a AppSorter) Len() int
  • func (a AppSorter) Less(i, j int) bool
  • func (a AppSorter) Swap(i, j int)
• type UpdateEvent

Variables

var (
	ErrApplicationNotFound = errors.New("application not found")
)

Functions

func New

func New(cfg *stellar.Config, agent *element.Agent) (*service, error)

Types

type AppSorter

type AppSorter []*api.App

func (AppSorter) Len

func (a AppSorter) Len() int

func (AppSorter) Less

func (a AppSorter) Less(i, j int) bool

func (AppSorter) Swap

func (a AppSorter) Swap(i, j int)

type UpdateEvent

type UpdateEvent struct {
	Application string
	Action      string
}

UpdateEvent is the event published when an application is updated