system

Documentation

Index

• Constants
• func AuthorizeSSHKeys(user string, keysName string, keys []string) error
• func CreateUser(u *config.User) error
• func DefaultReadConfig() (io.Reader, error)
• func EnsureDirectoryExists(dir string) error
• func ExecuteScript(scriptPath string) (string, error)
• func Hostname() (string, error)
• func MachineID(root string) string
• func RestartNetwork(interfaces []network.InterfaceGenerator) (err error)
• func SetHostname(hostname string) error
• func SetUserPassword(user, hash string) error
• func UserExists(u *config.User) bool
• func WriteEnvFile(ef *EnvFile, root string) error
• func WriteFile(f *File, root string) (string, error)
• func WriteNetworkdConfigs(interfaces []network.InterfaceGenerator) error
• type EnvFile
• type EtcHosts
  • func (eh EtcHosts) File() (*File, error)
• type Etcd
  • func (ee Etcd) Units() ([]Unit, error)
• type File
  • func (f *File) Permissions() (os.FileMode, error)
• type Fleet
  • func (fe Fleet) Units() ([]Unit, error)
• type OEM
  • func (oem OEM) File() (*File, error)
• type Script
• type Unit
  • func (u *Unit) Destination(root string) string
• type UnitManager
  • func NewUnitManager(root string) UnitManager
• type Update
  • func (uc Update) File() (*File, error)
  • func (uc Update) Units() ([]Unit, error)

Constants

const DefaultIpv4Address = "127.0.0.1"

Functions

func AuthorizeSSHKeys

func AuthorizeSSHKeys(user string, keysName string, keys []string) error

Add the provide SSH public key to the core user's list of authorized keys

func CreateUser

func CreateUser(u *config.User) error

func DefaultReadConfig

func DefaultReadConfig() (io.Reader, error)

func EnsureDirectoryExists

func EnsureDirectoryExists(dir string) error

func ExecuteScript

func ExecuteScript(scriptPath string) (string, error)

func Hostname

func Hostname() (string, error)

func MachineID

func MachineID(root string) string

func RestartNetwork

func RestartNetwork(interfaces []network.InterfaceGenerator) (err error)

func SetHostname

func SetHostname(hostname string) error

func SetUserPassword

func SetUserPassword(user, hash string) error

func UserExists

func UserExists(u *config.User) bool

func WriteEnvFile

func WriteEnvFile(ef *EnvFile, root string) error

WriteEnvFile updates an existing env `KEY=value` formated file with new values provided in EnvFile.Vars; File.Content is ignored. Existing ordering and any unknown formatting such as comments are preserved. If no changes are required the file is untouched.

func WriteFile

func WriteFile(f *File, root string) (string, error)

func WriteNetworkdConfigs

func WriteNetworkdConfigs(interfaces []network.InterfaceGenerator) error

Types

type EnvFile

type EnvFile struct {
	Vars map[string]string
	// mask File.Content, it shouldn't be used.
	Content interface{} `json:"-" yaml:"-"`
	*File
}

type EtcHosts

type EtcHosts struct {
	Config config.EtcHosts
}

func (EtcHosts) File

func (eh EtcHosts) File() (*File, error)

type Etcd

type Etcd struct {
	config.Etcd
}

Etcd is a top-level structure which embeds its underlying configuration, config.Etcd, and provides the system-specific Unit().

func (Etcd) Units

func (ee Etcd) Units() ([]Unit, error)

Units creates a Unit file drop-in for etcd, using any configured options.

type File

type File struct {
	config.File
}

File is a top-level structure which embeds its underlying configuration, config.File, and provides the system-specific Permissions().

func (*File) Permissions

func (f *File) Permissions() (os.FileMode, error)

type Fleet

type Fleet struct {
	config.Fleet
}

Fleet is a top-level structure which embeds its underlying configuration, config.Fleet, and provides the system-specific Unit().

func (Fleet) Units

func (fe Fleet) Units() ([]Unit, error)

Units generates a Unit file drop-in for fleet, if any fleet options were configured in cloud-config

type OEM

type OEM struct {
	config.OEM
}

OEM is a top-level structure which embeds its underlying configuration, config.OEM, and provides the system-specific File().

func (OEM) File

func (oem OEM) File() (*File, error)

type Script

type Script []byte

type Unit

type Unit struct {
	config.Unit
}

Unit is a top-level structure which embeds its underlying configuration, config.Unit, and provides the system-specific Destination().

func (*Unit) Destination

func (u *Unit) Destination(root string) string

Destination builds the appropriate absolute file path for the Unit. The root argument indicates the effective base directory of the system (similar to a chroot).

type UnitManager

type UnitManager interface {
	PlaceUnit(unit *Unit, dst string) error
	EnableUnitFile(unit string, runtime bool) error
	RunUnitCommand(command, unit string) (string, error)
	DaemonReload() error
	MaskUnit(unit *Unit) error
	UnmaskUnit(unit *Unit) error
}

func NewUnitManager

func NewUnitManager(root string) UnitManager

type Update

type Update struct {
	Config     config.Update
	ReadConfig func() (io.Reader, error)
}

Update is a top-level structure which contains its underlying configuration, config.Update, a function for reading the configuration (the default implementation reading from the filesystem), and provides the system-specific File() and Unit().

func (Update) File

func (uc Update) File() (*File, error)

File generates an `/etc/coreos/update.conf` file (if any update configuration options are set in cloud-config) by either rewriting the existing file on disk, or starting from `/usr/share/coreos/update.conf`

func (Update) Units

func (uc Update) Units() ([]Unit, error)

Units generates units for the cloud-init initializer to act on: - a locksmith Unit, if "reboot-strategy" was set in cloud-config - an update_engine Unit, if "group" or "server" was set in cloud-config