filemap

package

v1.14.0 Latest Latest Go to latest Published: Sep 3, 2026 License: MPL-2.0 Imports: 13 Imported by: 3

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/siderolabs/talos

Links

Open Source Insights

Documentation ¶

Overview ¶

Package filemap provides a way to create reproducible layers from a file system.

Index ¶

func Build(filemap []File) io.ReadCloser
func Layer(tempDir string, filemap []File) (v1.Layer, error)
type File
- func Walk(sourceBasePath, imageBasePath string) ([]File, error)

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

func Build ¶ added in v1.9.0

func Build(filemap []File) io.ReadCloser

Build a tarball from a filemap.

func Layer ¶

func Layer(tempDir string, filemap []File) (v1.Layer, error)

Layer creates a layer from a single file map.

These layers are reproducible and consistent.

A filemap is a path -> file content map representing a file system.

The compressed layer is staged as a file under tempDir, which must outlive the returned layer: go-containerregistry re-opens the layer contents for every digest and write access. Removing tempDir reclaims the temporary file.

Types ¶

type File ¶

type File struct {
	ImagePath  string
	SourcePath string
	ImageMode  int64
}

File is a path -> file content map representing a file system.

func Walk ¶ added in v1.6.0

func Walk(sourceBasePath, imageBasePath string) ([]File, error)

Walk the filesystem generating a filemap.

Source Files ¶

View all Source files

filemap.go

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL