remoterelease

Documentation

Overview

Package remoterelease provides a content-addressed remote transport for signed ReDevPlugin release assets. It contains no source discovery or trust decisions: callers supply an already reviewed locator-to-asset projection.

Index

• Variables
• type Asset
• type AssetFetcher
• type AssetSet
  • func NewAssetSet(options AssetSetOptions) (*AssetSet, error)
  • func (set *AssetSet) FetchReleaseDocument(ctx context.Context, request releasetrust.ReleaseDocumentRequest) (releasetrust.ReleaseDocumentResult, error)
  • func (set *AssetSet) FetchSigningLedgerArtifact(ctx context.Context, request releasetrust.SigningLedgerRequest) (releasetrust.SigningLedgerResult, error)
  • func (set *AssetSet) ResolveReleaseArtifact(ctx context.Context, request host.ReleaseArtifactResolveRequest) (host.ResolvedPackageArtifact, error)
• type AssetSetOptions
• type Error
  • func DetailsOf(err error) (Error, bool)
  • func (e *Error) Error() string
  • func (e *Error) ReleaseArtifactFailure() host.ReleaseArtifactFailure
  • func (e *Error) Unwrap() error

Variables

var (
	ErrInvalidAssetSet = errors.New("remote release asset set is invalid")
	ErrAssetMissing    = errors.New("remote release asset is missing")
	ErrAssetMismatch   = errors.New("remote release asset identity mismatch")
)

Types

type Asset

type Asset struct {
	Locator string `json:"locator"`
	URL     string `json:"url"`
	SHA256  string `json:"sha256"`
	Size    int64  `json:"size"`
}

type AssetFetcher

type AssetFetcher interface {
	FetchArtifact(context.Context, externalsource.ArtifactFetchRequest) (externalsource.ArtifactFetchResult, error)
}

type AssetSet

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

AssetSet is an immutable, current-release projection. Updating a catalog creates a new set instead of mutating a set used by an in-flight operation.

func NewAssetSet

func NewAssetSet(options AssetSetOptions) (*AssetSet, error)

func (*AssetSet) FetchReleaseDocument

func (set *AssetSet) FetchReleaseDocument(ctx context.Context, request releasetrust.ReleaseDocumentRequest) (releasetrust.ReleaseDocumentResult, error)

func (*AssetSet) FetchSigningLedgerArtifact

func (set *AssetSet) FetchSigningLedgerArtifact(ctx context.Context, request releasetrust.SigningLedgerRequest) (releasetrust.SigningLedgerResult, error)

func (*AssetSet) ResolveReleaseArtifact

func (set *AssetSet) ResolveReleaseArtifact(ctx context.Context, request host.ReleaseArtifactResolveRequest) (host.ResolvedPackageArtifact, error)

type AssetSetOptions

type AssetSetOptions struct {
	SourceID     string
	Channel      string
	QuotaKey     string
	AllowedHosts []string
	Assets       []Asset
	Fetcher      AssetFetcher
	FetchTimeout time.Duration
}

type Error

type Error struct {
	Phase         string
	ArtifactRole  string
	Retryable     bool
	Attempts      int
	LocatorSHA256 string
	// contains filtered or unexported fields
}

func DetailsOf

func DetailsOf(err error) (Error, bool)

func (*Error) Error

func (e *Error) Error() string

func (*Error) ReleaseArtifactFailure

func (e *Error) ReleaseArtifactFailure() host.ReleaseArtifactFailure

func (*Error) Unwrap

func (e *Error) Unwrap() error