system

Documentation

Index

• Constants
• func AuthorizeSSHKeys(user string, keysName string, keys []string) error
• func CreateUser(u *config.User) error
• func DecodeBase64Content(content string) ([]byte, error)
• func DecodeContent(content string, encoding string) ([]byte, error)
• func DecodeGzipContent(content string) ([]byte, 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)
• type EnvFile
• type EtcHosts
  • func (eh EtcHosts) File() (*File, error)
• type Etcd
  • func (ee Etcd) Units() []Unit
• type File
  • func (f *File) Permissions() (os.FileMode, error)
• type Flannel
  • func (fl Flannel) File() (*File, error)
• type Fleet
  • func (fe Fleet) Units() []Unit
• type Locksmith
  • func (ee Locksmith) Units() []Unit
• type OEM
  • func (oem OEM) File() (*File, error)
• type Unit
  • func (u Unit) Destination(root string) string
  • func (u Unit) DropInDestination(root string, dropIn config.UnitDropIn) string
  • func (u Unit) Group() string
  • func (u Unit) Type() string
• type UnitManager
  • func NewUnitManager(root string) UnitManager
• type Update
  • func (uc Update) File() (*File, error)
  • func (uc Update) Units() []Unit

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 DecodeBase64Content

func DecodeBase64Content(content string) ([]byte, error)

func DecodeContent

func DecodeContent(content string, encoding string) ([]byte, error)

func DecodeGzipContent

func DecodeGzipContent(content string) ([]byte, 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)

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.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

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 Flannel

type Flannel struct {
	config.Flannel
}

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

func (Flannel) File

func (fl Flannel) File() (*File, 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

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

type Locksmith

type Locksmith struct {
	config.Locksmith
}

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

func (Locksmith) Units

func (ee Locksmith) Units() []Unit

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

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 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(), Type(), and Group().

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).

func (Unit) DropInDestination

func (u Unit) DropInDestination(root string, dropIn config.UnitDropIn) string

DropInDestination builds the appropriate absolute file path for the UnitDropIn. The root argument indicates the effective base directory of the system (similar to a chroot) and the dropIn argument is the UnitDropIn for which the destination is being calculated.

func (Unit) Group

func (u Unit) Group() string

Group returns "network" or "system" depending on whether or not the unit is a network unit or otherwise.

func (Unit) Type

func (u Unit) Type() string

Type returns the extension of the unit (everything that follows the final period).

type UnitManager

type UnitManager interface {
	PlaceUnit(unit Unit) error
	PlaceUnitDropIn(unit Unit, dropIn config.UnitDropIn) error
	EnableUnitFile(unit Unit) error
	RunUnitCommand(unit Unit, command string) (string, error)
	MaskUnit(unit Unit) error
	UnmaskUnit(unit Unit) error
	DaemonReload() error
}

func NewUnitManager

func NewUnitManager(root string) UnitManager

type Update

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

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

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