Documentation ¶
Index ¶
- Constants
- func ConvertToLibpodEvent(e Event) *libpodEvents.Event
- func FilterIDFn(id []string) func(Identifier) bool
- func FilterIDOrNameFn(id []string) func(IDOrNamed) bool
- func FilterNameFn(name []string) func(Named) bool
- func FilterNamesFn(name []string) func(Names) bool
- func ValidatePodStatsOptions(args []string, options *PodStatsOptions) error
- type AttachOptions
- type AutoUpdateOptions
- type AutoUpdateReport
- type BoolReport
- type BuildOptions
- type BuildReport
- type CheckpointOptions
- type CheckpointReport
- type CommitOptions
- type CommitReport
- type ComponentVersion
- type Container
- type ContainerCleanupOptions
- type ContainerCleanupReport
- type ContainerCpOptions
- type ContainerCpReport
- type ContainerCreateReport
- type ContainerCreateResponse
- type ContainerEngine
- type ContainerExportOptions
- type ContainerFilter
- type ContainerInitOptions
- type ContainerInitReport
- type ContainerInspectReport
- type ContainerListOptions
- type ContainerLogsOptions
- type ContainerMountOptions
- type ContainerMountReport
- type ContainerPortOptions
- type ContainerPortReport
- type ContainerPruneOptions
- type ContainerPruneReport
- type ContainerRunOptions
- type ContainerRunReport
- type ContainerRunlabelOptions
- type ContainerRunlabelReport
- type ContainerStartOptions
- type ContainerStartReport
- type ContainerStatsOptions
- type ContainerUnmountOptions
- type ContainerUnmountReport
- type DiffOptions
- type DiffReport
- type EngineMode
- type EngineSetup
- type ErrorModel
- type Event
- type EventsOptions
- type ExecOptions
- type GenerateKubeOptions
- type GenerateKubeReport
- type GenerateSystemdOptions
- type GenerateSystemdReport
- type HealthCheckOptions
- type IDOrNameResponse
- type IDOrNamed
- type IDOrNames
- type Identifier
- type Image
- type ImageEngine
- type ImageFilter
- type ImageHistoryLayer
- type ImageHistoryOptions
- type ImageHistoryReport
- type ImageImportOptions
- type ImageImportReport
- type ImageInspectReport
- type ImageListOptions
- type ImageLoadOptions
- type ImageLoadReport
- type ImagePruneOptions
- type ImagePruneReport
- type ImagePullOptions
- type ImagePullReport
- type ImagePushOptions
- type ImageRemoveOptions
- type ImageRemoveReport
- type ImageSaveOptions
- type ImageSearchOptions
- type ImageSearchReport
- type ImageSummary
- type ImageTagOptions
- type ImageTreeOptions
- type ImageTreeReport
- type ImageUntagOptions
- type InspectOptions
- type KillOptions
- type KillReport
- type ListContainer
- type ListContainerNamespaces
- type ListPodContainer
- type ListPodsReport
- type ListRegistriesReport
- type ManifestAddOptions
- type ManifestAnnotateOptions
- type ManifestCreateOptions
- type ManifestPushOptions
- type Named
- type Names
- type NetOptions
- type NetworkCreateOptions
- type NetworkCreateReport
- type NetworkInspectOptions
- type NetworkInspectReport
- type NetworkListOptions
- type NetworkListReport
- type NetworkRmOptions
- type NetworkRmReport
- type PauseUnPauseOptions
- type PauseUnpauseReport
- type PlayKubeOptions
- type PlayKubePod
- type PlayKubeReport
- type PodCreateOptions
- type PodCreateReport
- type PodDeleteReport
- type PodInspectOptions
- type PodInspectReport
- type PodKillOptions
- type PodKillReport
- type PodPSOptions
- type PodPauseOptions
- type PodPauseReport
- type PodPruneOptions
- type PodPruneReport
- type PodRestartOptions
- type PodRestartReport
- type PodRmOptions
- type PodRmReport
- type PodStartOptions
- type PodStartReport
- type PodStatsOptions
- type PodStatsReport
- type PodStopOptions
- type PodStopReport
- type PodTopOptions
- type PodUnpauseReport
- type PodmanConfig
- type PodunpauseOptions
- type PsSortedCreateTime
- type Report
- type RestartOptions
- type RestartReport
- type RestoreOptions
- type RestoreReport
- type RmOptions
- type RmReport
- type ServiceOptions
- type SetTrustOptions
- type ShowTrustOptions
- type ShowTrustReport
- type SignOptions
- type SignReport
- type SortListContainers
- type StopOptions
- type StopReport
- type StringSet
- type StringSliceReport
- type SystemDfContainerReport
- type SystemDfImageReport
- type SystemDfOptions
- type SystemDfReport
- type SystemDfVolumeReport
- type SystemEngine
- type SystemMigrateOptions
- type SystemPruneOptions
- type SystemPruneReport
- type SystemResetOptions
- type SystemVersionReport
- type TopOptions
- type Volume
- type VolumeConfigResponse
- type VolumeCreateOptions
- type VolumeDeleteOptions
- type VolumeDeleteReport
- type VolumeFilter
- type VolumeInspectOptions
- type VolumeInspectReport
- type VolumeListOptions
- type VolumeListReport
- type VolumePruneOptions
- type VolumePruneReport
- type VolumeRmOptions
- type VolumeRmReport
- type WaitOptions
- type WaitReport
Constants ¶
const ( ABIMode = EngineMode("abi") TunnelMode = EngineMode("tunnel") MigrateMode = EngineSetup("migrate") NoFDsMode = EngineSetup("disablefds") NormalMode = EngineSetup("normal") RenumberMode = EngineSetup("renumber") ResetMode = EngineSetup("reset") )
Variables ¶
This section is empty.
Functions ¶
func ConvertToLibpodEvent ¶
func ConvertToLibpodEvent(e Event) *libpodEvents.Event
ConvertToLibpodEvent converts an entities event to a libpod one.
func FilterIDFn ¶
func FilterIDFn(id []string) func(Identifier) bool
func FilterIDOrNameFn ¶
func FilterNameFn ¶
func FilterNamesFn ¶
func ValidatePodStatsOptions ¶
func ValidatePodStatsOptions(args []string, options *PodStatsOptions) error
ValidatePodStatsOptions validates the specified slice and options. Allows for sharing code in the front- and the back-end.
Types ¶
type AttachOptions ¶
type AttachOptions struct { DetachKeys string Latest bool NoStdin bool SigProxy bool Stdin *os.File Stdout *os.File Stderr *os.File }
AttachOptions describes the cli and other values needed to perform an attach
type AutoUpdateOptions ¶
type AutoUpdateOptions struct { // Authfile to use when contacting registries. Authfile string }
AutoUpdateOptions are the options for running auto-update.
type AutoUpdateReport ¶
type AutoUpdateReport struct { // Units - the restarted systemd units during auto-update. Units []string }
AutoUpdateReport contains the results from running auto-update.
type BoolReport ¶
type BoolReport struct {
Value bool
}
type BuildOptions ¶
type BuildOptions struct {
imagebuildah.BuildOptions
}
BuildOptions describe the options for building container images.
type BuildReport ¶
type BuildReport struct { // ID of the image. ID string }
BuildReport is the image-build report.
type CheckpointOptions ¶
type CheckpointReport ¶
type CommitOptions ¶
type CommitReport ¶
type CommitReport struct {
Id string //nolint
}
type ComponentVersion ¶
type ContainerCleanupOptions ¶
type ContainerCleanupOptions struct { All bool Exec string Latest bool Remove bool RemoveImage bool }
ContainerCleanupOptions are the CLI values for the cleanup command
type ContainerCleanupReport ¶
ContainerCleanupReport describes the response from a container cleanup
type ContainerCpOptions ¶
ContainerCpOptions describes input options for cp
type ContainerCpReport ¶
type ContainerCpReport struct { }
ContainerCpReport describes the output from a cp operation
type ContainerCreateReport ¶
type ContainerCreateReport struct {
Id string //nolint
}
type ContainerCreateResponse ¶
type ContainerCreateResponse struct { // ID of the container created ID string `json:"Id"` // Warnings during container creation Warnings []string `json:"Warnings"` }
ContainerCreateResponse is the response struct for creating a container
type ContainerEngine ¶
type ContainerEngine interface { AutoUpdate(ctx context.Context, options AutoUpdateOptions) (*AutoUpdateReport, []error) Config(ctx context.Context) (*config.Config, error) ContainerAttach(ctx context.Context, nameOrID string, options AttachOptions) error ContainerCheckpoint(ctx context.Context, namesOrIds []string, options CheckpointOptions) ([]*CheckpointReport, error) ContainerCleanup(ctx context.Context, namesOrIds []string, options ContainerCleanupOptions) ([]*ContainerCleanupReport, error) ContainerCommit(ctx context.Context, nameOrID string, options CommitOptions) (*CommitReport, error) ContainerCp(ctx context.Context, source, dest string, options ContainerCpOptions) (*ContainerCpReport, error) ContainerCreate(ctx context.Context, s *specgen.SpecGenerator) (*ContainerCreateReport, error) ContainerDiff(ctx context.Context, nameOrID string, options DiffOptions) (*DiffReport, error) ContainerExec(ctx context.Context, nameOrID string, options ExecOptions, streams define.AttachStreams) (int, error) ContainerExecDetached(ctx context.Context, nameOrID string, options ExecOptions) (string, error) ContainerExists(ctx context.Context, nameOrID string) (*BoolReport, error) ContainerExport(ctx context.Context, nameOrID string, options ContainerExportOptions) error ContainerInit(ctx context.Context, namesOrIds []string, options ContainerInitOptions) ([]*ContainerInitReport, error) ContainerInspect(ctx context.Context, namesOrIds []string, options InspectOptions) ([]*ContainerInspectReport, []error, error) ContainerKill(ctx context.Context, namesOrIds []string, options KillOptions) ([]*KillReport, error) ContainerList(ctx context.Context, options ContainerListOptions) ([]ListContainer, error) ContainerLogs(ctx context.Context, containers []string, options ContainerLogsOptions) error ContainerMount(ctx context.Context, nameOrIDs []string, options ContainerMountOptions) ([]*ContainerMountReport, error) ContainerPause(ctx context.Context, namesOrIds []string, options PauseUnPauseOptions) ([]*PauseUnpauseReport, error) ContainerPort(ctx context.Context, nameOrID string, options ContainerPortOptions) ([]*ContainerPortReport, error) ContainerPrune(ctx context.Context, options ContainerPruneOptions) (*ContainerPruneReport, error) ContainerRestart(ctx context.Context, namesOrIds []string, options RestartOptions) ([]*RestartReport, error) ContainerRestore(ctx context.Context, namesOrIds []string, options RestoreOptions) ([]*RestoreReport, error) ContainerRm(ctx context.Context, namesOrIds []string, options RmOptions) ([]*RmReport, error) ContainerRun(ctx context.Context, opts ContainerRunOptions) (*ContainerRunReport, error) ContainerRunlabel(ctx context.Context, label string, image string, args []string, opts ContainerRunlabelOptions) error ContainerStart(ctx context.Context, namesOrIds []string, options ContainerStartOptions) ([]*ContainerStartReport, error) ContainerStats(ctx context.Context, namesOrIds []string, options ContainerStatsOptions) error ContainerStop(ctx context.Context, namesOrIds []string, options StopOptions) ([]*StopReport, error) ContainerTop(ctx context.Context, options TopOptions) (*StringSliceReport, error) ContainerUnmount(ctx context.Context, nameOrIDs []string, options ContainerUnmountOptions) ([]*ContainerUnmountReport, error) ContainerUnpause(ctx context.Context, namesOrIds []string, options PauseUnPauseOptions) ([]*PauseUnpauseReport, error) ContainerWait(ctx context.Context, namesOrIds []string, options WaitOptions) ([]WaitReport, error) Events(ctx context.Context, opts EventsOptions) error GenerateSystemd(ctx context.Context, nameOrID string, opts GenerateSystemdOptions) (*GenerateSystemdReport, error) GenerateKube(ctx context.Context, nameOrID string, opts GenerateKubeOptions) (*GenerateKubeReport, error) SystemPrune(ctx context.Context, options SystemPruneOptions) (*SystemPruneReport, error) HealthCheckRun(ctx context.Context, nameOrID string, options HealthCheckOptions) (*define.HealthCheckResults, error) Info(ctx context.Context) (*define.Info, error) NetworkCreate(ctx context.Context, name string, options NetworkCreateOptions) (*NetworkCreateReport, error) NetworkInspect(ctx context.Context, namesOrIds []string, options NetworkInspectOptions) ([]NetworkInspectReport, error) NetworkList(ctx context.Context, options NetworkListOptions) ([]*NetworkListReport, error) NetworkRm(ctx context.Context, namesOrIds []string, options NetworkRmOptions) ([]*NetworkRmReport, error) PlayKube(ctx context.Context, path string, opts PlayKubeOptions) (*PlayKubeReport, error) PodCreate(ctx context.Context, opts PodCreateOptions) (*PodCreateReport, error) PodExists(ctx context.Context, nameOrID string) (*BoolReport, error) PodInspect(ctx context.Context, options PodInspectOptions) (*PodInspectReport, error) PodKill(ctx context.Context, namesOrIds []string, options PodKillOptions) ([]*PodKillReport, error) PodPause(ctx context.Context, namesOrIds []string, options PodPauseOptions) ([]*PodPauseReport, error) PodPrune(ctx context.Context, options PodPruneOptions) ([]*PodPruneReport, error) PodPs(ctx context.Context, options PodPSOptions) ([]*ListPodsReport, error) PodRestart(ctx context.Context, namesOrIds []string, options PodRestartOptions) ([]*PodRestartReport, error) PodRm(ctx context.Context, namesOrIds []string, options PodRmOptions) ([]*PodRmReport, error) PodStart(ctx context.Context, namesOrIds []string, options PodStartOptions) ([]*PodStartReport, error) PodStats(ctx context.Context, namesOrIds []string, options PodStatsOptions) ([]*PodStatsReport, error) PodStop(ctx context.Context, namesOrIds []string, options PodStopOptions) ([]*PodStopReport, error) PodTop(ctx context.Context, options PodTopOptions) (*StringSliceReport, error) PodUnpause(ctx context.Context, namesOrIds []string, options PodunpauseOptions) ([]*PodUnpauseReport, error) SetupRootless(ctx context.Context, cmd *cobra.Command) error Shutdown(ctx context.Context) SystemDf(ctx context.Context, options SystemDfOptions) (*SystemDfReport, error) VarlinkService(ctx context.Context, opts ServiceOptions) error Version(ctx context.Context) (*SystemVersionReport, error) VolumeCreate(ctx context.Context, opts VolumeCreateOptions) (*IDOrNameResponse, error) VolumeInspect(ctx context.Context, namesOrIds []string, opts VolumeInspectOptions) ([]*VolumeInspectReport, error) VolumeList(ctx context.Context, opts VolumeListOptions) ([]*VolumeListReport, error) VolumePrune(ctx context.Context, opts VolumePruneOptions) ([]*VolumePruneReport, error) VolumeRm(ctx context.Context, namesOrIds []string, opts VolumeRmOptions) ([]*VolumeRmReport, error) }
type ContainerExportOptions ¶
type ContainerExportOptions struct {
Output string
}
type ContainerFilter ¶
func CompileContainerFilters ¶
func CompileContainerFilters(filters url.Values) ContainerFilter
type ContainerInitOptions ¶
ContainerInitOptions describes input options for the container init cli
type ContainerInitReport ¶
ContainerInitReport describes the results of a container init
type ContainerInspectReport ¶
type ContainerInspectReport struct {
*define.InspectContainerData
}
type ContainerListOptions ¶
type ContainerListOptions struct { All bool Filters map[string][]string Format string Last int Latest bool Namespace bool Pod bool Quiet bool Size bool Sort string Sync bool Watch uint }
ContainerListOptions describes the CLI options for listing containers
type ContainerLogsOptions ¶
type ContainerLogsOptions struct { // Show extra details provided to the logs. Details bool // Follow the log output. Follow bool // Display logs for the latest container only. Ignored on the remote client. Latest bool // Show container names in the output. Names bool // Show logs since this timestamp. Since time.Time // Number of lines to display at the end of the output. Tail int64 // Show timestamps in the logs. Timestamps bool // Write the logs to Writer. Writer io.Writer }
ContainerLogsOptions describes the options to extract container logs.
type ContainerMountOptions ¶
ContainerMountOptions describes the input values for mounting containers in the CLI
type ContainerMountReport ¶
ContainerMountReport describes the response from container mount
type ContainerPortOptions ¶
ContainerPortOptions describes the options to obtain port information on containers
type ContainerPortReport ¶
type ContainerPortReport struct { Id string //nolint Ports []ocicni.PortMapping }
ContainerPortReport describes the output needed for the CLI to output ports
type ContainerPruneOptions ¶
ContainerPruneOptions describes the options needed to prune a container from the CLI
type ContainerPruneReport ¶
ContainerPruneReport describes the results after pruning the stopped containers.
type ContainerRunOptions ¶
type ContainerRunOptions struct { Detach bool DetachKeys string ErrorStream *os.File InputStream *os.File OutputStream *os.File Rm bool SigProxy bool Spec *specgen.SpecGenerator }
ContainerRunOptions describes the options needed to run a container from the CLI
type ContainerRunReport ¶
ContainerRunReport describes the results of running a container
type ContainerRunlabelOptions ¶
type ContainerRunlabelOptions struct { // Authfile - path to an authentication file. Authfile string // CertDir - path to a directory containing TLS certifications and // keys. CertDir string // Credentials - `user:password` to use when pulling an image. Credentials string // Display - do not execute but print the command. Display bool // Replace - replace an existing container with a new one from the // image. Replace bool // Name - use this name when executing the runlabel container. Name string // Optional1 - fist optional parameter for install. Optional1 string // Optional2 - second optional parameter for install. Optional2 string // Optional3 - third optional parameter for install. Optional3 string // Pull - pull the specified image if it's not in the local storage. Pull bool // Quiet - suppress output when pulling images. Quiet bool // SignaturePolicy - path to a signature-policy file. SignaturePolicy string // SkipTLSVerify - skip HTTPS and certificate verifications when // contacting registries. SkipTLSVerify types.OptionalBool }
ContainerRunlabelOptions are the options to execute container-runlabel.
type ContainerRunlabelReport ¶
type ContainerRunlabelReport struct { }
ContainerRunlabelReport contains the results from executing container-runlabel.
type ContainerStartOptions ¶
type ContainerStartOptions struct { Attach bool DetachKeys string Interactive bool Latest bool SigProxy bool Stdout *os.File Stderr *os.File Stdin *os.File }
ContainerStartOptions describes the val from the CLI needed to start a container
type ContainerStartReport ¶
ContainerStartReport describes the response from starting containers from the cli
type ContainerStatsOptions ¶
type ContainerStatsOptions struct { All bool Format string Latest bool NoReset bool NoStream bool StatChan chan []*define.ContainerStats }
ContainerStatsOptions describes input options for getting stats on containers
type ContainerUnmountOptions ¶
ContainerUnmountOptions are the options from the cli for unmounting
type ContainerUnmountReport ¶
ContainerUnmountReport describes the response from umounting a container
type DiffOptions ¶
type DiffOptions struct { Format string `json:",omitempty"` // CLI only Latest bool `json:",omitempty"` // API and CLI, only supported by containers Archive bool `json:",omitempty"` // CLI only }
All API and CLI diff commands and diff sub-commands use the same options
type DiffReport ¶
DiffReport provides changes for object
type EngineMode ¶
type EngineMode string
EngineMode is the connection type podman is using to access libpod
type EngineSetup ¶
type EngineSetup string
EngineSetup calls out whether a "normal" or specialized engine should be created
type ErrorModel ¶
type ErrorModel struct { // API root cause formatted for automated parsing // example: API root cause Because string `json:"cause"` // human error message, formatted for a human to read // example: human error message Message string `json:"message"` // http response code ResponseCode int `json:"response"` }
func (ErrorModel) Cause ¶
func (e ErrorModel) Cause() error
func (ErrorModel) Code ¶
func (e ErrorModel) Code() int
func (ErrorModel) Error ¶
func (e ErrorModel) Error() string
type Event ¶
type Event struct { // TODO: it would be nice to have full control over the types at some // point and fork such Docker types. dockerEvents.Message }
Event combines various event-related data such as time, event type, status and more.
func ConvertToEntitiesEvent ¶
func ConvertToEntitiesEvent(e libpodEvents.Event) *Event
ConvertToEntitiesEvent converts a libpod event to an entities one.
type EventsOptions ¶
type ExecOptions ¶
type ExecOptions struct { Cmd []string DetachKeys string Envs map[string]string Interactive bool Latest bool PreserveFDs uint Privileged bool Tty bool User string WorkDir string }
ExecOptions describes the cli values to exec into a container
type GenerateKubeOptions ¶
type GenerateKubeOptions struct { // Service - generate YAML for a Kubernetes _service_ object. Service bool }
GenerateKubeOptions control the generation of Kubernetes YAML files.
type GenerateKubeReport ¶
type GenerateKubeReport struct { // Reader - the io.Reader to reader the generated YAML file. Reader io.Reader }
GenerateKubeReport
type GenerateSystemdOptions ¶
type GenerateSystemdOptions struct { // Files - generate files instead of printing to stdout. Files bool // Name - use container/pod name instead of its ID. Name bool // New - create a new container instead of starting a new one. New bool // RestartPolicy - systemd restart policy. RestartPolicy string // StopTimeout - time when stopping the container. StopTimeout *uint // ContainerPrefix - systemd unit name prefix for containers ContainerPrefix string // PodPrefix - systemd unit name prefix for pods PodPrefix string // Separator - systemd unit name separator between name/id and prefix Separator string }
GenerateSystemdOptions control the generation of systemd unit files.
type GenerateSystemdReport ¶
type GenerateSystemdReport struct { // Output of the generate process. Either the generated files or their // entire content. Output string }
GenerateSystemdReport
type HealthCheckOptions ¶
type HealthCheckOptions struct{}
type IDOrNameResponse ¶
type IDOrNameResponse struct { // The Id or Name of an object IDOrName string }
type IDOrNamed ¶
type IDOrNamed interface { Identifier Named }
IDOrName interface allows filters to access ID() or Name() of object
type IDOrNames ¶
type IDOrNames interface { Identifier Names }
IDOrName interface allows filters to access ID() or Names() of object
type Identifier ¶
type Identifier interface {
Id() string
}
Identifier interface allows filters to access ID() of object
type Image ¶
type Image struct { ID string `json:"Id"` RepoTags []string `json:",omitempty"` RepoDigests []string `json:",omitempty"` Parent string `json:",omitempty"` Comment string `json:",omitempty"` Created string `json:",omitempty"` Container string `json:",omitempty"` ContainerConfig *container.Config `json:",omitempty"` DockerVersion string `json:",omitempty"` Author string `json:",omitempty"` Config *container.Config `json:",omitempty"` Architecture string `json:",omitempty"` Variant string `json:",omitempty"` Os string `json:",omitempty"` OsVersion string `json:",omitempty"` Size int64 `json:",omitempty"` VirtualSize int64 `json:",omitempty"` GraphDriver docker.GraphDriverData `json:",omitempty"` RootFS docker.RootFS `json:",omitempty"` Metadata docker.ImageMetadata `json:",omitempty"` // Podman extensions Digest digest.Digest `json:",omitempty"` PodmanVersion string `json:",omitempty"` ManifestType string `json:",omitempty"` User string `json:",omitempty"` History []v1.History `json:",omitempty"` NamesHistory []string `json:",omitempty"` HealthCheck *manifest.Schema2HealthConfig `json:",omitempty"` }
type ImageEngine ¶
type ImageEngine interface { Build(ctx context.Context, containerFiles []string, opts BuildOptions) (*BuildReport, error) Config(ctx context.Context) (*config.Config, error) Diff(ctx context.Context, nameOrID string, options DiffOptions) (*DiffReport, error) Exists(ctx context.Context, nameOrID string) (*BoolReport, error) History(ctx context.Context, nameOrID string, opts ImageHistoryOptions) (*ImageHistoryReport, error) Import(ctx context.Context, opts ImageImportOptions) (*ImageImportReport, error) Inspect(ctx context.Context, namesOrIDs []string, opts InspectOptions) ([]*ImageInspectReport, []error, error) List(ctx context.Context, opts ImageListOptions) ([]*ImageSummary, error) Load(ctx context.Context, opts ImageLoadOptions) (*ImageLoadReport, error) Prune(ctx context.Context, opts ImagePruneOptions) (*ImagePruneReport, error) Pull(ctx context.Context, rawImage string, opts ImagePullOptions) (*ImagePullReport, error) Push(ctx context.Context, source string, destination string, opts ImagePushOptions) error Remove(ctx context.Context, images []string, opts ImageRemoveOptions) (*ImageRemoveReport, []error) Save(ctx context.Context, nameOrID string, tags []string, options ImageSaveOptions) error Search(ctx context.Context, term string, opts ImageSearchOptions) ([]ImageSearchReport, error) SetTrust(ctx context.Context, args []string, options SetTrustOptions) error ShowTrust(ctx context.Context, args []string, options ShowTrustOptions) (*ShowTrustReport, error) Shutdown(ctx context.Context) Tag(ctx context.Context, nameOrID string, tags []string, options ImageTagOptions) error Tree(ctx context.Context, nameOrID string, options ImageTreeOptions) (*ImageTreeReport, error) Untag(ctx context.Context, nameOrID string, tags []string, options ImageUntagOptions) error ManifestCreate(ctx context.Context, names, images []string, opts ManifestCreateOptions) (string, error) ManifestInspect(ctx context.Context, name string) ([]byte, error) ManifestAdd(ctx context.Context, opts ManifestAddOptions) (string, error) ManifestAnnotate(ctx context.Context, names []string, opts ManifestAnnotateOptions) (string, error) ManifestRemove(ctx context.Context, names []string) (string, error) ManifestPush(ctx context.Context, names []string, manifestPushOpts ManifestPushOptions) error Sign(ctx context.Context, names []string, options SignOptions) (*SignReport, error) }
type ImageFilter ¶
func CompileImageFilters ¶
func CompileImageFilters(filters url.Values) ImageFilter
type ImageHistoryLayer ¶
type ImageHistoryOptions ¶
type ImageHistoryOptions struct{}
type ImageHistoryReport ¶
type ImageHistoryReport struct {
Layers []ImageHistoryLayer
}
type ImageImportOptions ¶
type ImageImportReport ¶
type ImageImportReport struct {
Id string //nolint
}
type ImageInspectReport ¶
ImageInspectReport is the data when inspecting an image.
type ImageListOptions ¶
type ImageListOptions struct { All bool `json:"all" schema:"all"` Filter []string `json:"Filter,omitempty"` }
Image List Options
type ImageLoadOptions ¶
type ImageLoadReport ¶
type ImageLoadReport struct {
Names []string
}
type ImagePruneOptions ¶
type ImagePruneReport ¶
type ImagePullOptions ¶
type ImagePullOptions struct { // AllTags can be specified to pull all tags of the spiecifed image. Note // that this only works if the specified image does not include a tag. AllTags bool // Authfile is the path to the authentication file. Ignored for remote // calls. Authfile string // CertDir is the path to certificate directories. Ignored for remote // calls. CertDir string // Username for authenticating against the registry. Username string // Password for authenticating against the registry. Password string // OverrideArch will overwrite the local architecture for image pulls. OverrideArch string // OverrideOS will overwrite the local operating system (OS) for image // pulls. OverrideOS string // Quiet can be specified to suppress pull progress when pulling. Ignored // for remote calls. Quiet bool // SignaturePolicy to use when pulling. Ignored for remote calls. SignaturePolicy string // SkipTLSVerify to skip HTTPS and certificate verification. SkipTLSVerify types.OptionalBool }
ImagePullOptions are the arguments for pulling images.
type ImagePullReport ¶
type ImagePullReport struct {
Images []string
}
ImagePullReport is the response from pulling one or more images.
type ImagePushOptions ¶
type ImagePushOptions struct { // Authfile is the path to the authentication file. Ignored for remote // calls. Authfile string // CertDir is the path to certificate directories. Ignored for remote // calls. CertDir string // Compress tarball image layers when pushing to a directory using the 'dir' // transport. Default is same compression type as source. Ignored for remote // calls. Compress bool // Username for authenticating against the registry. Username string // Password for authenticating against the registry. Password string // DigestFile, after copying the image, write the digest of the resulting // image to the file. Ignored for remote calls. DigestFile string // Format is the Manifest type (oci, v2s1, or v2s2) to use when pushing an // image using the 'dir' transport. Default is manifest type of source. // Ignored for remote calls. Format string // Quiet can be specified to suppress pull progress when pulling. Ignored // for remote calls. Quiet bool // RemoveSignatures, discard any pre-existing signatures in the image. // Ignored for remote calls. RemoveSignatures bool // SignaturePolicy to use when pulling. Ignored for remote calls. SignaturePolicy string // SignBy adds a signature at the destination using the specified key. // Ignored for remote calls. SignBy string // SkipTLSVerify to skip HTTPS and certificate verification. SkipTLSVerify types.OptionalBool }
ImagePushOptions are the arguments for pushing images.
type ImageRemoveOptions ¶
type ImageRemoveOptions struct { // All will remove all images. All bool // Foce will force image removal including containers using the images. Force bool }
ImageRemoveOptions can be used to alter image removal.
type ImageRemoveReport ¶
type ImageRemoveReport struct { // Deleted images. Deleted []string `json:",omitempty"` // Untagged images. Can be longer than Deleted. Untagged []string `json:",omitempty"` // ExitCode describes the exit codes as described in the `podman rmi` // man page. ExitCode int }
ImageRemoveResponse is the response for removing one or more image(s) from storage and containers what was untagged vs actually removed.
type ImageSaveOptions ¶
type ImageSearchOptions ¶
type ImageSearchOptions struct { // Authfile is the path to the authentication file. Ignored for remote // calls. Authfile string // Filters for the search results. Filters []string // Limit the number of results. Limit int // NoTrunc will not truncate the output. NoTrunc bool // SkipTLSVerify to skip HTTPS and certificate verification. SkipTLSVerify types.OptionalBool }
ImageSearchOptions are the arguments for searching images.
type ImageSearchReport ¶
type ImageSearchReport struct { // Index is the image index (e.g., "docker.io" or "quay.io") Index string // Name is the canoncical name of the image (e.g., "docker.io/library/alpine"). Name string // Description of the image. Description string // Stars is the number of stars of the image. Stars int // Official indicates if it's an official image. Official string // Automated indicates if the image was created by an automated build. Automated string }
ImageSearchReport is the response from searching images.
type ImageSummary ¶
type ImageSummary struct { ID string `json:"Id"` ParentId string `json:",omitempty"` // nolint RepoTags []string `json:",omitempty"` Created time.Time `json:",omitempty"` Size int64 `json:",omitempty"` VirtualSize int64 `json:",omitempty"` Labels map[string]string `json:",omitempty"` Containers int `json:",omitempty"` ReadOnly bool `json:",omitempty"` Dangling bool `json:",omitempty"` // Podman extensions Names []string `json:",omitempty"` Digest string `json:",omitempty"` Digests []string `json:",omitempty"` ConfigDigest string `json:",omitempty"` History []string `json:",omitempty"` }
func (*ImageSummary) Id ¶
func (i *ImageSummary) Id() string
func (*ImageSummary) IsDangling ¶
func (i *ImageSummary) IsDangling() bool
func (*ImageSummary) IsReadOnly ¶
func (i *ImageSummary) IsReadOnly() bool
type ImageTagOptions ¶
type ImageTagOptions struct{}
type ImageTreeOptions ¶
type ImageTreeOptions struct {
WhatRequires bool // Show all child images and layers of the specified image
}
ImageTreeOptions provides options for ImageEngine.Tree()
type ImageTreeReport ¶
type ImageTreeReport struct {
Tree string // TODO: Refactor move presentation work out of server
}
ImageTreeReport provides results from ImageEngine.Tree()
type ImageUntagOptions ¶
type ImageUntagOptions struct{}
type InspectOptions ¶
type InspectOptions struct { // Format - change the output to JSON or a Go template. Format string `json:",omitempty"` // Latest - inspect the latest container Podman is aware of. Latest bool `json:",omitempty"` // Size (containers only) - display total file size. Size bool `json:",omitempty"` // Type -- return JSON for specified type. Type string `json:",omitempty"` }
All CLI inspect commands and inspect sub-commands use the same options
type KillOptions ¶
type KillReport ¶
type ListContainer ¶
type ListContainer struct { // Container command Command []string // Container creation time Created int64 // Human readable container creation time. CreatedAt string // If container has exited/stopped Exited bool // Time container exited ExitedAt int64 // If container has exited, the return code from the command ExitCode int32 // The unique identifier for the container ID string `json:"Id"` // Container image Image string // Container image ID ImageID string // If this container is a Pod infra container IsInfra bool // Labels for container Labels map[string]string // User volume mounts Mounts []string // The names assigned to the container Names []string // Namespaces the container belongs to. Requires the // namespace boolean to be true Namespaces ListContainerNamespaces // The process id of the container Pid int // If the container is part of Pod, the Pod ID. Requires the pod // boolean to be set Pod string // If the container is part of Pod, the Pod name. Requires the pod // boolean to be set PodName string // Port mappings Ports []ocicni.PortMapping // Size of the container rootfs. Requires the size boolean to be true Size *define.ContainerSize // Time when container started StartedAt int64 // State of container State string }
Listcontainer describes a container suitable for listing
func (ListContainer) CGROUPNS ¶
func (l ListContainer) CGROUPNS() string
func (ListContainer) IPC ¶
func (l ListContainer) IPC() string
func (ListContainer) MNT ¶
func (l ListContainer) MNT() string
func (ListContainer) NET ¶
func (l ListContainer) NET() string
func (ListContainer) PIDNS ¶
func (l ListContainer) PIDNS() string
func (ListContainer) USERNS ¶
func (l ListContainer) USERNS() string
func (ListContainer) UTS ¶
func (l ListContainer) UTS() string
type ListContainerNamespaces ¶
type ListContainerNamespaces struct { // Mount namespace MNT string `json:"Mnt,omitempty"` // Cgroup namespace Cgroup string `json:"Cgroup,omitempty"` // IPC namespace IPC string `json:"Ipc,omitempty"` // Network namespace NET string `json:"Net,omitempty"` // PID namespace PIDNS string `json:"Pidns,omitempty"` // UTS namespace UTS string `json:"Uts,omitempty"` // User namespace User string `json:"User,omitempty"` }
ListContainer Namespaces contains the identifiers of the container's Linux namespaces
type ListPodContainer ¶
type ListPodsReport ¶
type ListRegistriesReport ¶
type ListRegistriesReport struct {
Registries []string
}
ListRegistriesReport is the report when querying for a sorted list of registries which may be contacted during certain operations.
type ManifestAddOptions ¶
type ManifestAddOptions struct { All bool `json:"all" schema:"all"` Annotation []string `json:"annotation" schema:"annotation"` Arch string `json:"arch" schema:"arch"` Features []string `json:"features" schema:"features"` Images []string `json:"images" schema:"images"` OS string `json:"os" schema:"os"` OSVersion string `json:"os_version" schema:"os_version"` Variant string `json:"variant" schema:"variant"` }
type ManifestAnnotateOptions ¶
type ManifestAnnotateOptions struct { Annotation []string `json:"annotation"` Arch string `json:"arch" schema:"arch"` Features []string `json:"features" schema:"features"` OS string `json:"os" schema:"os"` OSFeatures []string `json:"os_features" schema:"os_features"` OSVersion string `json:"os_version" schema:"os_version"` Variant string `json:"variant" schema:"variant"` }
type ManifestCreateOptions ¶
type ManifestCreateOptions struct {
All bool `schema:"all"`
}
type ManifestPushOptions ¶
type ManifestPushOptions struct {
Purge, Quiet, All, RemoveSignatures bool
Authfile, CertDir, Username, Password, DigestFile, Format, SignBy string
SkipTLSVerify types.OptionalBool
}
type Named ¶
type Named interface {
Name() string
}
Named interface allows filters to access Name() of object
type Names ¶
type Names interface {
Names() []string
}
Named interface allows filters to access Name() of object
type NetOptions ¶
type NetOptions struct { AddHosts []string CNINetworks []string UseImageResolvConf bool DNSOptions []string DNSSearch []string DNSServers []net.IP Network specgen.Namespace NoHosts bool PublishPorts []specgen.PortMapping StaticIP *net.IP StaticMAC *net.HardwareAddr }
NetOptions reflect the shared network options between pods and containers
type NetworkCreateOptions ¶
type NetworkCreateOptions struct { DisableDNS bool Driver string Gateway net.IP Internal bool MacVLAN string Range net.IPNet Subnet net.IPNet }
NetworkCreateOptions describes options to create a network swagger:model NetworkCreateOptions
type NetworkCreateReport ¶
type NetworkCreateReport struct {
Filename string
}
NetworkCreateReport describes a created network for the cli
type NetworkInspectOptions ¶
type NetworkInspectOptions struct {
Format string
}
NetworkInspectOptions describes options for inspect networks
type NetworkInspectReport ¶
type NetworkInspectReport map[string]interface{}
NetworkInspectReport describes the results from inspect networks
type NetworkListOptions ¶
NetworkListOptions describes options for listing networks in cli
type NetworkListReport ¶
type NetworkListReport struct {
*libcni.NetworkConfigList
}
NetworkListReport describes the results from listing networks
type NetworkRmOptions ¶
type NetworkRmOptions struct {
Force bool
}
NetworkRmOptions describes options for removing networks
type NetworkRmReport ¶
NetworkRmReport describes the results of network removal
type PauseUnPauseOptions ¶
type PauseUnPauseOptions struct {
All bool
}
type PauseUnpauseReport ¶
type PlayKubeOptions ¶
type PlayKubeOptions struct { // Authfile - path to an authentication file. Authfile string // CertDir - to a directory containing TLS certifications and keys. CertDir string // Username for authenticating against the registry. Username string // Password for authenticating against the registry. Password string // Network - name of the CNI network to connect to. Network string // Quiet - suppress output when pulling images. Quiet bool // SignaturePolicy - path to a signature-policy file. SignaturePolicy string // SkipTLSVerify - skip https and certificate validation when // contacting container registries. SkipTLSVerify types.OptionalBool // SeccompProfileRoot - path to a directory containing seccomp // profiles. SeccompProfileRoot string }
PlayKubeOptions controls playing kube YAML files.
type PlayKubePod ¶
type PlayKubePod struct { // ID - ID of the pod created as a result of play kube. ID string // Containers - the IDs of the containers running in the created pod. Containers []string // Logs - non-fatal erros and log messages while processing. Logs []string }
PlayKubePod represents a single pod and associated containers created by play kube
type PlayKubeReport ¶
type PlayKubeReport struct { // Pods - pods created by play kube. Pods []PlayKubePod }
PlayKubeReport contains the results of running play kube.
type PodCreateOptions ¶
type PodCreateOptions struct { CGroupParent string CreateCommand []string Hostname string Infra bool InfraImage string InfraCommand string InfraConmonPidFile string Labels map[string]string Name string Net *NetOptions }
func (PodCreateOptions) ToPodSpecGen ¶
func (p PodCreateOptions) ToPodSpecGen(s *specgen.PodSpecGenerator)
type PodCreateReport ¶
type PodCreateReport struct {
Id string //nolint
}
type PodDeleteReport ¶
type PodDeleteReport struct{ Report }
type PodInspectOptions ¶
type PodInspectReport ¶
type PodInspectReport struct {
*define.InspectPodData
}
type PodKillOptions ¶
type PodKillReport ¶
type PodPSOptions ¶
type PodPauseOptions ¶
type PodPauseReport ¶
type PodPruneOptions ¶
type PodPruneOptions struct {
Force bool `json:"force" schema:"force"`
}
type PodPruneReport ¶
type PodRestartOptions ¶
type PodRestartReport ¶
type PodRmReport ¶
type PodStartOptions ¶
type PodStartReport ¶
type PodStatsOptions ¶
type PodStatsOptions struct { // All - provide stats for all running pods. All bool // Latest - provide stats for the latest pod. Latest bool }
PodStatsOptions are options for the pod stats command.
type PodStatsReport ¶
type PodStatsReport struct { CPU string MemUsage string Mem string NetIO string BlockIO string PIDS string Pod string CID string Name string }
PodStatsReport includes pod-resource statistics data.
type PodStopReport ¶
type PodTopOptions ¶
type PodUnpauseReport ¶
type PodmanConfig ¶
type PodmanConfig struct { *config.Config *pflag.FlagSet CGroupUsage string // rootless code determines Usage message ConmonPath string // --conmon flag will set Engine.ConmonPath CPUProfile string // Hidden: Should CPU profile be taken EngineMode EngineMode // ABI or Tunneling mode Identity string // ssh identity for connecting to server MaxWorks int // maximum number of parallel threads RegistriesConf string // allows for specifying a custom registries.conf Remote bool // Connection to Podman API Service will use RESTful API RuntimePath string // --runtime flag will set Engine.RuntimePath Span opentracing.Span // tracing object SpanCloser io.Closer // Close() for tracing object SpanCtx context.Context // context to use when tracing Syslog bool // write to StdOut and Syslog, not supported when tunneling Trace bool // Hidden: Trace execution URI string // URI to RESTful API Service Runroot string StorageDriver string StorageOpts []string }
PodmanConfig combines the defaults and settings from the file system with the flags given in os.Args. Some runtime state is also stored here.
type PodunpauseOptions ¶
type PsSortedCreateTime ¶
type PsSortedCreateTime struct{ SortListContainers }
func (PsSortedCreateTime) Less ¶
func (a PsSortedCreateTime) Less(i, j int) bool
type RestartOptions ¶
type RestartReport ¶
type RestoreOptions ¶
type RestoreReport ¶
type ServiceOptions ¶
type ServiceOptions struct { URI string // Path to unix domain socket service should listen on Timeout time.Duration // duration of inactivity the service should wait before shutting down Command *cobra.Command // CLI command provided. Used in V1 code }
ServiceOptions provides the input for starting an API Service
type SetTrustOptions ¶
SetTrustOptions describes the CLI options for setting trust
type ShowTrustOptions ¶
ShowTrustOptions are the cli options for showing trust
type ShowTrustReport ¶
type ShowTrustReport struct { Raw []byte SystemRegistriesDirPath string JSONOutput []byte Policies []*trust.Policy }
ShowTrustReport describes the results of show trust
type SignOptions ¶
SignOptions describes input options for the CLI signing
type SortListContainers ¶
type SortListContainers []ListContainer
func SortPsOutput ¶
func SortPsOutput(sortBy string, psOutput SortListContainers) (SortListContainers, error)
func (SortListContainers) Len ¶
func (a SortListContainers) Len() int
func (SortListContainers) Swap ¶
func (a SortListContainers) Swap(i, j int)
type StopOptions ¶
type StopReport ¶
type StringSet ¶
type StringSet struct {
// contains filtered or unexported fields
}
func NewStringSet ¶
type StringSliceReport ¶
type StringSliceReport struct {
Value []string
}
StringSliceReport wraps a string slice.
type SystemDfContainerReport ¶
type SystemDfContainerReport struct { ContainerID string Image string Command []string LocalVolumes int Size int64 RWSize int64 Created time.Time Status string Names string }
SystemDfContainerReport describes a container for use with df
type SystemDfImageReport ¶
type SystemDfImageReport struct { Repository string Tag string ImageID string Created time.Time Size int64 UniqueSize int64 Containers int }
SystemDfImageReport describes an image for use with df
type SystemDfOptions ¶
SystemDfOptions describes the options for getting df information
type SystemDfReport ¶
type SystemDfReport struct { Images []*SystemDfImageReport Containers []*SystemDfContainerReport Volumes []*SystemDfVolumeReport }
SystemDfReport describes the response for df information
type SystemDfVolumeReport ¶
SystemDfVolumeReport describes a volume and its size
type SystemEngine ¶
type SystemMigrateOptions ¶
type SystemMigrateOptions struct {
NewRuntime string
}
SystemMigrateOptions describes the options needed for the cli to migrate runtimes of containers
type SystemPruneOptions ¶
SystemPruneOptions provides options to prune system.
type SystemPruneReport ¶
type SystemPruneReport struct { PodPruneReport []*PodPruneReport *ContainerPruneReport *ImagePruneReport VolumePruneReport []*VolumePruneReport }
SystemPruneReport provides report after system prune is executed.
type SystemResetOptions ¶
type SystemResetOptions struct {
Force bool
}
SystemResetOptions describes the options for resetting your container runtime storage, etc
type SystemVersionReport ¶
type SystemVersionReport struct { // Always populated Client *define.Version `json:",omitempty"` // May be populated, when in tunnel mode Server *define.Version `json:",omitempty"` }
SystemVersionReport describes version information about the running Podman service
type TopOptions ¶
type Volume ¶
type Volume struct {
Identifier
}
type VolumeConfigResponse ¶
type VolumeConfigResponse struct { // Name is the name of the volume. Name string `json:"Name"` // Driver is the driver used to create the volume. // This will be properly implemented in a future version. Driver string `json:"Driver"` // Mountpoint is the path on the host where the volume is mounted. Mountpoint string `json:"Mountpoint"` // CreatedAt is the date and time the volume was created at. This is not // stored for older Libpod volumes; if so, it will be omitted. CreatedAt time.Time `json:"CreatedAt,omitempty"` // Status is presently unused and provided only for Docker compatibility. // In the future it will be used to return information on the volume's // current state. Status map[string]string `json:"Status,omitempty"` // Labels includes the volume's configured labels, key:value pairs that // can be passed during volume creation to provide information for third // party tools. Labels map[string]string `json:"Labels"` // Scope is unused and provided solely for Docker compatibility. It is // unconditionally set to "local". Scope string `json:"Scope"` // Options is a set of options that were used when creating the volume. // It is presently not used. Options map[string]string `json:"Options"` // UID is the UID that the volume was created with. UID int `json:"UID"` // GID is the GID that the volume was created with. GID int `json:"GID"` // Anonymous indicates that the volume was created as an anonymous // volume for a specific container, and will be be removed when any // container using it is removed. Anonymous bool `json:"Anonymous"` }
type VolumeCreateOptions ¶
type VolumeCreateOptions struct { // New volume's name. Can be left blank Name string `schema:"name"` // Volume driver to use Driver string `schema:"driver"` // User-defined key/value metadata. Label map[string]string `schema:"label"` // Mapping of driver options and values. Options map[string]string `schema:"opts"` }
swagger:model VolumeCreate
type VolumeDeleteOptions ¶
type VolumeDeleteOptions struct{}
type VolumeDeleteReport ¶
type VolumeDeleteReport struct{ Report }
type VolumeFilter ¶
func CompileVolumeFilters ¶
func CompileVolumeFilters(filters url.Values) VolumeFilter
type VolumeInspectOptions ¶
type VolumeInspectOptions struct {
All bool
}
type VolumeInspectReport ¶
type VolumeInspectReport struct {
*VolumeConfigResponse
}
type VolumeListOptions ¶
type VolumeListReport ¶
type VolumeListReport struct {
VolumeConfigResponse
}
type VolumePruneOptions ¶
type VolumePruneOptions struct {
Force bool
}
type VolumePruneReport ¶
type VolumeRmOptions ¶
type VolumeRmReport ¶
type WaitOptions ¶
type WaitOptions struct { Condition define.ContainerStatus Interval time.Duration Latest bool }