manifest

Documentation

Index

• func CheckManifestExists() bool
• func InitaliseNewManifest() error
• func WriteManifestToDisk(manifest *Manifest) error
• type Environment
• type Manifest
  • func FindAndLoadManifest() *Manifest
• type Plugin

Functions

func CheckManifestExists

func CheckManifestExists() bool

CheckManifestExists to determine if there is a manifest in the current dir

func InitaliseNewManifest

func InitaliseNewManifest() error

InitaliseNewManifest creates a new manifest with a survey

func WriteManifestToDisk

func WriteManifestToDisk(manifest *Manifest) error

WriteManifestToDisk - Write the final manifest to disk

Types

type Environment

type Environment struct {
	// A whitelist of allowed accountID's for this enviroment.
	// This restricts where stacks in this project can be deployed to.
	// This is a harm minimisation feature, intended to limit damage from human error.
	AccountIDs []string `yaml:"AccountIDs,omitempty"`

	// A list of Parameters to substiture into the Parameters field of all stacks in this
	// project.
	Parameters map[string]string `yaml:"Parameters,omitempty"`
}

Environment specific parameters

type Manifest

type Manifest struct {
	// Name of this Kombustion project, this can be used to prefix stack names
	Name string `yaml:"Name"`

	// Region is the default region stacks will be deployed to
	Region string `yaml:"Region"`

	// A list of plugins used in this project
	Plugins map[string]Plugin `yaml:"Plugins,omitempty"`

	// An array of architectures this project will be used in. This can be used to limit the number
	// of plugins downloaded.
	// If omitted a plugin will download for all achitectures.
	Architectures []string `yaml:"Architectures,omitempty"`

	// A map of enviroment specific configuration
	Environments map[string]Environment `yaml:"Environments,omitempty"`

	// A flag to indicate if default exports should be added to stacks in this project
	// this defaults to false
	GenerateDefaultOutputs bool `yaml:"GenerateDefaultOutputs"`
}

Manifest - kombustion.yaml manifest file

func FindAndLoadManifest

func FindAndLoadManifest() *Manifest

FindAndLoadManifest - Search the current directory for a manifest file, and load it

type Plugin

type Plugin struct {
	// The name of the plugin to include
	// In the initial version of plugin management, this must be a github url
	Name string `yaml:"Name"`

	// The version to download of the plugin
	// In the initial version this must be a tag on the github url, or
	// `latest` which will use the latest tag.
	Version string `yaml:"Version"`

	// TODO: implement Plugin Aliases
	// This will be useful if two plugins want to use the same namespace
	// Ideally, that wouldn't happen. Ideally.
	Alias string `yaml:"Alias"`
}

Plugin specification inside the manifest