singularity

package
v4.1.2 Latest Latest
Warning

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

 Go to latest Published: Mar 5, 2024 License: BSD-3-Clause Imports: 52 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

View Source 
var ErrLoginAborted = errors.New("user aborted login")

ErrLoginAborted is raised when the login process has been aborted by the user

Functions

func CapabilityAdd 

func CapabilityAdd(capFile string, c CapManageConfig) error

CapabilityAdd adds the specified capability set to the capability file

func CapabilityAvail 

func CapabilityAvail(c CapAvailConfig) error

CapabilityAvail lists the capabilities based on the CapAvailConfig

func CapabilityDrop 

func CapabilityDrop(capFile string, c CapManageConfig) error

CapabilityDrop drops the specified capability set from the capability file

func CapabilityList 

func CapabilityList(capFile string, c CapListConfig) error

CapabilityList lists the capabilities based on the CapListConfig

func CleanSingularityCache 

func CleanSingularityCache(imgCache *cache.Handle, dryRun bool, cacheCleanTypes []string, days int) error

CleanSingularityCache is the main function that drives all these other functions. If force is true, remove the entries, otherwise only provide a summary of what would have been done. If cacheCleanTypes contains something, only clean that type. The special value "all" is interpreted as "all types of entries". If cacheName contains something, clean only cache entries matching that name.

func CompilePlugin 

func CompilePlugin(sourceDir, destSif, buildTags string) error

CompilePlugin compiles a plugin. It takes as input: sourceDir, the path to the plugin's source code directory; and destSif, the path to the intended final location of the plugin SIF file.

func CreatePlugin 

func CreatePlugin(dir, name string) error

CreatePlugin create the plugin directory skeleton.

func DeleteImage 

func DeleteImage(ctx context.Context, scsConfig *scs.Config, imageRef, arch string) error

DeleteImage deletes an image from a remote library.

func DisablePlugin 

func DisablePlugin(name, _ string) error

DisablePlugin disables the named plugin.

func EnablePlugin 

func EnablePlugin(name string) error

EnablePlugin enables the named plugin.

func FakerootConfig 

func FakerootConfig(username string, op FakerootConfigOp) error

FakerootConfig allows to add/remove/enable/disable a user fakeroot mapping entry in /etc/subuid and /etc/subgid files.

func GlobalConfig 

func GlobalConfig(args []string, configFile string, dry bool, op GlobalConfigOp) error

GlobalConfig allows to set/unset/reset a configuration directive value in singularity.conf

func InspectPlugin 

func InspectPlugin(name string) error

InspectPlugin inspects the named plugin.

func InstallPlugin 

func InstallPlugin(pluginPath string) error

InstallPlugin takes a plugin located at path and installs it into the singularity plugin installation directory.

Installing a plugin will also automatically enable it.

func InstanceStats 

func InstanceStats(ctx context.Context, name, instanceUser string, formatJSON bool, noStream bool) error

InstanceStats uses underlying cgroups to get statistics for a named instance

func KeyserverAdd 

func KeyserverAdd(name, uri string, order uint32, insecure bool) error

func KeyserverList 

func KeyserverList(remoteName string, usrConfigFile string) (err error)

KeyserverList prints information about remote configurations

func KeyserverLogin 

func KeyserverLogin(usrConfigFile string, args *LoginArgs) (err error)

KeyserverLogin logs in to a keyserver.

func KeyserverRemove 

func KeyserverRemove(name, uri string) error

func ListPlugins 

func ListPlugins() error

ListPlugins lists the singularity plugins installed in the plugin installation directory.

func ListSingularityCache 

func ListSingularityCache(imgCache *cache.Handle, cacheListTypes []string, cacheListVerbose bool) error

ListSingularityCache will list the local singularity cache for the types specified by cacheListTypes. If cacheListTypes contains the value "all", all the cache entries are considered. If cacheListVerbose is true, the entries will be shown in the output, otherwise only a summary is provided.

func OciCreate 

func OciCreate(containerID string, args *OciArgs) error

OciCreate creates a container from an OCI bundle

func OciDelete 

func OciDelete(ctx context.Context, containerID string) error

OciDelete deletes container resources

func OciExec 

func OciExec(containerID string, cmdArgs []string) error

OciExec executes a command in a container

func OciKill 

func OciKill(containerID string, killSignal string) error

OciKill kills container process

func OciMount 

func OciMount(ctx context.Context, image string, bundle string) error

OciMount mount a SIF image to create an OCI bundle

func OciPause 

func OciPause(containerID string) error

OciPause pauses processes in a container

func OciResume 

func OciResume(containerID string) error

OciResume pauses processes in a container

func OciRun 

func OciRun(ctx context.Context, containerID string, args *OciArgs) error

OciRun runs a container (equivalent to create/start/delete)

func OciStart 

func OciStart(containerID string) error

OciStart starts a previously create container

func OciState 

func OciState(containerID string, _ *OciArgs) error

OciState queries container state

func OciUmount 

func OciUmount(ctx context.Context, bundle string) error

OciUmount umount SIF and delete OCI bundle

func OciUpdate 

func OciUpdate(containerID string, args *OciArgs) error

OciUpdate updates container cgroups resources

func OtherLogout added in v4.1.0 

func OtherLogout(usrConfigFile, name string, reqAuthFile string) (err error)

RemoteLogout logs out from a keyserver or OCI/Docker registry.

func OverlayCreate 

func OverlayCreate(size int, imgPath string, overlaySparse bool, overlayDirs ...string) error

OverlayCreate creates the overlay with an optional size, image path, dirs, and sparse option.

func PrintInstanceList 

func PrintInstanceList(w io.Writer, name, user string, formatJSON bool, showLogs bool) error

PrintInstanceList fetches instance list, applying name and user filters, and prints it in a regular or a JSON format (if formatJSON is true) to the passed writer. Additionally, fetches log paths (if showLogs is true).

func RegistryList 

func RegistryList(usrConfigFile string) (err error)

RegistryList prints information about remote configurations

func RegistryLogin 

func RegistryLogin(usrConfigFile string, args *LoginArgs, reqAuthFile string) (err error)

RegistryLogin logs in to an OCI/Docker registry.

func RemoteAdd 

func RemoteAdd(configFile, name, uri string, global, insecure, makeDefault bool) (err error)

RemoteAdd adds remote to configuration

func RemoteList 

func RemoteList(usrConfigFile string) (err error)

RemoteList prints information about remote configurations

func RemoteLogin 

func RemoteLogin(usrConfigFile string, args *LoginArgs) (err error)

RemoteLogin logs in remote by setting API token If the supplied remote name is an empty string, it will attempt to use the default remote.

func RemoteLogout 

func RemoteLogout(usrConfigFile, name string) (err error)

RemoteLogout logs out from an endpoint.

func RemoteRemove 

func RemoteRemove(configFile, name string) (err error)

RemoteRemove deletes a remote endpoint from the configuration

func RemoteStatus 

func RemoteStatus(usrConfigFile, name string) (err error)

RemoteStatus checks status of services related to an endpoint If the supplied remote name is an empty string, it will attempt to use the default remote.

func RemoteUse 

func RemoteUse(usrConfigFile, name string, global, exclusive bool) (err error)

RemoteUse sets remote to use

func StopInstance 

func StopInstance(name, user string, sig syscall.Signal, timeout time.Duration) error

StopInstance fetches instance list, applying name and user filters, and stops them by sending a signal sig. If an instance is still running after a grace period defined by timeout is expired, it will be forcibly killed.

func UninstallPlugin 

func UninstallPlugin(name string) error

UninstallPlugin removes the named plugin from the system.

func WriteInstancePidFile 

func WriteInstancePidFile(name, pidFile string) error

WriteInstancePidFile fetches instance's PID and writes it to the pidFile, truncating it if it already exists. Note that the name should not be a glob, i.e. name should identify a single instance only, otherwise an error is returned.

Types

type CapAvailConfig 

type CapAvailConfig struct {
	Caps string
	Desc bool
}

CapAvailConfig instructs CapabilityAvail on what capability to list/describe

type CapListConfig 

type CapListConfig struct {
	User  string
	Group string
	All   bool
}

CapListConfig instructs CapabilityList on what to list

type CapManageConfig 

type CapManageConfig struct {
	Caps  string
	User  string
	Group string
}

CapManageConfig specifies what capability set to edit in the capability file

type FakerootConfigOp 

type FakerootConfigOp uint8

FakerootConfigOp defines a type for a fakeroot configuration operation. 

const (
	// FakerootAddUser is the operation to add a user fakeroot mapping.
	FakerootAddUser FakerootConfigOp = iota
	// FakerootRemoveUser is the operation to remove a user fakeroot mapping.
	FakerootRemoveUser
	// FakerootEnableUser is the operation to enable a user fakeroot mapping.
	FakerootEnableUser
	// FakerootDisableUser is the operation to disable a user fakeroot mapping.
	FakerootDisableUser
)

type GlobalConfigOp 

type GlobalConfigOp uint8

GlobalConfigOp defines a type for a global configuration operation. 

const (
	// GlobalConfigSet is the operation to set a configuration directive value.
	GlobalConfigSet GlobalConfigOp = iota
	// GlobalConfigUnset is the operation to unset a configuration directive value.
	GlobalConfigUnset
	// GlobalConfigGet is the operation to get a configuration directive value.
	GlobalConfigGet
	// GlobalConfigReset is the operation to reset a configuration directive value.
	GlobalConfigReset
)

type LoginArgs 

type LoginArgs struct {
	Name      string
	Username  string
	Password  string
	Tokenfile string
	Insecure  bool
}

type OciArgs 

type OciArgs struct {
	BundlePath   string
	OverlayPaths []string
	LogPath      string
	LogFormat    string
	PidFile      string
	FromFile     string
	KillSignal   string
	KillTimeout  uint32
	EmptyProcess bool
	ForceKill    bool
}

OciArgs contains CLI arguments

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.