actions

package
v0.0.0-...-8155755 Latest Latest
Warning

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

 Go to latest Published: Feb 4, 2024 License: Apache-2.0 Imports: 30 Imported by: 0

Documentation

Overview

Package 'actions' implements 'debos' modules used for OS creation.

The origin property

Several actions have the 'origin' property. Possible values for the 'origin' property are:

  1. 'recipe' ....... directory the recipe is in
  2. 'filesystem' ... target filesystem root directory from previous filesystem-deploy action or a previous ostree action.
  3. name property of a previous download action

Apt Action

Install packages and their dependencies to the target rootfs with 'apt'. 

# Yaml syntax:
- action: apt
  recommends: bool
  unauthenticated: bool
  update: bool
  packages:
    - package1
    - package2

Mandatory properties:

- packages -- list of packages to install

Optional properties:

- recommends -- boolean indicating if suggested packages will be installed

- unauthenticated -- boolean indicating if unauthenticated packages can be installed

- update -- boolean indicating if `apt update` will be run. Default 'true'.

Debootstrap Action

Construct the target rootfs with debootstrap tool.

Please keep in mind -- file `/etc/resolv.conf` will be removed after execution. Most of the OS scripts used by `debootstrap` copy `resolv.conf` from the host, and this may lead to incorrect configuration when becoming part of the created rootfs. 

# Yaml syntax:
- action: debootstrap
  mirror: URL
  suite: "name"
  components: <list of components>
  variant: "name"
  keyring-package:
  keyring-file:
  certificate:
  private-key:

Mandatory properties:

- suite -- release code name or symbolic name (e.g. "stable")

Optional properties:

- check-gpg -- verify GPG signatures on Release files, true by default

- variant -- name of the bootstrap script variant to use

  • components -- list of components to use for packages selection. If no components are specified debos will use main as default.

Example: 

components: [ main, contrib ]

- keyring-package -- keyring for package validation.

- keyring-file -- keyring file for repository validation.

- merged-usr -- use merged '/usr' filesystem, true by default.

- certificate -- client certificate stored in file to be used for downloading packages from the server.

- private-key -- provide the client's private key in a file separate from the certificate.

Download Action

Download a single file from Internet and unpack it in place if needed. 

# Yaml syntax:
- action: download
  url: http://example.domain/path/filename.ext
  name: firmware
  filename: output_name
  unpack: bool
  compression: gz

Mandatory properties:

- url -- URL to an object for download

- name -- string which allow to use downloaded object in other actions via 'origin' property. If 'unpack' property is set to 'true' name will refer to temporary directory with extracted content.

Optional properties:

- filename -- use this property as the name for saved file. Useful if URL does not contain file name in path, for example it is possible to download files from URLs without path part.

- unpack -- hint for action to extract all files from downloaded archive. See the 'Unpack' action for more information.

- compression -- optional hint for unpack allowing to use proper compression method. See the 'Unpack' action for more information.

FilesystemDeploy Action

Deploy prepared root filesystem to output image by copying the files from the temporary scratch directory to the mounted image and optionally creates various configuration files for the image: '/etc/fstab' and '/etc/kernel/cmdline'. This action requires 'image-partition' action to be executed before it.

After this action has ran, subsequent actions are executed on the mounted output image. 

# Yaml syntax:
- action: filesystem-deploy
  setup-fstab: bool
  setup-kernel-cmdline: bool
  append-kernel-cmdline: arguments

Optional properties:

- setup-fstab -- generate '/etc/fstab' file according to information provided by 'image-partition' action. By default is 'true'.

- setup-kernel-cmdline -- add location of root partition to '/etc/kernel/cmdline' file on target image. By default is 'true'.

- append-kernel-cmdline -- additional kernel command line arguments passed to kernel.

ImagePartition Action

This action creates an image file, partitions it and formats the filesystems. Mountpoints can be defined so the created partitions can be mounted during the build, and optionally (but by-default) mounted at boot in the final system. The mountpoints are sorted on their position in the filesystem hierarchy so the order in the recipe does not matter. 

# Yaml syntax:
- action: image-partition
  imagename: image_name
  imagesize: size
  partitiontype: gpt
  diskid: string
  gpt_gap: offset
  partitions:
    <list of partitions>
  mountpoints:
    <list of mount points>

Mandatory properties:

- imagename -- the name of the image file, relative to the artifact directory.

- imagesize -- generated image size in human-readable form, examples: 100MB, 1GB, etc.

- partitiontype -- partition table type. Currently only 'gpt' and 'msdos' partition tables are supported.

- gpt_gap -- shifting GPT allow to use this gap for bootloaders, for example if U-Boot intersects with original GPT placement. Only works if parted supports an extra argument to mklabel to specify the gpt offset.

- partitions -- list of partitions, at least one partition is needed. Partition properties are described below.

- mountpoints -- list of mount points for partitions. Properties for mount points are described below.

Optional properties:

- diskid -- disk unique identifier string. For 'gpt' partition table, 'diskid' should be in GUID format (e.g.: '00002222-4444-6666-AAAA-BBBBCCCCFFFF' where each character is an hexadecimal digit). For 'msdos' partition table, 'diskid' should be a 32 bits hexadecimal number (e.g. '1234ABCD' without any dash separator). 

   # Yaml syntax for partitions:
   partitions:
     - name: partition name
	   partlabel: partition label
	   fs: filesystem
	   start: offset
	   end: offset
	   features: list of filesystem features
	   extendedoptions: list of filesystem extended options
	   flags: list of flags
	   fsck: bool
	   fsuuid: string
	   partuuid: string

Mandatory properties:

- name -- is used for referencing named partition for mount points configuration (below) and label the filesystem located on this partition. Must be unique.

- fs -- filesystem type used for formatting.

'none' fs type should be used for partition without filesystem.

- start -- offset from beginning of the disk there the partition starts.

- end -- offset from beginning of the disk there the partition ends.

For 'start' and 'end' properties offset can be written in human readable form -- '32MB', '1GB' or as disk percentage -- '100%'.

Optional properties:

- partlabel -- label for the partition in the GPT partition table. Defaults to the `name` property of the partition. May only be used for GPT partitions.

- parttype -- set the partition type in the partition table. The string should be in a hexadecimal format (2-characters) for msdos partition tables and GUID format (36-characters) for GPT partition tables. For instance, "82" for msdos sets the partition type to Linux Swap. Whereas "0657fd6d-a4ab-43c4-84e5-0933c84b4f4f" for GPT sets the partition type to Linux Swap. For msdos partition types hex codes see: https://en.wikipedia.org/wiki/Partition_type For gpt partition type GUIDs see: https://systemd.io/DISCOVERABLE_PARTITIONS/

- features -- list of additional filesystem features which need to be enabled for partition.

- flags -- list of additional flags for partition compatible with parted(8) 'set' command.

- fsck -- if set to `false` -- then set fs_passno (man fstab) to 0 meaning no filesystem checks in boot time. By default is set to `true` allowing checks on boot.

- fsuuid -- file system UUID string. This option is only supported for btrfs, ext2, ext3, ext4 and xfs.

- partuuid -- GPT partition UUID string. A version 5 UUID can be easily generated using the uuid5 template function {{ uuid5 $namespace $data }} $namespace should be a valid UUID and $data can be any string, to generate reproducible UUID value pass a fixed value of namespace and data.

- extendedoptions -- list of additional filesystem extended options which need to be enabled for the partition. 

   # Yaml syntax for mount points:
   mountpoints:
     - mountpoint: path
	   partition: partition label
	   options: list of options
	   buildtime: bool

Mandatory properties:

- partition -- partition name for mounting. The partion must exist under `partitions`.

- mountpoint -- path in the target root filesystem where the named partition should be mounted. Must be unique, only one partition can be mounted per mountpoint.

Optional properties:

- options -- list of options to be added to appropriate entry in fstab file.

- buildtime -- if set to true then the mountpoint only used during the debos run. No entry in `/etc/fstab` will be created. The mountpoints directory will be removed from the image, so it is recommended to define a `mountpoint` path which is temporary and unique for the image, for example: `/mnt/temporary_mount`. Defaults to false. 

# Layout example for Raspberry PI 3:
- action: image-partition
  imagename: "debian-rpi3.img"
  imagesize: 1GB
  partitiontype: msdos
  mountpoints:
    - mountpoint: /
      partition: root
    - mountpoint: /boot/firmware
      partition: firmware
      options: [ x-systemd.automount ]
  partitions:
    - name: firmware
      fs: vfat
      start: 0%
      end: 64MB
    - name: root
      fs: ext4
      start: 64MB
      end: 100%
      flags: [ boot ]

OstreeCommit Action

Create OSTree commit from rootfs. 

# Yaml syntax:
- action: ostree-commit
  repository: repository name
  branch: branch name
  subject: commit message
  collection-id: org.apertis.example
  ref-binding:
    - branch1
    - branch2
  metadata:
    key: value
    vendor.key: somevalue

Mandatory properties:

- repository -- path to repository with OSTree structure; the same path is used by 'ostree' tool with '--repo' argument. This path is relative to 'artifact' directory. Please keep in mind -- you will need a root privileges for 'bare' repository type (https://ostree.readthedocs.io/en/latest/manual/repo/#repository-types-and-locations).

- branch -- OSTree branch name that should be used for the commit.

Optional properties:

- subject -- one line message with commit description.

- collection-id -- Collection ID ref binding (requires libostree 2018.6).

  • ref-binding -- enforce that the commit was retrieved from one of the branch names in this array. If 'collection-id' is set and 'ref-binding' is empty, will default to the branch name.

- metadata -- key-value pairs of meta information to be added into commit.

OstreeDeploy Action

Deploy the OSTree branch to the image. If any preparation has been done for rootfs, it can be overwritten during this step.

Action 'image-partition' must be called prior to OSTree deploy. 

# Yaml syntax:
- action: ostree-deploy
  repository: repository name
  remote_repository: URL
  branch: branch name
  os: os name
  tls-client-cert-path: path to client certificate
  tls-client-key-path: path to client certificate key
  setup-fstab: bool
  setup-kernel-cmdline: bool
  appendkernelcmdline: arguments
  collection-id: org.apertis.example

Mandatory properties:

- remote_repository -- URL to remote OSTree repository for pulling stateroot branch. Currently not implemented, please prepare local repository instead.

- repository -- path to repository with OSTree structure. This path is relative to 'artifact' directory.

- os -- os deployment name, as explained in: https://ostree.readthedocs.io/en/latest/manual/deployment/

- branch -- branch of the repository to use for populating the image.

Optional properties:

- setup-fstab -- create '/etc/fstab' file for image

- setup-kernel-cmdline -- add the information from the 'image-partition' action to the configured commandline.

- append-kernel-cmdline -- additional kernel command line arguments passed to kernel.

- tls-client-cert-path -- path to client certificate to use for the remote repository

- tls-client-key-path -- path to client certificate key to use for the remote repository

- collection-id -- Collection ID ref binding (require libostree 2018.6).

Overlay Action

Recursive copy of directory or file to target filesystem. 

# Yaml syntax:
- action: overlay
  origin: name
  source: directory
  destination: directory

Mandatory properties:

- source -- relative path to the directory or file located in path referenced by `origin`. In case if this property is absent then pure path referenced by 'origin' will be used.

Optional properties:

- origin -- reference to named file or directory.

- destination -- absolute path in the target rootfs where 'source' will be copied. All existing files will be overwritten. If destination isn't set '/' of the rootfs will be used.

Pack Action

Create tarball with filesystem. 

# Yaml syntax:
- action: pack
  file: filename.ext
  compression: gz

Mandatory properties:

- file -- name of the output tarball, relative to the artifact directory.

Optional properties:

- compression -- compression type to use. Currently only 'gz', 'bzip2' and 'xz' compression types are supported. Use 'none' for uncompressed tarball. The 'gz' compression type will be used by default.

Pacman Action

Install packages and their dependencies to the target rootfs with 'pacman'. 

# Yaml syntax:
- action: pacman
  packages:
    - package1
    - package2

Mandatory properties:

- packages -- list of packages to install

Pacstrap Action

Construct the target rootfs with pacstrap tool. 

# Yaml syntax:
- action: pacstrap
  config: <in-tree pacman.conf file>
  mirror: <in-tree mirrorlist file>

Mandatory properties:

  • config -- the pacman.conf file which will be used through the process
  • mirror -- the mirrorlist file which will be used through the process

Raw Action

Directly write a file to the output image at a given offset. This is typically useful for bootloaders. 

# Yaml syntax:
- action: raw
  origin: name
  source: filename
  offset: bytes

Mandatory properties:

- origin -- reference to named file or directory.

- source -- the name of file located in 'origin' to be written into the output image.

Optional properties:

- offset -- offset in bytes for output image file. It is possible to use internal templating mechanism of debos to calculate offset with sectors (512 bytes) instead of bytes, for instance: '{{ sector 256 }}'. The default value is zero.

- partition -- named partition to write to

Package 'recipe' implements actions mapping to YAML recipe.

Recipe syntax

Recipe is a YAML file which is pre-processed though Golang text templating engine (https://golang.org/pkg/text/template)

Recipe is composed of 2 parts:

- header

- actions

Comments are allowed and should be prefixed with '#' symbol. 

# Declare variable 'Var'
{{- $Var := "Value" -}}

# Header
architecture: arm64

# Actions are executed in listed order
actions:
  - action: ActionName1
    property1: true

  - action: ActionName2
    # Use value of variable 'Var' defined above
    property2: {{$Var}}

The following custom template functions are available:

- sector: Returns the argument * 512 (convential sector size) e.g. `{{ sector 64 }}` - escape: Shell escape the argument `{{ escape $var }}` - uuid5: Generates fixed UUID value `{{ uuid5 $random-uuid $text }}` - functions from [slim-sprig](https://go-task.github.io/slim-sprig/)

Mandatory properties for recipe:

- architecture -- target architecture

- actions -- at least one action should be listed

Supported actions

- apt -- https://godoc.org/github.com/AaronDewes/debos/actions#hdr-Apt_Action

- debootstrap -- https://godoc.org/github.com/AaronDewes/debos/actions#hdr-Debootstrap_Action

- download -- https://godoc.org/github.com/AaronDewes/debos/actions#hdr-Download_Action

- filesystem-deploy -- https://godoc.org/github.com/AaronDewes/debos/actions#hdr-FilesystemDeploy_Action

- image-partition -- https://godoc.org/github.com/AaronDewes/debos/actions#hdr-ImagePartition_Action

- ostree-commit -- https://godoc.org/github.com/AaronDewes/debos/actions#hdr-OstreeCommit_Action

- ostree-deploy -- https://godoc.org/github.com/AaronDewes/debos/actions#hdr-OstreeDeploy_Action

- overlay -- https://godoc.org/github.com/AaronDewes/debos/actions#hdr-Overlay_Action

- pack -- https://godoc.org/github.com/AaronDewes/debos/actions#hdr-Pack_Action

- pacman -- https://godoc.org/github.com/AaronDewes/debos/actions#hdr-Pacman_Action

- pacstrap -- https://godoc.org/github.com/AaronDewes/debos/actions#hdr-Pacstrap_Action

- raw -- https://godoc.org/github.com/AaronDewes/debos/actions#hdr-Raw_Action

- recipe -- https://godoc.org/github.com/AaronDewes/debos/actions#hdr-Recipe_Action

- run -- https://godoc.org/github.com/AaronDewes/debos/actions#hdr-Run_Action

- unpack -- https://godoc.org/github.com/AaronDewes/debos/actions#hdr-Unpack_Action

Recipe Action

This action includes the recipe at the given path, and can optionally override or set template variables.

To ensure compatibility, both the parent recipe and all included recipes have to be for the same architecture. For convenience the parent architecture is passed in the "architecture" template variable.

Limitations of combined recipes are equivalent to limitations within a single recipe (e.g. there can only be one image partition action). 

# Yaml syntax:
- action: recipe
  recipe: path to recipe
  variables:
    key: value

Mandatory properties:

- recipe -- includes the recipe actions at the given path.

Optional properties:

- variables -- overrides or adds new template variables.

Run Action

Allows to run any available command or script in the filesystem or in build process host environment: specifically inside the fakemachine created by Debos. 

# Yaml syntax:
- action: run
  chroot: bool
  postprocess: bool
  script: script name
  command: command line
  label: string

Properties 'command' and 'script' are mutually exclusive.

- command -- command with arguments; the command expected to be accessible in host's or chrooted environment -- depending on 'chroot' property.

- script -- script with arguments; script must be located in recipe directory.

Optional properties:

- chroot -- run script or command in target filesystem if set to true. Otherwise the command or script is executed within the build process, with access to the filesystem ($ROOTDIR), the image if any ($IMAGE), the recipe directory ($RECIPEDIR), the artifact directory ($ARTIFACTDIR) and the directory where the image is mounted ($IMAGEMNTDIR). In both cases it is run with root privileges. If unset, chroot is set to false and the command or script is run in the host environment.

- label -- if non-empty, this string is used to label output. If empty, a label is derived from the command or script.

- postprocess -- if set script or command is executed after all other commands and has access to the recipe directory ($RECIPEDIR) and the artifact directory ($ARTIFACTDIR). The working directory will be set to the artifact directory.

Properties 'chroot' and 'postprocess' are mutually exclusive.

Unpack Action

Unpack files from archive to the filesystem. Useful for creating target rootfs from saved tarball with prepared file structure.

Only (compressed) tar archives are supported currently. 

# Yaml syntax:
- action: unpack
  origin: name
  file: file.ext
  compression: gz

Mandatory properties:

- file -- archive's file name. It is possible to skip this property if 'origin' referenced to downloaded file.

One of the mandatory properties may be omitted with limitations mentioned above. It is expected to find archive with name pointed in `file` property inside of `origin` in case if both properties are used.

Optional properties:

- origin -- reference to a named file or directory. The default value is 'artifacts' directory in case if this property is omitted.

- compression -- optional hint for unpack allowing to use proper compression method.

Currently only 'gz', bzip2' and 'xz' compression types are supported. If not provided an attempt to autodetect the compression type will be done.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func DumpActionFields 

func DumpActionFields(iface interface{}, depth int)

func DumpActionStruct 

func DumpActionStruct(iface interface{}) string

func DumpActions 

func DumpActions(iface interface{}, depth int)

Types

type AptAction 

type AptAction struct {
	debos.BaseAction `yaml:",inline"`
	Recommends       bool
	Unauthenticated  bool
	Update           bool
	Packages         []string
}

func NewAptAction 

func NewAptAction() *AptAction

func (*AptAction) Run 

func (apt *AptAction) Run(context *debos.DebosContext) error

type DebootstrapAction 

type DebootstrapAction struct {
	debos.BaseAction `yaml:",inline"`
	Suite            string
	Mirror           string
	Variant          string
	KeyringPackage   string `yaml:"keyring-package"`
	KeyringFile      string `yaml:"keyring-file"`
	Certificate      string
	PrivateKey       string `yaml:"private-key"`
	Components       []string
	MergedUsr        bool `yaml:"merged-usr"`
	CheckGpg         bool `yaml:"check-gpg"`
}

func NewDebootstrapAction 

func NewDebootstrapAction() *DebootstrapAction

func (*DebootstrapAction) PreMachine 

func (d *DebootstrapAction) PreMachine(context *debos.DebosContext, m *fakemachine.Machine, args *[]string) error

func (*DebootstrapAction) Run 

func (d *DebootstrapAction) Run(context *debos.DebosContext) error

func (*DebootstrapAction) RunSecondStage 

func (d *DebootstrapAction) RunSecondStage(context debos.DebosContext) error

func (*DebootstrapAction) Verify 

func (d *DebootstrapAction) Verify(context *debos.DebosContext) error

type DownloadAction 

type DownloadAction struct {
	debos.BaseAction `yaml:",inline"`
	Url              string // URL for downloading
	Filename         string // File name, overrides the name from URL.
	Unpack           bool   // Unpack downloaded file to directory dedicated for download
	Compression      string // compression type
	Name             string // exporting path to file or directory(in case of unpack)
}

func (*DownloadAction) Run 

func (d *DownloadAction) Run(context *debos.DebosContext) error

func (*DownloadAction) Verify 

func (d *DownloadAction) Verify(context *debos.DebosContext) error

type FilesystemDeployAction 

type FilesystemDeployAction struct {
	debos.BaseAction    `yaml:",inline"`
	SetupFSTab          bool   `yaml:"setup-fstab"`
	SetupKernelCmdline  bool   `yaml:"setup-kernel-cmdline"`
	AppendKernelCmdline string `yaml:"append-kernel-cmdline"`
}

func NewFilesystemDeployAction 

func NewFilesystemDeployAction() *FilesystemDeployAction

func (*FilesystemDeployAction) Run 

func (fd *FilesystemDeployAction) Run(context *debos.DebosContext) error

type ImagePartitionAction 

type ImagePartitionAction struct {
	debos.BaseAction `yaml:",inline"`
	ImageName        string
	ImageSize        string
	PartitionType    string
	DiskID           string
	GptGap           string "gpt_gap"
	Partitions       []Partition
	Mountpoints      []Mountpoint
	// contains filtered or unexported fields
}

func (ImagePartitionAction) Cleanup 

func (i ImagePartitionAction) Cleanup(context *debos.DebosContext) error

func (ImagePartitionAction) PostMachineCleanup 

func (i ImagePartitionAction) PostMachineCleanup(context *debos.DebosContext) error

func (ImagePartitionAction) PreMachine 

func (i ImagePartitionAction) PreMachine(context *debos.DebosContext, m *fakemachine.Machine,
	args *[]string) error

func (*ImagePartitionAction) PreNoMachine 

func (i *ImagePartitionAction) PreNoMachine(context *debos.DebosContext) error

func (ImagePartitionAction) Run 

func (i ImagePartitionAction) Run(context *debos.DebosContext) error

func (*ImagePartitionAction) Verify 

func (i *ImagePartitionAction) Verify(context *debos.DebosContext) error

type Mountpoint 

type Mountpoint struct {
	Mountpoint string
	Partition  string
	Options    []string
	Buildtime  bool
	// contains filtered or unexported fields
}

type OstreeCommitAction 

type OstreeCommitAction struct {
	debos.BaseAction `yaml:",inline"`
	Repository       string
	Branch           string
	Subject          string
	Command          string
	CollectionID     string   `yaml:"collection-id"`
	RefBinding       []string `yaml:"ref-binding"`
	Metadata         map[string]string
}

func (*OstreeCommitAction) Run 

func (ot *OstreeCommitAction) Run(context *debos.DebosContext) error

type OstreeDeployAction 

type OstreeDeployAction struct {
	debos.BaseAction    `yaml:",inline"`
	Repository          string
	RemoteRepository    string "remote_repository"
	Branch              string
	Os                  string
	SetupFSTab          bool   `yaml:"setup-fstab"`
	SetupKernelCmdline  bool   `yaml:"setup-kernel-cmdline"`
	AppendKernelCmdline string `yaml:"append-kernel-cmdline"`
	TlsClientCertPath   string `yaml:"tls-client-cert-path"`
	TlsClientKeyPath    string `yaml:"tls-client-key-path"`
	CollectionID        string `yaml:"collection-id"`
}

func NewOstreeDeployAction 

func NewOstreeDeployAction() *OstreeDeployAction

func (*OstreeDeployAction) Run 

func (ot *OstreeDeployAction) Run(context *debos.DebosContext) error

type OverlayAction 

type OverlayAction struct {
	debos.BaseAction `yaml:",inline"`
	Origin           string // origin of overlay, here the export from other action may be used
	Source           string // external path there overlay is
	Destination      string // path inside of rootfs
}

func (*OverlayAction) Run 

func (overlay *OverlayAction) Run(context *debos.DebosContext) error

func (*OverlayAction) Verify 

func (overlay *OverlayAction) Verify(context *debos.DebosContext) error

type PackAction 

type PackAction struct {
	debos.BaseAction `yaml:",inline"`
	Compression      string
	File             string
}

func NewPackAction 

func NewPackAction() *PackAction

func (*PackAction) Run 

func (pf *PackAction) Run(context *debos.DebosContext) error

func (*PackAction) Verify 

func (pf *PackAction) Verify(context *debos.DebosContext) error

type PacmanAction 

type PacmanAction struct {
	debos.BaseAction `yaml:",inline"`
	Packages         []string
}

func (*PacmanAction) Run 

func (p *PacmanAction) Run(context *debos.DebosContext) error

type PacstrapAction 

type PacstrapAction struct {
	debos.BaseAction `yaml:",inline"`
	Config           string `yaml:"config"`
	Mirror           string `yaml:"mirror"`
}

func (*PacstrapAction) PreMachine 

func (d *PacstrapAction) PreMachine(context *debos.DebosContext, m *fakemachine.Machine, args *[]string) error

func (*PacstrapAction) PreNoMachine 

func (d *PacstrapAction) PreNoMachine(context *debos.DebosContext) error

func (*PacstrapAction) Run 

func (d *PacstrapAction) Run(context *debos.DebosContext) error

func (*PacstrapAction) Verify 

func (d *PacstrapAction) Verify(context *debos.DebosContext) error

type Partition 

type Partition struct {
	Name            string
	PartLabel       string
	PartType        string
	PartUUID        string
	Start           string
	End             string
	FS              string
	Flags           []string
	Features        []string
	ExtendedOptions []string
	Fsck            bool "fsck"
	FSUUID          string
	// contains filtered or unexported fields
}

func (*Partition) UnmarshalYAML 

func (p *Partition) UnmarshalYAML(unmarshal func(interface{}) error) error

type RawAction 

type RawAction struct {
	debos.BaseAction `yaml:",inline"`
	Origin           string // there the source comes from
	Offset           string
	Source           string // relative path inside of origin
	Path             string // deprecated option (for backward compatibility)
	Partition        string // Partition to write otherwise full image
}

func (*RawAction) Run 

func (raw *RawAction) Run(context *debos.DebosContext) error

func (*RawAction) Verify 

func (raw *RawAction) Verify(context *debos.DebosContext) error

type Recipe 

type Recipe struct {
	Architecture string
	Actions      []YamlAction
}

func (*Recipe) Parse 

func (r *Recipe) Parse(file string, printRecipe bool, dump bool, templateVars ...map[string]string) error

Parse method reads YAML recipe file and map all steps to appropriate actions.

- file -- is the path to configuration file

- templateVars -- optional argument allowing to use custom map for templating engine. Multiple template maps have no effect; only first map will be used.

type RecipeAction 

type RecipeAction struct {
	debos.BaseAction `yaml:",inline"`
	Recipe           string
	Variables        map[string]string
	Actions          Recipe `yaml:"-"`
	// contains filtered or unexported fields
}

func (*RecipeAction) Cleanup 

func (recipe *RecipeAction) Cleanup(context *debos.DebosContext) error

func (*RecipeAction) PostMachine 

func (recipe *RecipeAction) PostMachine(context *debos.DebosContext) error

func (*RecipeAction) PostMachineCleanup 

func (recipe *RecipeAction) PostMachineCleanup(context *debos.DebosContext) error

func (*RecipeAction) PreMachine 

func (recipe *RecipeAction) PreMachine(context *debos.DebosContext, m *fakemachine.Machine, args *[]string) error

func (*RecipeAction) PreNoMachine 

func (recipe *RecipeAction) PreNoMachine(context *debos.DebosContext) error

func (*RecipeAction) Run 

func (recipe *RecipeAction) Run(context *debos.DebosContext) error

func (*RecipeAction) Verify 

func (recipe *RecipeAction) Verify(context *debos.DebosContext) error

type RunAction 

type RunAction struct {
	debos.BaseAction `yaml:",inline"`
	Chroot           bool
	PostProcess      bool
	Script           string
	Command          string
	Label            string
}

func (*RunAction) PostMachine 

func (run *RunAction) PostMachine(context *debos.DebosContext) error

func (*RunAction) PreMachine 

func (run *RunAction) PreMachine(context *debos.DebosContext, m *fakemachine.Machine,
	args *[]string) error

func (*RunAction) Run 

func (run *RunAction) Run(context *debos.DebosContext) error

func (*RunAction) Verify 

func (run *RunAction) Verify(context *debos.DebosContext) error

type UnpackAction 

type UnpackAction struct {
	debos.BaseAction `yaml:",inline"`
	Compression      string
	Origin           string
	File             string
}

func (*UnpackAction) Run 

func (pf *UnpackAction) Run(context *debos.DebosContext) error

func (*UnpackAction) Verify 

func (pf *UnpackAction) Verify(context *debos.DebosContext) error

type YamlAction 

type YamlAction struct {
	debos.Action
}

the YamlAction just embed the Action interface and implements the * UnmarshalYAML function so it can select the concrete implementer of a * specific action at unmarshaling time

func (*YamlAction) UnmarshalYAML 

func (y *YamlAction) UnmarshalYAML(unmarshal func(interface{}) error) error

Source Files

View all Source files

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.