compose

Documentation

Index

• type Builder
  • func NewBuilder() *Builder
  • func (b *Builder) AddNetwork(n *Network) *Builder
  • func (b *Builder) AddService(sb ServiceBuilder) *Builder
  • func (b *Builder) AddVolume(v string) *Builder
  • func (b *Builder) Build() (*Compose, error)
  • func (b *Builder) MustBuild() *Compose
• type Command
  • func NewCommand(c *Compose, dir string, stdout, stderr io.Writer) (*Command, error)
  • func (c *Command) Close() error
  • func (c *Command) Down(args ...string) error
  • func (c *Command) File() string
  • func (c *Command) Logs(args ...string) error
  • func (c *Command) Project() string
  • func (c *Command) Ps(args ...string) error
  • func (c *Command) Runtime() string
  • func (c *Command) ServiceExitCode(service string) (int, error)
  • func (c *Command) Stop(args ...string) error
  • func (c *Command) Up(args ...string) error
  • func (c *Command) Wait(interval, timeout time.Duration, services []string) error
• type Compose
  • func New() *Compose
  • func (c *Compose) AddNetwork(n *Network) error
  • func (c *Compose) AddService(s *Service) error
  • func (c *Compose) AddVolume(v string) error
  • func (c *Compose) WriteTo(w io.Writer) (int, error)
• type HealthCheck
• type IPAM
  • func (i *IPAM) Validate() error
• type IPAMConfig
  • func (c *IPAMConfig) Validate() error
• type Network
  • func (n *Network) Validate() error
• type Service
  • func (s *Service) Service() *Service
  • func (s *Service) Validate() error
• type ServiceBuilder
• type ServiceNetwork
• type Volume

Types

type Builder

type Builder struct {
	// contains filtered or unexported fields
}

func NewBuilder

func NewBuilder() *Builder

func (*Builder) AddNetwork

func (b *Builder) AddNetwork(n *Network) *Builder

func (*Builder) AddService

func (b *Builder) AddService(sb ServiceBuilder) *Builder

func (*Builder) AddVolume

func (b *Builder) AddVolume(v string) *Builder

func (*Builder) Build

func (b *Builder) Build() (*Compose, error)

func (*Builder) MustBuild

func (b *Builder) MustBuild() *Compose

type Command

type Command struct {
	// contains filtered or unexported fields
}

func NewCommand

func NewCommand(c *Compose, dir string, stdout, stderr io.Writer) (*Command, error)

func (*Command) Close

func (c *Command) Close() error

func (*Command) Down

func (c *Command) Down(args ...string) error

func (*Command) File

func (c *Command) File() string

func (*Command) Logs

func (c *Command) Logs(args ...string) error

func (*Command) Project

func (c *Command) Project() string

func (*Command) Ps

func (c *Command) Ps(args ...string) error

func (*Command) Runtime

func (c *Command) Runtime() string

func (*Command) ServiceExitCode

func (c *Command) ServiceExitCode(service string) (int, error)

func (*Command) Stop

func (c *Command) Stop(args ...string) error

func (*Command) Up

func (c *Command) Up(args ...string) error

func (*Command) Wait

func (c *Command) Wait(interval, timeout time.Duration, services []string) error

type Compose

type Compose struct {
	Services map[string]*Service `yaml:"services,omitempty"`
	Networks map[string]*Network `yaml:"networks,omitempty"`
	Volumes  map[string]*Volume  `yaml:"volumes,omitempty"`
}

func New

func New() *Compose

func (*Compose) AddNetwork

func (c *Compose) AddNetwork(n *Network) error

func (*Compose) AddService

func (c *Compose) AddService(s *Service) error

func (*Compose) AddVolume

func (c *Compose) AddVolume(v string) error

func (*Compose) WriteTo

func (c *Compose) WriteTo(w io.Writer) (int, error)

type HealthCheck

type HealthCheck struct {
	Test []string `yaml:"test,omitempty"`
	// Interval between two health checks, the default is 30 seconds.
	Interval time.Duration `yaml:"interval,omitempty"`
	// The health check command runs the timeout period.
	// If this time is exceeded, the health check is regarded as a failure.
	Timeout time.Duration `yaml:"timeout,omitempty"`
	// When the specified number of consecutive failures, the container status is treated as unhealthy, the default is 3 times.
	Retries uint `yaml:"retries,omitempty"`
	// The number of seconds to start the health check after the container starts, the default is 0 seconds.
	StartPeriod time.Duration `yaml:"start_period,omitempty"`
}

type IPAM

type IPAM struct {
	Config []IPAMConfig `yaml:"config"`
}

func (*IPAM) Validate

func (i *IPAM) Validate() error

type IPAMConfig

type IPAMConfig struct {
	Subnet  string `yaml:"subnet"`
	Gateway string `yaml:"gateway"`
}

func (*IPAMConfig) Validate

func (c *IPAMConfig) Validate() error

type Network

type Network struct {
	Name   string `yaml:"name"`
	Driver string `yaml:"driver"`
	IPAM   IPAM   `yaml:"ipam"`
}

func (*Network) Validate

func (n *Network) Validate() error

type Service

type Service struct {
	Name        string                    `yaml:"-"`
	Image       string                    `yaml:"image,omitempty"`
	Command     []string                  `yaml:"command,omitempty"`
	Environment map[string]string         `yaml:"environment,omitempty"`
	Ports       []string                  `yaml:"ports,omitempty"`
	Volumes     []string                  `yaml:"volumes,omitempty"`
	HealthCheck *HealthCheck              `yaml:"healthcheck,omitempty"`
	Network     map[string]ServiceNetwork `yaml:"networks,omitempty"`
	Privileged  bool                      `yaml:"privileged,omitempty"`
	CPUs        int                       `yaml:"cpus,omitempty"`
	CPUSet      string                    `yaml:"cpuset,omitempty"`
}

func (*Service) Service

func (s *Service) Service() *Service

func (*Service) Validate

func (s *Service) Validate() error

type ServiceBuilder

type ServiceBuilder interface {
	Service() *Service
}

type ServiceNetwork

type ServiceNetwork struct {
	IPv4 string `yaml:"ipv4_address,omitempty"`
}

type Volume

type Volume struct{}