Documentation ¶
Overview ¶
Copyright © 2022 Macaroni OS Linux See AUTHORS and LICENSE for the license details and contributors.
Copyright © 2022 Macaroni OS Linux See AUTHORS and LICENSE for the license details and contributors.
Index ¶
- type ArtifactDiffs
- type ArtifactLayer
- type ArtifactNode
- type ArtifactsMap
- func (am *ArtifactsMap) Add(p *PackageArtifact)
- func (am *ArtifactsMap) GetArtifactsByKey(k string) ([]*PackageArtifact, error)
- func (am *ArtifactsMap) GetKeyFromValue(p *PackageArtifact) string
- func (am *ArtifactsMap) GetSortedArtifactsByKey(k string) ([]*PackageArtifact, error)
- func (am *ArtifactsMap) HasKey(k string) bool
- func (am *ArtifactsMap) MatchVersion(p *PackageArtifact) (*PackageArtifact, error)
- func (am *ArtifactsMap) ToList() *[]*PackageArtifact
- type ArtifactsPack
- type Checksums
- type CopyJob
- type HashImplementation
- type HashOptions
- type ImageBuilder
- type PackageArtifact
- func CreateArtifactForFile(s string, opts ...func(*PackageArtifact)) (*PackageArtifact, error)
- func ExtractArtifactFromDelta(src, dst string, layers []ArtifactLayer, concurrency int, keepPerms bool, ...) (*PackageArtifact, error)
- func NewPackageArtifact(path string) *PackageArtifact
- func NewPackageArtifactFromJson(data []byte) (*PackageArtifact, error)
- func NewPackageArtifactFromYaml(data []byte) (*PackageArtifact, error)
- func (a *PackageArtifact) Compress(src string, concurrency int) error
- func (a *PackageArtifact) FileList() ([]string, error)
- func (a *PackageArtifact) GenerateFinalImage(imageName string, b ImageBuilder, keepPerms bool) (backend.Options, error)
- func (a *PackageArtifact) GetFileName() string
- func (a *PackageArtifact) GetPackage() *pkg.DefaultPackage
- func (a *PackageArtifact) GetPackageTreePath(treefs string) string
- func (a *PackageArtifact) GetProtectFiles() []string
- func (a *PackageArtifact) GetRepository() string
- func (a *PackageArtifact) GetSubsets() *LuetSubsetsDefinition
- func (a *PackageArtifact) GetTarFormersSpec(enableSubsets bool) *tarf_specs.SpecFile
- func (a *PackageArtifact) GetUncompressedName() string
- func (a *PackageArtifact) GetVersion() string
- func (a *PackageArtifact) Hash() error
- func (a *PackageArtifact) ResolveCachePath()
- func (p *PackageArtifact) ShallowCopy() *PackageArtifact
- func (a *PackageArtifact) Unpack(dst string, enableSubsets bool) error
- func (a *PackageArtifact) Verify() error
- func (a *PackageArtifact) WriteMetadataJson(dst string) error
- func (a *PackageArtifact) WriteMetadataYaml(dst string) error
- func (a *PackageArtifact) WriteYaml(dst string) error
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type ArtifactDiffs ¶
type ArtifactDiffs struct { Additions []ArtifactNode `json:"Adds"` Deletions []ArtifactNode `json:"Dels"` Changes []ArtifactNode `json:"Mods"` }
type ArtifactLayer ¶
type ArtifactLayer struct { FromImage string `json:"Image1"` ToImage string `json:"Image2"` Diffs ArtifactDiffs `json:"Diff"` }
type ArtifactNode ¶
type ArtifactsMap ¶
type ArtifactsMap struct {
Artifacts map[string][]*PackageArtifact `json:"artifacts" yaml:"artifacts"`
}
func NewArtifactsMap ¶
func NewArtifactsMap() *ArtifactsMap
func (*ArtifactsMap) Add ¶
func (am *ArtifactsMap) Add(p *PackageArtifact)
func (*ArtifactsMap) GetArtifactsByKey ¶
func (am *ArtifactsMap) GetArtifactsByKey(k string) ([]*PackageArtifact, error)
func (*ArtifactsMap) GetKeyFromValue ¶
func (am *ArtifactsMap) GetKeyFromValue(p *PackageArtifact) string
func (*ArtifactsMap) GetSortedArtifactsByKey ¶
func (am *ArtifactsMap) GetSortedArtifactsByKey(k string) ([]*PackageArtifact, error)
func (*ArtifactsMap) HasKey ¶
func (am *ArtifactsMap) HasKey(k string) bool
func (*ArtifactsMap) MatchVersion ¶
func (am *ArtifactsMap) MatchVersion(p *PackageArtifact) (*PackageArtifact, error)
func (*ArtifactsMap) ToList ¶
func (am *ArtifactsMap) ToList() *[]*PackageArtifact
type ArtifactsPack ¶
type ArtifactsPack struct {
Artifacts []*PackageArtifact `json:"artifacts" yaml:"artifacts"`
}
func NewArtifactsPack ¶
func NewArtifactsPack() *ArtifactsPack
func (*ArtifactsPack) ToMap ¶
func (ap *ArtifactsPack) ToMap() *ArtifactsMap
type Checksums ¶
func (*Checksums) Generate ¶
func (c *Checksums) Generate(a *PackageArtifact) error
Generate generates all Checksums supported for the artifact
type HashImplementation ¶
type HashImplementation string
const (
SHA256 HashImplementation = "sha256"
)
type HashOptions ¶
type HashOptions struct { Hasher hash.Hash Type HashImplementation }
type ImageBuilder ¶
type PackageArtifact ¶
type PackageArtifact struct { Path string `json:"path" yaml:"path"` CachePath string `json:"cache_path,omitempty" yaml:"cache_path,omitempty"` Dependencies []*PackageArtifact `json:"dependencies,omitempty" yaml:"dependencies,omitempty"` CompileSpec *compilerspec.LuetCompilationSpec `json:"compilespec,omitempty" yaml:"compilespec,omitempty"` Checksums Checksums `json:"checksums" yaml:"checksums"` SourceAssertion solver.PackagesAssertions `json:"-" yaml:"-"` CompressionType compression.Implementation `json:"compressiontype" yaml:"compressiontype"` Files []string `json:"files" yaml:"files"` PackageCacheImage string `json:"package_cacheimage,omitempty" yaml:"package_cacheimage,omitempty"` Runtime *pkg.DefaultPackage `json:"runtime,omitempty" yaml:"runtime,omitempty"` }
When compiling, we write also a fingerprint.metadata.yaml file with PackageArtifact. In this way we can have another command to create the repository
which will consist in just of an repository.yaml which is just the repository structure with the list of package artifact. In this way a generic client can fetch the packages and, after unpacking the tree, performing queries to install packages.
func CreateArtifactForFile ¶
func CreateArtifactForFile(s string, opts ...func(*PackageArtifact)) (*PackageArtifact, error)
CreateArtifactForFile creates a new artifact from the given file
func ExtractArtifactFromDelta ¶
func ExtractArtifactFromDelta(src, dst string, layers []ArtifactLayer, concurrency int, keepPerms bool, includes []string, excludes []string, t compression.Implementation) (*PackageArtifact, error)
ExtractArtifactFromDelta extracts deltas from ArtifactLayer from an image in tar format
func NewPackageArtifact ¶
func NewPackageArtifact(path string) *PackageArtifact
func NewPackageArtifactFromJson ¶
func NewPackageArtifactFromJson(data []byte) (*PackageArtifact, error)
func NewPackageArtifactFromYaml ¶
func NewPackageArtifactFromYaml(data []byte) (*PackageArtifact, error)
func (*PackageArtifact) Compress ¶
func (a *PackageArtifact) Compress(src string, concurrency int) error
Compress is responsible to archive and compress to the artifact Path. It accepts a source path, which is the content to be archived/compressed and a concurrency parameter.
func (*PackageArtifact) FileList ¶
func (a *PackageArtifact) FileList() ([]string, error)
FileList generates the list of file of a package from the local archive
func (*PackageArtifact) GenerateFinalImage ¶
func (a *PackageArtifact) GenerateFinalImage(imageName string, b ImageBuilder, keepPerms bool) (backend.Options, error)
GenerateFinalImage takes an artifact and builds a Docker image with its content
func (*PackageArtifact) GetFileName ¶
func (a *PackageArtifact) GetFileName() string
func (*PackageArtifact) GetPackage ¶
func (a *PackageArtifact) GetPackage() *pkg.DefaultPackage
func (*PackageArtifact) GetPackageTreePath ¶
func (a *PackageArtifact) GetPackageTreePath(treefs string) string
func (*PackageArtifact) GetProtectFiles ¶
func (a *PackageArtifact) GetProtectFiles() []string
func (*PackageArtifact) GetRepository ¶
func (a *PackageArtifact) GetRepository() string
func (*PackageArtifact) GetSubsets ¶
func (a *PackageArtifact) GetSubsets() *LuetSubsetsDefinition
func (*PackageArtifact) GetTarFormersSpec ¶
func (a *PackageArtifact) GetTarFormersSpec(enableSubsets bool) *tarf_specs.SpecFile
func (*PackageArtifact) GetUncompressedName ¶
func (a *PackageArtifact) GetUncompressedName() string
GetUncompressedName returns the artifact path without the extension suffix
func (*PackageArtifact) GetVersion ¶
func (a *PackageArtifact) GetVersion() string
func (*PackageArtifact) Hash ¶
func (a *PackageArtifact) Hash() error
func (*PackageArtifact) ResolveCachePath ¶
func (a *PackageArtifact) ResolveCachePath()
func (*PackageArtifact) ShallowCopy ¶
func (p *PackageArtifact) ShallowCopy() *PackageArtifact
func (*PackageArtifact) Unpack ¶
func (a *PackageArtifact) Unpack(dst string, enableSubsets bool) error
Unpack Untar and decompress (TODO) to the given path
func (*PackageArtifact) Verify ¶
func (a *PackageArtifact) Verify() error
func (*PackageArtifact) WriteMetadataJson ¶
func (a *PackageArtifact) WriteMetadataJson(dst string) error
func (*PackageArtifact) WriteMetadataYaml ¶
func (a *PackageArtifact) WriteMetadataYaml(dst string) error
func (*PackageArtifact) WriteYaml ¶
func (a *PackageArtifact) WriteYaml(dst string) error