state

Documentation

Overview

* Convey * Copyright 2016-2017 Gary Kramlich <grim@reaperworld.com> * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see <http://www.gnu.org/licenses/>.

* Convey * Copyright 2016-2017 Gary Kramlich <grim@reaperworld.com> * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see <http://www.gnu.org/licenses/>.

Index

• Constants
• type State
  • func New() *State
  • func (st *State) GetDetached() []string
  • func (st *State) MapSlice(env, fullEnv []string) ([]string, error)
  • func (st *State) MarkDetached(name string)
  • func (st *State) Valid() error
  • func (st *State) WrapWithExpandableEnv(env, expandable []string, delimiter string) *State

Constants

const ExpansionLimit = 100

Types

type State

type State struct {
	Network       network.Network
	Workspace     workspace.Workspace
	KeepWorkspace bool

	ForceSequential bool
	EnableSSHAgent  bool
	TaskTimeout     time.Duration
	Environment     []string

	DockerConfig string
	CPUShares    string
	Memory       string
	// contains filtered or unexported fields
}

func New

func New() *State

func (*State) GetDetached

func (st *State) GetDetached() []string

GetDetached returns a list of all detached containers.

func (*State) MapSlice

func (st *State) MapSlice(env, fullEnv []string) ([]string, error)

MapSlice calls SliceMapper on the given environment, but also checks to see if the variable in the env parameter can be expanded into a list.

func (*State) MarkDetached

func (st *State) MarkDetached(name string)

MarkDetached will add the given container name into the list of containers running in detached mode which must be shut down at the end of the plan. This falls through directly to the root state so that states wrapping the global one do not have to sync additional detached container names.

func (*State) Valid

func (st *State) Valid() error

func (*State) WrapWithExpandableEnv

func (st *State) WrapWithExpandableEnv(env, expandable []string, delimiter string) *State

WrapWithExpandableEnv will create a shallow clone of the state with a reference to the current state as "parent" with a modified environment. This creates a local stack of states which do not interfere with other goroutines. A pop operation is the same as ignoring the wrapped values and using the underlying state. This stack is used to map a slice within an extended task.