builder

Documentation

Index

• Constants
• Variables
• type Builder
  • func New() *Builder
  • func NewFromConfig(conf string) (*Builder, error)
  • func (b *Builder) AddBundles(bundles []string, allLocal bool, allUpstream bool, git bool) error
  • func (b *Builder) AddRPMList(rpms []string) error
  • func (b *Builder) AddRepo(name, url string) error
  • func (b *Builder) BuildBundles(template *x509.Certificate, privkey *rsa.PrivateKey, signflag bool) error
  • func (b *Builder) BuildDeltaPacks(from, to uint32, printReport bool) error
  • func (b *Builder) BuildDeltaPacksPreviousVersions(prev, to uint32, printReport bool) error
  • func (b *Builder) BuildImage(format string, template string) error
  • func (b *Builder) BuildUpdate(prefixflag string, minVersion int, format string, skipSigning bool, ...) error
  • func (b *Builder) CheckBumpNeeded(silent bool) (bool, error)
  • func (b *Builder) CopyFullGroupsINI() error
  • func (b *Builder) DownloadFileFromUpstream(subpath string, filePath string) error
  • func (b *Builder) DownloadFileFromUpstreamAsString(subpath string) (string, error)
  • func (b *Builder) EditBundles(bundles []string, suppressEditor bool, add bool, git bool) error
  • func (b *Builder) GetHostAndUpstreamFormats() (string, string, error)
  • func (b *Builder) GetLastBuildVersion() (string, error)
  • func (b *Builder) InitMix(upstreamVer string, mixVer string, allLocal bool, allUpstream bool, ...) error
  • func (b *Builder) ListBundles(listType listType, tree bool) error
  • func (b *Builder) ListRepos() error
  • func (b *Builder) NewDNFConfIfNeeded() error
  • func (b *Builder) PrintVersions() error
  • func (b *Builder) ReadVersions() error
  • func (b *Builder) RemoveBundles(bundles []string, mix bool, local bool, git bool) error
  • func (b *Builder) RemoveRepo(name string) error
  • func (b *Builder) RevertFullGroupsINI() error
  • func (b *Builder) RunCommandInContainer(cmd []string) error
  • func (b *Builder) SetURLRepo(name, url string) error
  • func (b *Builder) SignManifestMoM() error
  • func (b *Builder) UnstageMixFromBump() error
  • func (b *Builder) UpdateFormatVersion(version string) error
  • func (b *Builder) UpdateMixVer(version int) error
  • func (b *Builder) UpdateVersions(nextMix, nextUpstream uint32) error
  • func (b *Builder) ValidateBundles(bundles []string, lvl ValidationLevel) error
  • func (b *Builder) ValidateLocalBundles(lvl ValidationLevel) error
• type ValidationLevel

Constants

const (
	MixList      listType = iota // List bundles in the mix (with includes)
	LocalList                    // List bundles available locally
	UpstreamList                 // List bundles available upstream
)

Enum of available list types

const Version = "4.6.2"

Version of Mixer. Also used by the Makefile for releases.

Variables

var Native = true

Native controls whether mixer runs the command on the native machine or in a container.

var Offline = false

Offline controls whether mixer attempts to automatically cache upstream bundles. In offline mode, all necessary bundles must exist in local-bundles.

Types

type Builder

type Builder struct {
	Config config.MixConfig

	BuildScript string
	BuildConf   string

	MixVer            string
	MixVerFile        string
	MixBundlesFile    string
	LocalPackagesFile string
	UpstreamURL       string
	UpstreamURLFile   string
	UpstreamVer       string
	UpstreamVerFile   string

	Signing int
	Bump    int

	NumFullfileWorkers int
	NumDeltaWorkers    int
	NumBundleWorkers   int

	// Parsed versions.
	MixVerUint32      uint32
	UpstreamVerUint32 uint32
}

A Builder contains all configurable fields required to perform a full mix operation, and is used to encapsulate life time data.

func New

func New() *Builder

New will return a new instance of Builder with some predetermined sane default values.

func NewFromConfig

func NewFromConfig(conf string) (*Builder, error)

NewFromConfig creates a new Builder with the given Configuration.

func (*Builder) AddBundles

func (b *Builder) AddBundles(bundles []string, allLocal bool, allUpstream bool, git bool) error

AddBundles adds the specified bundles to the Mix Bundles List. Values are verified as valid, and duplicate values are removed. The resulting Mix Bundles List will be in sorted order.

func (*Builder) AddRPMList

func (b *Builder) AddRPMList(rpms []string) error

AddRPMList copies rpms into the repodir and calls createrepo_c on it to generate a dnf-consumable repository for the bundle builder to use.

func (*Builder) AddRepo

func (b *Builder) AddRepo(name, url string) error

AddRepo adds and enables a repo configuration named <name> pointing at URL <url>. It calls b.NewDNFConfIfNeeded() to create the DNF config if it does not exist and performs a check to see if the repo passed has already been configured.

func (*Builder) BuildBundles

func (b *Builder) BuildBundles(template *x509.Certificate, privkey *rsa.PrivateKey, signflag bool) error

BuildBundles will attempt to construct the bundles required by generating a DNF configuration file, then resolving all files for each bundle using dnf resolve and no-op installs. One full chroot is created from this step with the file contents of all bundles.

func (*Builder) BuildDeltaPacks

func (b *Builder) BuildDeltaPacks(from, to uint32, printReport bool) error

BuildDeltaPacks between two versions of the mix.

func (*Builder) BuildDeltaPacksPreviousVersions

func (b *Builder) BuildDeltaPacksPreviousVersions(prev, to uint32, printReport bool) error

BuildDeltaPacksPreviousVersions builds packs to version from up to prev versions. It walks the Manifest "previous" field to find those from versions.

func (*Builder) BuildImage

func (b *Builder) BuildImage(format string, template string) error

BuildImage will now proceed to build the full image with the previously validated configuration.

func (*Builder) BuildUpdate

func (b *Builder) BuildUpdate(prefixflag string, minVersion int, format string, skipSigning bool, publish bool, keepChroots bool) error

BuildUpdate will produce an update consumable by the swupd client

func (*Builder) CheckBumpNeeded

func (b *Builder) CheckBumpNeeded(silent bool) (bool, error)

CheckBumpNeeded returns nil if it successfully deduces there is no format bump boundary being crossed.

func (*Builder) CopyFullGroupsINI

func (b *Builder) CopyFullGroupsINI() error

CopyFullGroupsINI copies the initial ini file which has ALL bundle definitions

func (*Builder) DownloadFileFromUpstream

func (b *Builder) DownloadFileFromUpstream(subpath string, filePath string) error

DownloadFileFromUpstream will download a file from the Upstream URL joined with the passed subpath and write that file to the supplied file path. If the path is left empty, the file name will be inferred from the source and written to PWD.

func (*Builder) DownloadFileFromUpstreamAsString

func (b *Builder) DownloadFileFromUpstreamAsString(subpath string) (string, error)

DownloadFileFromUpstreamAsString will download a file from the Upstream URL joined with the passed subpath. It will trim leading and trailing whitespace from the result.

func (*Builder) EditBundles

func (b *Builder) EditBundles(bundles []string, suppressEditor bool, add bool, git bool) error

EditBundles copies a list of bundles from upstream-bundles to local-bundles (if they are not already there) or creates a blank template if they are new, and launches an editor to edit them. Passing true for 'suppressEditor' will suppress the launching of the editor (and just do the copy or create, if needed), and 'add' will also add the bundles to the mix.

func (*Builder) GetHostAndUpstreamFormats

func (b *Builder) GetHostAndUpstreamFormats() (string, string, error)

GetHostAndUpstreamFormats retreives the formats for the host and the mix's upstream version. It attempts to determine the format for the host machine, and if successful, looks up the format for the desired upstream version.

func (*Builder) GetLastBuildVersion

func (b *Builder) GetLastBuildVersion() (string, error)

GetLastBuildVersion returns the version number of the most recent build

func (*Builder) InitMix

func (b *Builder) InitMix(upstreamVer string, mixVer string, allLocal bool, allUpstream bool, noDefaults bool, upstreamURL string, git bool) error

InitMix will initialise a new swupd-client consumable "mix" with the given based Clear Linux version and specified mix version.

func (*Builder) ListBundles

func (b *Builder) ListBundles(listType listType, tree bool) error

ListBundles prints out a bundle list in either a flat list or tree view

func (*Builder) ListRepos

func (b *Builder) ListRepos() error

ListRepos lists all configured repositories in the DNF configuration file. This will fail if a DNF conf has not yet been generated.

func (*Builder) NewDNFConfIfNeeded

func (b *Builder) NewDNFConfIfNeeded() error

NewDNFConfIfNeeded creates a new DNF configuration file if it does not already exist

func (*Builder) PrintVersions

func (b *Builder) PrintVersions() error

PrintVersions prints the current mix and upstream versions, and the latest version of upstream.

func (*Builder) ReadVersions

func (b *Builder) ReadVersions() error

ReadVersions will initialise the mix versions (mix and clearlinux) from the configuration files in the version directory.

func (*Builder) RemoveBundles

func (b *Builder) RemoveBundles(bundles []string, mix bool, local bool, git bool) error

RemoveBundles removes a list of bundles from the Mix Bundles List. If a bundle is not present, it is skipped. If 'local' is passed, the corresponding bundle file is removed from local-bundles. Note that this is an irreversible step. The Mix Bundles List is validated when read in, and the resulting Mix Bundles List will be in sorted order.

func (*Builder) RemoveRepo

func (b *Builder) RemoveRepo(name string) error

RemoveRepo removes a configured repo <name> if it exists in the DNF configuration. This will fail if a DNF conf has not yet been generated.

func (*Builder) RevertFullGroupsINI

func (b *Builder) RevertFullGroupsINI() error

RevertFullGroupsINI copies back the full ini to the manifest creator accounts for deleted bundles

func (*Builder) RunCommandInContainer

func (b *Builder) RunCommandInContainer(cmd []string) error

RunCommandInContainer will pull the content necessary to build a docker image capable of running the desired command, build that image, and then run the command in that image.

func (*Builder) SetURLRepo

func (b *Builder) SetURLRepo(name, url string) error

SetURLRepo sets the URL for the repo <name> to <url>. If <name> does not exist it is created.

func (*Builder) SignManifestMoM

func (b *Builder) SignManifestMoM() error

SignManifestMoM will sign the Manifest.MoM file in in place based on the Mix version read from builder.conf.

func (*Builder) UnstageMixFromBump

func (b *Builder) UnstageMixFromBump() error

UnstageMixFromBump resets the upstreamversion file from the temporary ".bump" file, if it exists. This returns the user to their desired upstream version after having completed the upstream format boundary bump builds.

func (*Builder) UpdateFormatVersion

func (b *Builder) UpdateFormatVersion(version string) error

UpdateFormatVersion updates the builder.conf file with a new format version

func (*Builder) UpdateMixVer

func (b *Builder) UpdateMixVer(version int) error

UpdateMixVer sets the mix version in the builder object and writes it out to file

func (*Builder) UpdateVersions

func (b *Builder) UpdateVersions(nextMix, nextUpstream uint32) error

UpdateVersions will validate then update both mix and upstream versions. If upstream version is 0, then the latest upstream version in the current upstream format will be taken instead.

func (*Builder) ValidateBundles

func (b *Builder) ValidateBundles(bundles []string, lvl ValidationLevel) error

ValidateBundles runs bundle parsing validation on a list of local bundles. In addition to parsing errors, errors are generated if the bundle is not found in local-bundles.

func (*Builder) ValidateLocalBundles

func (b *Builder) ValidateLocalBundles(lvl ValidationLevel) error

ValidateLocalBundles runs bundle parsing validation on all local bundles.

type ValidationLevel

type ValidationLevel int

ValidationLevel represents a specific validation level

const (
	BasicValidation ValidationLevel = iota
	StrictValidation
)

Enum of available validation levels