config

package
v0.17.0-beta.1 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Sep 30, 2019 License: MIT Imports: 17 Imported by: 2

Documentation

Index

Constants

View Source 
const (
	// Name is the file name of the porter configuration file.
	Name = "porter.yaml"

	// EnvHOME is the name of the environment variable containing the porter home directory path.
	EnvHOME = "PORTER_HOME"

	// EnvBundleName is the name of the environment variable containing the name of the bundle.
	EnvBundleName = "CNAB_BUNDLE_NAME"

	// EnvClaimName is the name of the environment variable containing the name of the claim.
	EnvClaimName = "CNAB_INSTALLATION_NAME"

	// EnvACTION is the request
	EnvACTION = "CNAB_ACTION"

	// EnvDEBUG is a custom porter parameter that signals that --debug flag has been passed through from the client to the runtime.
	EnvDEBUG = "PORTER_DEBUG"

	CustomBundleKey = "sh.porter"

	// BundleOutputsDir is the directory where outputs are expected to be placed
	// during the execution of a bundle action.
	BundleOutputsDir = "/cnab/app/outputs"
)

Variables

This section is empty.

Functions

func IsCoreAction 

func IsCoreAction(value Action) bool

IsCoreAction determines if the value is a core action from the CNAB spec.

func NoopDataLoader 

func NoopDataLoader(config *Config) error

NoopDataLoader skips loading the datastore.

func OutputAppliesTo 

func OutputAppliesTo(action string, output bundle.Output) bool

TODO: remove in favor of cnab-go logic: https://github.com/deislabs/cnab-go/pull/129

Types

type Action 

type Action string
const (
	ActionInstall   Action = "install"
	ActionUpgrade   Action = "upgrade"
	ActionUninstall Action = "uninstall"
)

func GetCoreActions 

func GetCoreActions() []Action

type BundleOutput 

type BundleOutput struct {
	Name                string `yaml:"name"`
	Path                string `yaml:"path"`
	EnvironmentVariable string `yaml:"env"`
}

type Config 

type Config struct {
	*context.Context
	Data *Data

	Manifest     *Manifest
	ManifestPath string
	DataLoader   DataStoreLoaderFunc
	// contains filtered or unexported fields
}

func New 

func New() *Config

New Config initializes a default porter configuration.

func (*Config) GetBundlesCache 

func (c *Config) GetBundlesCache() (string, error)

GetBundlesDir locates the bundle cache from the porter home directory.

func (*Config) GetClaimsDir 

func (c *Config) GetClaimsDir() (string, error)

func (*Config) GetCredentialPath 

func (c *Config) GetCredentialPath(name string) (string, error)

func (*Config) GetCredentialsDir 

func (c *Config) GetCredentialsDir() (string, error)

func (*Config) GetHomeDir 

func (c *Config) GetHomeDir() (string, error)

GetHomeDir determines the absolute path to the porter home directory.

func (*Config) GetMixinDir 

func (c *Config) GetMixinDir(mixin string) (string, error)

func (*Config) GetMixinPath 

func (c *Config) GetMixinPath(mixin string) (string, error)

func (*Config) GetMixinRuntimePath 

func (c *Config) GetMixinRuntimePath(mixin string) (string, error)

func (*Config) GetMixinsDir 

func (c *Config) GetMixinsDir() (string, error)

func (*Config) GetPorterPath 

func (c *Config) GetPorterPath() (string, error)

func (*Config) GetPorterRuntimePath 

func (c *Config) GetPorterRuntimePath() (string, error)

func (*Config) LoadData 

func (c *Config) LoadData() error

LoadData from the datastore in PORTER_HOME. This defaults to doing nothing unless DataLoader has been set.

func (*Config) LoadManifest 

func (c *Config) LoadManifest() error

func (*Config) LoadManifestFrom 

func (c *Config) LoadManifestFrom(file string) error

func (*Config) ReadManifest 

func (c *Config) ReadManifest(path string) (*Manifest, error)

ReadManifest determines if specified path is a URL or a filepath. After reading the data in the path it returns a Manifest and any errors

func (*Config) SetHomeDir 

func (c *Config) SetHomeDir(home string)

type CredentialDefinition 

type CredentialDefinition struct {
	Name        string `yaml:"name"`
	Description string `yaml:"description,omitempty"`
	Required    bool   `yaml:"required,omitempty"`

	Location `yaml:",inline"`
}

CredentialDefinition represents the structure or fields of a credential parameter

func (*CredentialDefinition) UnmarshalYAML 

func (cd *CredentialDefinition) UnmarshalYAML(unmarshal func(interface{}) error) error

type CustomActionDefinition 

type CustomActionDefinition struct {
	Description       string `yaml:"description,omitempty"`
	ModifiesResources bool   `yaml:"modifies,omitempty"`
	Stateless         bool   `yaml:"stateless,omitempty"`
}

type Data 

type Data struct {
}

Data is the data stored in PORTER_HOME/porter.toml|yaml|json

type DataStoreLoaderFunc 

type DataStoreLoaderFunc func(*Config) error

type Dependency 

type Dependency struct {
	Tag              string   `yaml:"tag"`
	Versions         []string `yaml:"versions"`
	AllowPrereleases bool     `yaml:"prereleases"`

	Parameters map[string]string `yaml:"parameters,omitempty"`
}

func (*Dependency) Validate 

func (d *Dependency) Validate() error

type Location 

type Location struct {
	Path                string `yaml:"path,omitempty"`
	EnvironmentVariable string `yaml:"env,omitempty"`
}

TODO: use cnab-go's bundle.Location instead, once yaml tags have been added Location represents a Parameter or Credential location in an InvocationImage

func (Location) IsEmpty 

func (l Location) IsEmpty() bool

type Manifest 

type Manifest struct {
	Name        string `yaml:"name,omitempty"`
	Description string `yaml:"description,omitempty"`
	Version     string `yaml:"version,omitempty"`

	// Image is the name of the invocation image in the format REGISTRY/NAME:TAG
	Image string `yaml:"invocationImage,omitempty"`

	// BundleTag is the name of the bundle in the format REGISTRY/NAME:TAG
	BundleTag string `yaml:"tag"`

	// Dockerfile is the relative path to the Dockerfile template for the invocation image
	Dockerfile string `yaml:"dockerfile,omitempty"`

	Mixins []MixinDeclaration `yaml:"mixins,omitempty"`

	Install   Steps `yaml:"install"`
	Uninstall Steps `yaml:"uninstall"`
	Upgrade   Steps `yaml:"upgrade"`

	CustomActions           map[string]Steps                  `yaml:"-"`
	CustomActionDefinitions map[string]CustomActionDefinition `yaml:"customActions,omitempty"`

	Parameters   []ParameterDefinition  `yaml:"parameters,omitempty"`
	Credentials  []CredentialDefinition `yaml:"credentials,omitempty"`
	Dependencies map[string]Dependency  `yaml:"dependencies,omitempty"`
	Outputs      []OutputDefinition     `yaml:"outputs,omitempty"`

	// ImageMap is a map of images referenced in the bundle. If an image relocation mapping is later provided, that
	// will be mounted at as a file at runtime to /cnab/app/relocation-mapping.json.
	// TODO: porter should handle the relocation and overwrite the repository and tag (if present), and
	// populate originalImage
	ImageMap map[string]MappedImage `yaml:"images,omitempty"`
}

func UnmarshalManifest 

func UnmarshalManifest(manifestData []byte) (*Manifest, error)

func (*Manifest) Validate 

func (m *Manifest) Validate() error

type MappedImage 

type MappedImage struct {
	Description   string            `yaml:"description"`
	ImageType     string            `yaml:"imageType"`
	Repository    string            `yaml:"repository"`
	OriginalImage string            `yaml:"originalImage,omitempty"`
	Digest        string            `yaml:"digest,omitempty"`
	Size          uint64            `yaml:"size,omitempty"`
	MediaType     string            `yaml:"mediaType,omitempty"`
	Labels        map[string]string `yaml:"labels,omitempty"`
	Tag           string            `yaml:"tag,omitempty"`
}

type MixinDeclaration 

type MixinDeclaration struct {
	Name   string
	Config interface{}
}

func (MixinDeclaration) MarshalYAML 

func (m MixinDeclaration) MarshalYAML() (interface{}, error)

MarshalYAML allows mixin declarations to either be a normal list of strings mixins: - exec - helm or allow some entries to have config data defined

  • az: extensions:
  • iot

func (*MixinDeclaration) UnmarshalYAML 

func (m *MixinDeclaration) UnmarshalYAML(unmarshal func(interface{}) error) error

UnmarshalYAML allows mixin declarations to either be a normal list of strings mixins: - exec - helm or allow some entries to have config data defined

  • az: extensions:
  • iot

type OutputDefinition 

type OutputDefinition struct {
	Name      string   `yaml:"name"`
	ApplyTo   []string `yaml:"applyTo,omitempty"`
	Sensitive bool     `yaml:"sensitive"`

	definition.Schema `yaml:",inline"`
}

OutputDefinition defines a single output for a CNAB

func (*OutputDefinition) Validate 

func (od *OutputDefinition) Validate() error

type ParameterDefinition 

type ParameterDefinition struct {
	Name      string `yaml:"name"`
	Sensitive bool   `yaml:"sensitive"`

	// These fields represent a subset of bundle.Parameter as defined in deislabs/cnab-go,
	// minus the 'Description' field (definition.Schema's will be used) and `Definition` field
	ApplyTo     []string `yaml:"applyTo,omitempty"`
	Destination Location `yaml:",inline,omitempty"`

	definition.Schema `yaml:",inline"`
}

ParameterDefinition defines a single parameter for a CNAB bundle

func (*ParameterDefinition) DeepCopy 

func (pd *ParameterDefinition) DeepCopy() *ParameterDefinition

DeepCopy copies a ParameterDefinition and returns the copy

func (*ParameterDefinition) Validate 

func (pd *ParameterDefinition) Validate() error

type RuntimeManifest 

type RuntimeManifest struct {
	*Manifest
	*context.Context

	Action Action
	// contains filtered or unexported fields
}

func NewRuntimeManifest 

func NewRuntimeManifest(cxt *context.Context, action Action, manifest *Manifest) RuntimeManifest

func (*RuntimeManifest) ApplyStepOutputs 

func (m *RuntimeManifest) ApplyStepOutputs(step *Step, assignments map[string]string) error

func (*RuntimeManifest) GetSensitiveValues 

func (m *RuntimeManifest) GetSensitiveValues() []string

func (*RuntimeManifest) GetSteps 

func (m *RuntimeManifest) GetSteps() Steps

func (*RuntimeManifest) Prepare 

func (m *RuntimeManifest) Prepare() error

Prepare prepares the runtime environment prior to step execution

func (*RuntimeManifest) ResolveStep 

func (m *RuntimeManifest) ResolveStep(step *Step) error

ResolveStep will walk through the Step's data and resolve any placeholder data using the definitions in the manifest, like parameters or credentials.

func (*RuntimeManifest) Validate 

func (m *RuntimeManifest) Validate() error

type Step 

type Step struct {
	Data map[string]interface{} `yaml:",inline"`
}

func (*Step) GetDescription 

func (s *Step) GetDescription() (string, error)

GetDescription returns a description of the step. Every step must have this property.

func (*Step) GetMixinName 

func (s *Step) GetMixinName() string

func (*Step) Validate 

func (s *Step) Validate(m *Manifest) error

type StepOutput 

type StepOutput struct {
	Name string                 `yaml:"name"`
	Data map[string]interface{} `yaml:",inline"`
	// contains filtered or unexported fields
}

type Steps 

type Steps []*Step

func (Steps) Validate 

func (s Steps) Validate(m *Manifest) error

type TestConfig 

type TestConfig struct {
	*Config
	TestContext *context.TestContext
}

func NewTestConfig 

func NewTestConfig(t *testing.T) *TestConfig

NewTestConfig initializes a configuration suitable for testing, with the output buffered, and an in-memory file system.

func (*TestConfig) SetupIntegrationTest 

func (c *TestConfig) SetupIntegrationTest(home string)

InitializePorterHome initializes the filesystem with the supporting files in the PORTER_HOME directory.

func (*TestConfig) SetupPorterHome 

func (c *TestConfig) SetupPorterHome()

InitializePorterHome initializes the test filesystem with the supporting files in the PORTER_HOME directory.

Source Files

View all Source files

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.