manifest

package
v0.8.7-115-g66f124e4 Latest Latest
Warning

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

 Go to latest Published: Jul 1, 2024 License: BSD-3-Clause Imports: 43 Imported by: 1

Documentation

Overview

SPDX-License-Identifier: BSD-3-Clause Copyright (c) 2022, Unikraft GmbH and The KraftKit Authors. Licensed under the BSD-3-Clause License (the "License"). You may not use this file except in compliance with the License.

SPDX-License-Identifier: BSD-3-Clause Copyright (c) 2022, Unikraft GmbH and The KraftKit Authors. Licensed under the BSD-3-Clause License (the "License"). You may not use this file except in compliance with the License.

SPDX-License-Identifier: BSD-3-Clause Copyright (c) 2022, Unikraft GmbH and The KraftKit Authors. Licensed under the BSD-3-Clause License (the "License"). You may not use this file except in compliance with the License.

SPDX-License-Identifier: BSD-3-Clause Copyright (c) 2022, Unikraft GmbH and The KraftKit Authors. Licensed under the BSD-3-Clause License (the "License"). You may not use this file except in compliance with the License.

SPDX-License-Identifier: BSD-3-Clause Copyright (c) 2022, Unikraft GmbH and The KraftKit Authors. Licensed under the BSD-3-Clause License (the "License"). You may not use this file except in compliance with the License.

SPDX-License-Identifier: BSD-3-Clause Copyright (c) 2022, Unikraft GmbH and The KraftKit Authors. Licensed under the BSD-3-Clause License (the "License"). You may not use this file except in compliance with the License.

SPDX-License-Identifier: BSD-3-Clause Copyright (c) 2022, Unikraft GmbH and The KraftKit Authors. Licensed under the BSD-3-Clause License (the "License"). You may not use this file except in compliance with the License.

SPDX-License-Identifier: BSD-3-Clause Copyright (c) 2022, Unikraft GmbH and The KraftKit Authors. Licensed under the BSD-3-Clause License (the "License"). You may not use this file except in compliance with the License.

SPDX-License-Identifier: BSD-3-Clause Copyright (c) 2022, Unikraft GmbH and The KraftKit Authors. Licensed under the BSD-3-Clause License (the "License"). You may not use this file expect in compliance with the License.

SPDX-License-Identifier: BSD-3-Clause Copyright (c) 2022, Unikraft GmbH and The KraftKit Authors. Licensed under the BSD-3-Clause License (the "License"). You may not use this file except in compliance with the License.

SPDX-License-Identifier: BSD-3-Clause Copyright (c) 2022, Unikraft GmbH and The KraftKit Authors. Licensed under the BSD-3-Clause License (the "License"). You may not use this file except in compliance with the License.

SPDX-License-Identifier: BSD-3-Clause Copyright (c) 2022, Unikraft GmbH and The KraftKit Authors. Licensed under the BSD-3-Clause License (the "License"). You may not use this file except in compliance with the License.

SPDX-License-Identifier: BSD-3-Clause Copyright (c) 2022, Unikraft GmbH and The KraftKit Authors. Licensed under the BSD-3-Clause License (the "License"). You may not use this file except in compliance with the License.

Index

Constants

View Source 
const ManifestFormat pack.PackageFormat = "manifest"

Variables

This section is empty.

Functions

func NewManifestManager added in v0.4.0 

func NewManifestManager(ctx context.Context, opts ...any) (packmanager.PackageManager, error)

NewManifestManager returns a `packmanager.PackageManager` which manipulates Unikraft manifests.

func NewPackageFromManifest 

func NewPackageFromManifest(manifest *Manifest, opts ...ManifestOption) (pack.Package, error)

NewPackageFromManifest generates a manifest implementation of the pack.Package construct based on the input Manifest using its default channel

func NewPackageFromManifestWithVersion added in v0.4.0 

func NewPackageFromManifestWithVersion(manifest *Manifest, version string, opts ...ManifestOption) (pack.Package, error)

NewPackageFromManifestWithVersion generates a new package based on an input manifest which in itself may contain various versions and channels. With the provided version as a positional parameter, the manifest can be reduced to represent a specific version.

func RegisterFlags added in v0.6.7 

func RegisterFlags()

func RegisterPackageManager added in v0.6.7 

func RegisterPackageManager() func(u *packmanager.UmbrellaManager) error

Types

type DirectoryProvider 

type DirectoryProvider struct {
	// contains filtered or unexported fields
}

func (DirectoryProvider) DeleteManifest added in v0.7.0 

func (dp DirectoryProvider) DeleteManifest(context.Context) error

func (DirectoryProvider) Manifests 

func (dp DirectoryProvider) Manifests() ([]*Manifest, error)

func (DirectoryProvider) MarshalJSON added in v0.7.2 

func (dp DirectoryProvider) MarshalJSON() ([]byte, error)

func (DirectoryProvider) PullManifest added in v0.4.0 

func (dp DirectoryProvider) PullManifest(ctx context.Context, manifest *Manifest, opts ...pack.PullOption) error

func (DirectoryProvider) String 

func (dp DirectoryProvider) String() string

type GitHubProvider 

type GitHubProvider struct {
	// contains filtered or unexported fields
}

func (GitHubProvider) DeleteManifest added in v0.7.0 

func (ghp GitHubProvider) DeleteManifest(context.Context) error

func (GitHubProvider) Manifests 

func (ghp GitHubProvider) Manifests() ([]*Manifest, error)

func (GitHubProvider) MarshalJSON added in v0.7.2 

func (ghp GitHubProvider) MarshalJSON() ([]byte, error)

func (GitHubProvider) PullManifest added in v0.4.0 

func (ghp GitHubProvider) PullManifest(ctx context.Context, manifest *Manifest, popts ...pack.PullOption) error

func (GitHubProvider) String 

func (ghp GitHubProvider) String() string

type GitProvider 

type GitProvider struct {
	// contains filtered or unexported fields
}

func (*GitProvider) DeleteManifest added in v0.7.0 

func (gp *GitProvider) DeleteManifest(context.Context) error

func (*GitProvider) Manifests 

func (gp *GitProvider) Manifests() ([]*Manifest, error)

func (*GitProvider) MarshalJSON added in v0.7.2 

func (gp *GitProvider) MarshalJSON() ([]byte, error)

func (*GitProvider) PullManifest added in v0.4.0 

func (gp *GitProvider) PullManifest(ctx context.Context, manifest *Manifest, popts ...pack.PullOption) error

func (*GitProvider) String 

func (gp *GitProvider) String() string

type Manifest 

type Manifest struct {
	// Name of the entity which this manifest represents
	Name string `yaml:"name" json:"name"`

	// Type of entity which this manifest represetns
	Type unikraft.ComponentType `yaml:"type" json:"type"`

	// Manifest is used to point to remote manifest, allowing the manifest itself
	// to be retrieved by indirection.  Manifest is XOR with Versions and should
	// be back-propagated.
	Manifest string `yaml:"manifest,omitempty" json:"manifest,omitempty"`

	// Description of what this manifest represents
	Description string `yaml:"description,omitempty" json:"description,omitempty"`

	// Origin represents where (and therefore how) this manifest was populated
	Origin string `yaml:"origin,omitempty" json:"origin,omitempty"`

	// Provider is the string name of the underlying implementation providing the
	// contents of this manifest
	Provider Provider `yaml:"provider,omitempty" json:"provider,omitempty"`

	// Channels provides multiple ways to retrieve versions.  Classically this is
	// a separation between "staging" and "stable"
	Channels []ManifestChannel `yaml:"channels,omitempty" json:"channels,omitempty"`

	// Versions
	Versions []ManifestVersion `yaml:"versions,omitempty" json:"versions,omitempty"`
	// contains filtered or unexported fields
}

func FindManifestsFromSource 

func FindManifestsFromSource(ctx context.Context, source string, mopts ...ManifestOption) ([]*Manifest, error)

FindManifestsFromSource is a recursive method which follows a given source and attempts to instantiate a Provider which matches the given source. If the source is recognised by a provider, it is traversed to return all the known Manifests.

func NewManifestFromBytes 

func NewManifestFromBytes(ctx context.Context, raw []byte, opts ...ManifestOption) (*Manifest, error)

NewManifestFromBytes parses a byte array of a YAML representing a manifest

func NewManifestFromFile 

func NewManifestFromFile(ctx context.Context, path string, mopts ...ManifestOption) (*Manifest, error)

NewManifestFromFile reads in a manifest file from a given path

func NewManifestFromURL 

func NewManifestFromURL(ctx context.Context, path string, mopts ...ManifestOption) (*Manifest, error)

NewManifestFromURL retrieves a provided path as a Manifest from a remote location over HTTP

func (Manifest) DefaultChannel 

func (m Manifest) DefaultChannel() (*ManifestChannel, error)

DefaultChannel returns the default channel of the Manifest

func (Manifest) WriteToFile 

func (m Manifest) WriteToFile(path string) error

WriteToFile saves the manifest as a YAML format file at the given path

type ManifestChannel 

type ManifestChannel struct {
	Name     string `yaml:"name"`
	Default  bool   `yaml:"default,omitempty"`
	Latest   string `yaml:"latest,omitempty"`
	Manifest string `yaml:"manifest,omitempty"`
	Resource string `yaml:"resource"`
	Sha256   string `yaml:"sha256,omitempty"`
}

type ManifestIndex 

type ManifestIndex struct {
	Name        string      `yaml:"name,omitempty"`
	LastUpdated time.Time   `yaml:"last_updated"`
	Manifests   []*Manifest `yaml:"manifests"`
	Origin      string      `yaml:"-"`
}

func NewManifestIndexFromBytes 

func NewManifestIndexFromBytes(raw []byte, opts ...ManifestOption) (*ManifestIndex, error)

NewManifestIndexFromBytes parses a byte array of a YAML representing a manifest index

func NewManifestIndexFromFile 

func NewManifestIndexFromFile(path string, mopts ...ManifestOption) (*ManifestIndex, error)

func NewManifestIndexFromURL 

func NewManifestIndexFromURL(ctx context.Context, path string, mopts ...ManifestOption) (*ManifestIndex, error)

NewManifestFromURL retrieves a provided path as a ManifestIndex from a remote location over HTTP

func (*ManifestIndex) WriteToFile 

func (mi *ManifestIndex) WriteToFile(path string) error

type ManifestIndexProvider 

type ManifestIndexProvider struct {
	// contains filtered or unexported fields
}

func (*ManifestIndexProvider) DeleteManifest added in v0.7.0 

func (mip *ManifestIndexProvider) DeleteManifest(context.Context) error

func (*ManifestIndexProvider) Manifests 

func (mip *ManifestIndexProvider) Manifests() ([]*Manifest, error)

func (*ManifestIndexProvider) MarshalJSON added in v0.7.2 

func (mip *ManifestIndexProvider) MarshalJSON() ([]byte, error)

func (*ManifestIndexProvider) PullManifest added in v0.4.0 

func (mip *ManifestIndexProvider) PullManifest(ctx context.Context, manifest *Manifest, opts ...pack.PullOption) error

func (*ManifestIndexProvider) String 

func (mip *ManifestIndexProvider) String() string

type ManifestManagerOption added in v0.6.0 

type ManifestManagerOption func(context.Context, *manifestManager) error

ManifestManagerOption represents a specific configuration that can be used for the Manifest Package Manager.

type ManifestOption 

type ManifestOption func(*ManifestOptions)

func WithAuthConfig 

func WithAuthConfig(auths map[string]config.AuthConfig) ManifestOption

WithAuthConfig sets any required authentication necessary for accessing the manifest.

func WithCacheDir added in v0.6.0 

func WithCacheDir(dir string) ManifestOption

WithCacheDir is an option which helps find cached Manifest Channel or Version resources. When set to a directory, the fixed structure of this directory should allow us to look up (and also store) resources here for later use.

func WithUpdate added in v0.7.0 

func WithUpdate(update bool) ManifestOption

WithUpdate is an option to indicate that remote network connections can be made when instantiating a Manifest(Index) or to allow probing remote sources to determine versions, etc.

type ManifestOptions added in v0.6.0 

type ManifestOptions struct {
	// contains filtered or unexported fields
}

ManifestOptions contains a set of additional configuration necessary for the underlying ManifestProvider implementation that are not attributes of the provider itself.

func NewManifestOptions added in v0.6.0 

func NewManifestOptions(opts ...ManifestOption) *ManifestOptions

NewManifestOptions returns an instantiated ManifestOptions based on variable input number of ManifestOption methods.

type ManifestProvider 

type ManifestProvider struct {
	// contains filtered or unexported fields
}

func (*ManifestProvider) DeleteManifest added in v0.7.0 

func (mp *ManifestProvider) DeleteManifest(ctx context.Context) error

func (*ManifestProvider) Manifests 

func (mp *ManifestProvider) Manifests() ([]*Manifest, error)

func (*ManifestProvider) MarshalJSON added in v0.7.2 

func (mp *ManifestProvider) MarshalJSON() ([]byte, error)

func (*ManifestProvider) PullManifest added in v0.4.0 

func (mp *ManifestProvider) PullManifest(ctx context.Context, manifest *Manifest, opts ...pack.PullOption) error

func (*ManifestProvider) String 

func (mp *ManifestProvider) String() string

type ManifestVersion 

type ManifestVersion struct {
	Version  string              `yaml:"version"`
	Resource string              `yaml:"resource"`
	Sha256   string              `yaml:"sha256,omitempty"`
	Type     ManifestVersionType `yaml:"type,omitempty"`
	Unikraft string              `yaml:"unikraft,omitempty"`
}

func (*ManifestVersion) ShortGitSha 

func (mv *ManifestVersion) ShortGitSha() (string, error)

type ManifestVersionType 

type ManifestVersionType string
const (
	ManifestVersionSemver ManifestVersionType = "semver"
	ManifestVersionGitSha ManifestVersionType = "gitsha"
)

type Provider 

type Provider interface {
	// Manifests returns a slice of Manifests which can be returned by this
	// Provider
	Manifests() ([]*Manifest, error)

	// PullManifest from the provider.
	PullManifest(context.Context, *Manifest, ...pack.PullOption) error

	// DeleteManifest deletes the artifact based on the provider's implementation.
	DeleteManifest(context.Context) error

	// String returns the name of the provider
	fmt.Stringer

	json.Marshaler
}

func NewDirectoryProvider 

func NewDirectoryProvider(ctx context.Context, path string, opts ...ManifestOption) (Provider, error)

NewDirectoryProvider attempts to parse a provided path as a Unikraft "microlibirary" directory

func NewGitHubProvider 

func NewGitHubProvider(ctx context.Context, path string, opts ...ManifestOption) (Provider, error)

NewGitHubProvider attempts to parse the input path as a location provided on GitHub. Additional context for authentication is necessary to use this provider if the location is held within a private repository. Otherwise we can both probe GitHub's API as well as exploit the fact that it is a Git repository to retrieve information and deliver information as a Manifest format.

func NewGitProvider 

func NewGitProvider(ctx context.Context, path string, opts ...ManifestOption) (Provider, error)

NewGitProvider attempts to parse a provided path as a Git repository

func NewManifestIndexProvider 

func NewManifestIndexProvider(ctx context.Context, path string, mopts ...ManifestOption) (Provider, error)

NewManifestIndexProvider accepts an input path which is checked against first a local file on disk and then a remote URL. If either of these checks pass, the Provider is instantiated since the path does indeed represent a ManifestIndex.

func NewManifestProvider 

func NewManifestProvider(ctx context.Context, path string, mopts ...ManifestOption) (Provider, error)

NewManifestProvider accepts an input path which is checked against a local file on disk and a remote URL. If populating a Manifest struct is possible given the path, then this provider is able to return list of exactly 1 manifest.

func NewProvider 

func NewProvider(ctx context.Context, path string, mopts ...ManifestOption) (Provider, error)

NewProvider ultimately returns one of the supported manifest providers by attempting an ordered instantiation based on the input source. For the provider which does not return an error is indicator that it is supported and thus the return of NewProvider a compatible interface Provider able to gather information about the manifest.

func NewProviderFromString added in v0.2.0 

func NewProviderFromString(ctx context.Context, provider, path string, entity any, mopts ...ManifestOption) (Provider, error)

NewProviderFromString returns a provider based on a giving string which identifies the provider

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.