Documentation
¶
Index ¶
- func FullyQualifiedReference(registryRef string) (string, error)
- func IsDigestReference(registryRef string) bool
- func NewTransport(ctx context.Context) http.RoundTripper
- func NormalizeReference(registryRef string) (string, error)
- func Pull(ctx context.Context, registryRef string, force bool, opts ...crane.Option) (string, error)
- func Push(ctx context.Context, reference string) error
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func FullyQualifiedReference ¶ added in v1.94.0
FullyQualifiedReference returns the fully-qualified form of an OCI reference, including the registry host (e.g. "index.docker.io/agentcatalog/review-pr:latest"). Equivalent shorthand forms map to the same value, while references that differ only by registry map to different values — unlike NormalizeReference, which strips the host.
func IsDigestReference ¶ added in v1.36.1
IsDigestReference reports whether the given reference pins a specific image digest (e.g. "repo@sha256:abc...").
func NewTransport ¶ added in v1.36.1
func NewTransport(ctx context.Context) http.RoundTripper
NewTransport returns an HTTP transport that uses the Docker Desktop proxy if available, and falls back to direct connections while re-probing the proxy after a cooldown so long-lived processes recover on their own.
func NormalizeReference ¶ added in v1.36.1
NormalizeReference parses an OCI reference and returns the normalized store key that Pull uses to store artifacts. This ensures that equivalent references (e.g. "agentcatalog/review-pr" and "index.docker.io/agentcatalog/review-pr:latest") map to the same key.
The registry host is deliberately stripped, so references that differ only by registry map to the same key. Callers that need a registry-scoped identity (e.g. cache keys spanning trust boundaries) must use FullyQualifiedReference instead.
func Pull ¶
func Pull(ctx context.Context, registryRef string, force bool, opts ...crane.Option) (string, error)
Pull pulls an artifact from a registry and stores it in the content store.
The digest check, manifest read, and layer downloads all reuse a single authenticated registry session (a remote.Puller) so the token exchange and underlying connection are established only once, rather than re-doing authentication for each step.
Types ¶
This section is empty.
Source Files