README
¶
go-containerregistry
Introduction
This is a golang library for working with container registries. It's largely based on the Python library of the same name.
Tools
This repo hosts some tools built on top of the library.
ko
ko is a tool for building and deploying golang
applications to kubernetes.
crane
crane is a tool for interacting with remote images
and registries.
gcrane
gcrane is a GCR-specific variant of crane that has
richer output for the ls subcommand and some basic garbage collection support.
k8schain
k8schain implements the authentication
semantics use by kubelets in a way that is easily consumable by this library.
k8schain is not a standalone tool, but it's linked here for visibility.
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
pkg
|
|
|
authn
Package authn defines different methods of authentication for talking to a container registry.
|
Package authn defines different methods of authentication for talking to a container registry. |
|
authn/k8schain
Package k8schain exposes an implementation of the authn.Keychain interface based on the semantics the Kubelet follows when pulling the images for a Pod in Kubernetes.
|
Package k8schain exposes an implementation of the authn.Keychain interface based on the semantics the Kubelet follows when pulling the images for a Pod in Kubernetes. |
|
gcrane
Package gcrane holds libraries used to implement the gcrane CLI.
|
Package gcrane holds libraries used to implement the gcrane CLI. |
|
ko
Package ko holds libraries used to implement the ko CLI.
|
Package ko holds libraries used to implement the ko CLI. |
|
ko/build
Package build defines methods for building a v1.Image reference from a Go binary reference.
|
Package build defines methods for building a v1.Image reference from a Go binary reference. |
|
ko/publish
Package publish defines methods for publishing a v1.Image reference and returning the published digest for embedding back into a Kubernetes yaml.
|
Package publish defines methods for publishing a v1.Image reference and returning the published digest for embedding back into a Kubernetes yaml. |
|
ko/resolve
Package resolve defines logic for resolving K8s yaml inputs to ko.
|
Package resolve defines logic for resolving K8s yaml inputs to ko. |
|
name
Package name defines structured types for representing image references.
|
Package name defines structured types for representing image references. |
|
v1
Package v1 defines structured types for OCI v1 images
|
Package v1 defines structured types for OCI v1 images |
|
v1/daemon
Package daemon provides facilities for reading/writing v1.Image from/to a running daemon.
|
Package daemon provides facilities for reading/writing v1.Image from/to a running daemon. |
|
v1/empty
Package empty provides an implementation of v1.Image equivalent to "FROM scratch".
|
Package empty provides an implementation of v1.Image equivalent to "FROM scratch". |
|
v1/google
Package google provides facilities for listing images in gcr.io.
|
Package google provides facilities for listing images in gcr.io. |
|
v1/mutate
Package mutate provides facilities for mutating v1.Images of any kind.
|
Package mutate provides facilities for mutating v1.Images of any kind. |
|
v1/partial
Package partial defines methods for building up a v1.Image from minimal subsets that are sufficient for defining a v1.Image.
|
Package partial defines methods for building up a v1.Image from minimal subsets that are sufficient for defining a v1.Image. |
|
v1/random
Package random provides a facility for synthesizing pseudo-random images.
|
Package random provides a facility for synthesizing pseudo-random images. |
|
v1/remote
Package remote provides facilities for reading/writing v1.Images from/to a remote image registry.
|
Package remote provides facilities for reading/writing v1.Images from/to a remote image registry. |
|
v1/remote/transport
Package transport provides facilities for setting up an authenticated http.RoundTripper given an Authenticator and base RoundTripper.
|
Package transport provides facilities for setting up an authenticated http.RoundTripper given an Authenticator and base RoundTripper. |
|
v1/tarball
Package tarball provides facilities for reading/writing v1.Images from/to a tarball on-disk.
|
Package tarball provides facilities for reading/writing v1.Images from/to a tarball on-disk. |
|
v1/validate
Package validate provides methods for validating image correctness.
|
Package validate provides methods for validating image correctness. |
Click to show internal directories.
Click to hide internal directories.