types

Documentation

Index

• Variables
• type Architecture
  • func ParseArchitecture(s string) Architecture
  • func ParseArchitectures(in []string) []Architecture
  • func (a Architecture) Compatible(b Architecture) bool
  • func (a Architecture) String() string
  • func (a Architecture) ToAPK() string
  • func (a Architecture) ToOCIPlatform() *v1.Platform
  • func (a Architecture) ToQEmu() string
  • func (a Architecture) ToRustTriplet(suffix string) string
  • func (a Architecture) ToTriplet(suffix string) string
  • func (a *Architecture) UnmarshalYAML(unmarshal func(interface{}) error) error
• type Group
• type ImageConfiguration
  • func (ic *ImageConfiguration) Load(imageConfigPath string, logger *logrus.Entry) error
  • func (ic *ImageConfiguration) ProbeVCSUrl(imageConfigPath string, logger *logrus.Entry)
  • func (ic *ImageConfiguration) Summarize(logger *logrus.Entry)
  • func (ic *ImageConfiguration) Validate() error
  • func (ic *ImageConfiguration) ValidateServiceBundle() error
• type OSRelease
• type PathMutation
• type User

Variables

var AllArchs = []Architecture{
	_386,
	amd64,
	arm64,
	armv6,
	armv7,
	ppc64le,
	riscv64,
	s390x,
}

AllArchs contains the standard set of supported architectures, which are used by `apko publish` when no architectures are specified.

Types

type Architecture

type Architecture struct {
	// contains filtered or unexported fields
}

Architecture represents a CPU architecture for the container image. TODO(kaniini): Maybe this should be its own package at this point?

func ParseArchitecture

func ParseArchitecture(s string) Architecture

ParseArchitecture parses a single architecture in string form, and returns the equivalent Architecture value.

Any apk-style arch string (e.g., "x86_64") is converted to the OCI-style equivalent ("amd64").

func ParseArchitectures

func ParseArchitectures(in []string) []Architecture

ParseArchitectures parses architecture values in string form, and returns the equivalent slice of Architectures.

apk-style arch strings (e.g., "x86_64") are converted to the OCI-style equivalent ("amd64"). Values are deduped, and the resulting slice is sorted for reproducibility.

func (Architecture) Compatible

func (a Architecture) Compatible(b Architecture) bool

func (Architecture) String

func (a Architecture) String() string

func (Architecture) ToAPK

func (a Architecture) ToAPK() string

ToAPK returns the apk-style equivalent string for the Architecture.

func (Architecture) ToOCIPlatform

func (a Architecture) ToOCIPlatform() *v1.Platform

func (Architecture) ToQEmu

func (a Architecture) ToQEmu() string

func (Architecture) ToRustTriplet

func (a Architecture) ToRustTriplet(suffix string) string

func (Architecture) ToTriplet

func (a Architecture) ToTriplet(suffix string) string

func (*Architecture) UnmarshalYAML

func (a *Architecture) UnmarshalYAML(unmarshal func(interface{}) error) error

type Group

type Group struct {
	GroupName string
	GID       uint32
	Members   []string
}

type ImageConfiguration

type ImageConfiguration struct {
	Contents struct {
		Repositories []string `yaml:"repositories,omitempty"`
		Keyring      []string `yaml:"keyring,omitempty"`
		Packages     []string `yaml:"packages,omitempty"`
	} `yaml:"contents,omitempty"`
	Entrypoint struct {
		Type          string
		Command       string
		ShellFragment string `yaml:"shell-fragment"`

		// TBD: presently a map of service names and the command to run
		Services map[interface{}]interface{}
	} `yaml:"entrypoint,omitempty"`
	Cmd      string `yaml:"cmd,omitempty"`
	WorkDir  string `yaml:"work-dir,omitempty"`
	Accounts struct {
		RunAs  string `yaml:"run-as"`
		Users  []User
		Groups []Group
	} `yaml:"accounts,omitempty"`
	Archs       []Architecture    `yaml:"archs,omitempty"`
	Environment map[string]string `yaml:"environment,omitempty"`
	Paths       []PathMutation    `yaml:"paths,omitempty"`
	OSRelease   OSRelease         `yaml:"os-release,omitempty"`
	VCSUrl      string            `yaml:"vcs-url,omitempty"`
	Annotations map[string]string `yaml:"annotations,omitempty"`
	Include     string            `yaml:"include,omitempty"`
}

func (*ImageConfiguration) Load

func (ic *ImageConfiguration) Load(imageConfigPath string, logger *logrus.Entry) error

Loads an image configuration given a configuration file path.

func (*ImageConfiguration) ProbeVCSUrl

func (ic *ImageConfiguration) ProbeVCSUrl(imageConfigPath string, logger *logrus.Entry)

Attempt to probe an upstream VCS URL if known.

func (*ImageConfiguration) Summarize

func (ic *ImageConfiguration) Summarize(logger *logrus.Entry)

func (*ImageConfiguration) Validate

func (ic *ImageConfiguration) Validate() error

Do preflight checks and mutations on an image configuration.

func (*ImageConfiguration) ValidateServiceBundle

func (ic *ImageConfiguration) ValidateServiceBundle() error

Do preflight checks and mutations on an image configured to manage a service bundle.

type OSRelease

type OSRelease struct {
	Name         string
	ID           string
	VersionID    string `yaml:"version-id"`
	PrettyName   string `yaml:"pretty-name"`
	HomeURL      string `yaml:"home-url"`
	BugReportURL string `yaml:"bug-report-url"`
}

type PathMutation

type PathMutation struct {
	Path        string
	Type        string
	UID         uint32
	GID         uint32
	Permissions uint32
	Source      string
	Recursive   bool
}

type User

type User struct {
	UserName string
	UID      uint32
	GID      uint32
}