app

Documentation

Index

• Constants
• type BuildImagesOptions
• type Fissile
  • func NewFissileApplication(version string, ui *termui.UI) *Fissile
  • func (f *Fissile) BuildImages(opt BuildImagesOptions) error
  • func (f *Fissile) CleanCache() error
  • func (f *Fissile) Cleanup()
  • func (f *Fissile) CompilationDir() string
  • func (f *Fissile) Compile(stemcellImageName string, targetPath, roleManifestPath, metricsPath string, ...) error
  • func (f *Fissile) DiffConfigurationBases(releasePaths []string, cacheDir string) error
  • func (f *Fissile) GenerateKube(settings kube.ExportSettings) error
  • func (f *Fissile) GetDiffConfigurationBases(releasePaths []string, cacheDir string) (*HashDiffs, error)
  • func (f *Fissile) GraphBegin(outputPath string) error
  • func (f *Fissile) GraphEdge(fromNode, toNode string, attrs map[string]string) error
  • func (f *Fissile) GraphEnd() error
  • func (f *Fissile) GraphNode(nodeName string, attrs map[string]string) error
  • func (f *Fissile) ListJobs() error
  • func (f *Fissile) ListPackages() error
  • func (f *Fissile) ListProperties() error
  • func (f *Fissile) ListRoleImages(existingOnDocker, withVirtualSize bool, tagExtra string) error
  • func (f *Fissile) LoadManifest() error
  • func (f *Fissile) SerializeJobs() (map[string]interface{}, error)
  • func (f *Fissile) SerializePackages() (map[string]interface{}, error)
  • func (f *Fissile) SerializeReleases() (map[string]interface{}, error)
  • func (f *Fissile) StemcellCompilationDir(stemcell string) string
  • func (f *Fissile) Validate() validation.ErrorList
• type FissileOptions
• type HashDiffs
• type OutputFormat

Constants

const (
	OutputFormatHuman = "human" // output for human consumption
	OutputFormatJSON  = "json"  // output as JSON
	OutputFormatYAML  = "yaml"  // output as YAML
)

Valid output formats

Types

type BuildImagesOptions

type BuildImagesOptions struct {
	Force                    bool
	Labels                   map[string]string
	NoBuild                  bool
	OutputDirectory          string
	PatchPropertiesDirective string
	Roles                    []string
	Stemcell                 string
	StemcellID               string
	TagExtra                 string
}

BuildImagesOptions contains all option values for the `fissile build images` command.

type Fissile

type Fissile struct {
	Version  string
	UI       *termui.UI
	Manifest *model.RoleManifest
	Options  FissileOptions
	// contains filtered or unexported fields
}

Fissile represents a fissile application.

func NewFissileApplication

func NewFissileApplication(version string, ui *termui.UI) *Fissile

NewFissileApplication creates a new app.Fissile.

func (*Fissile) BuildImages

func (f *Fissile) BuildImages(opt BuildImagesOptions) error

BuildImages builds all role images using releases.

func (*Fissile) CleanCache

func (f *Fissile) CleanCache() error

CleanCache inspects the compilation cache and removes all packages which are not referenced (anymore).

func (*Fissile) Cleanup

func (f *Fissile) Cleanup()

Cleanup is a destructor.

func (*Fissile) CompilationDir

func (f *Fissile) CompilationDir() string

CompilationDir returns the path to the compilation directory.

func (*Fissile) Compile

func (f *Fissile) Compile(stemcellImageName string, targetPath, roleManifestPath, metricsPath string, instanceGroupNames, releaseNames []string, workerCount int, dockerNetworkMode string, withoutDocker, verbose bool, packageCacheConfigFilename string, streamPackages bool) error

Compile will compile a list of dev BOSH releases.

func (*Fissile) DiffConfigurationBases

func (f *Fissile) DiffConfigurationBases(releasePaths []string, cacheDir string) error

DiffConfigurationBases generates a diff comparing the specs for two different BOSH releases.

func (*Fissile) GenerateKube

func (f *Fissile) GenerateKube(settings kube.ExportSettings) error

GenerateKube will create a set of configuration files suitable for deployment on Kubernetes.

func (*Fissile) GetDiffConfigurationBases

func (f *Fissile) GetDiffConfigurationBases(releasePaths []string, cacheDir string) (*HashDiffs, error)

GetDiffConfigurationBases calculates the difference in configs and returns a hash.

func (*Fissile) GraphBegin

func (f *Fissile) GraphBegin(outputPath string) error

GraphBegin will start logging hash information to the given file.

func (*Fissile) GraphEdge

func (f *Fissile) GraphEdge(fromNode, toNode string, attrs map[string]string) error

GraphEdge adds an edge to the hash debugging graph; this implements model.ModelGrapher.

func (*Fissile) GraphEnd

func (f *Fissile) GraphEnd() error

GraphEnd will stop logging hash information.

func (*Fissile) GraphNode

func (f *Fissile) GraphNode(nodeName string, attrs map[string]string) error

GraphNode adds a node to the hash debugging graph; this implements model.ModelGrapher.

func (*Fissile) ListJobs

func (f *Fissile) ListJobs() error

ListJobs will list all jobs within a list of releases.

func (*Fissile) ListPackages

func (f *Fissile) ListPackages() error

ListPackages will list all BOSH packages within a list of releases.

func (*Fissile) ListProperties

func (f *Fissile) ListProperties() error

ListProperties will list all properties in all jobs within a list of releases.

func (*Fissile) ListRoleImages

func (f *Fissile) ListRoleImages(existingOnDocker, withVirtualSize bool, tagExtra string) error

ListRoleImages lists all dev role images.

func (*Fissile) LoadManifest

func (f *Fissile) LoadManifest() error

LoadManifest loads the manifest in use by fissile.

func (*Fissile) SerializeJobs

func (f *Fissile) SerializeJobs() (map[string]interface{}, error)

SerializeJobs will return all of the jobs within the releases, keyed by fingerprint.

func (*Fissile) SerializePackages

func (f *Fissile) SerializePackages() (map[string]interface{}, error)

SerializePackages returns all packages in loaded releases, keyed by fingerprint.

func (*Fissile) SerializeReleases

func (f *Fissile) SerializeReleases() (map[string]interface{}, error)

SerializeReleases will return all of the loaded releases.

func (*Fissile) StemcellCompilationDir

func (f *Fissile) StemcellCompilationDir(stemcell string) string

StemcellCompilationDir returns the path to the compilation directory for a particular stemcell.

func (*Fissile) Validate

func (f *Fissile) Validate() validation.ErrorList

Validate applies a series of checks to the role manifest and opinions, testing for consistency against each other and the loaded bosh releases. The result is a (possibly empty) array of any issues found.

type FissileOptions

type FissileOptions struct {
	RoleManifest       string
	Releases           []string
	ReleaseNames       []string
	ReleaseVersions    []string
	FinalReleasesDir   string
	CacheDir           string
	WorkDir            string
	DockerRegistry     string
	DockerOrganization string
	DockerUsername     string
	DockerPassword     string
	RepositoryPrefix   string
	Workers            int
	LightOpinions      string
	DarkOpinions       string
	OutputFormat       string
	Metrics            string
	Verbose            bool
}

FissileOptions contains the values of all global fissile application options.

type HashDiffs

type HashDiffs struct {
	AddedKeys     []string
	DeletedKeys   []string
	ChangedValues map[string][2]string
}

HashDiffs summarizes the diffs between the two configs.

type OutputFormat

type OutputFormat string

OutputFormat is one of the known output formats for commands showing loaded information.