vbatts/cri-o
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity
cri-o/vendor/github.com/containers/image
History
baude 951a943d16 libkpod/image/copy.go: Add pull by short-name 
If the user provides kpod pull a short name like 'debian', we
still want the pull to be sucessful.  As such, when a short
name is provided, we get the list of searchable registries via
the systemregistries code in containers-storage.  We then
append a tag of 'latest' (if not provided) and we formulate
a list of possible fully-qualified image names to try.

Vendor update for containers-storage to bring in the system_registries
code.

Also includes a patch from Nalin to fix compilation errors.

Signed-off-by: baude <bbaude@redhat.com>
2017-09-14 08:33:10 -05:00
..
copy fix issue with official images and manifest lits 2017-09-13 19:01:06 +02:00
directory fix issue with official images and manifest lits 2017-09-13 19:01:06 +02:00
docker fix issue with official images and manifest lits 2017-09-13 19:01:06 +02:00
image Vendor in latest containers/image 2017-09-05 14:19:10 -04:00
manifest fix issue with official images and manifest lits 2017-09-13 19:01:06 +02:00
oci fix issue with official images and manifest lits 2017-09-13 19:01:06 +02:00
openshift fix issue with official images and manifest lits 2017-09-13 19:01:06 +02:00
ostree fix issue with official images and manifest lits 2017-09-13 19:01:06 +02:00
pkg libkpod/image/copy.go: Add pull by short-name 2017-09-14 08:33:10 -05:00
signature Move to new github.com/sirupsen/logrus. 2017-08-07 11:50:04 -04:00
storage fix issue with official images and manifest lits 2017-09-13 19:01:06 +02:00
transports Vendor in changes made to containers/image for OCI 2017-08-31 16:40:13 -04:00
types fix issue with official images and manifest lits 2017-09-13 19:01:06 +02:00
version Build and install from GOPATH 2017-01-17 12:09:09 -08:00
LICENSE Build and install from GOPATH 2017-01-17 12:09:09 -08:00
README.md Vendor in latest containers/image 2017-09-05 14:19:10 -04:00
vendor.conf Vendor in latest containers/image 2017-09-05 14:19:10 -04:00

README.md

GoDoc Build Status

image is a set of Go libraries aimed at working in various way with containers' images and container image registries.

The containers/image library allows application to pull and push images from container image registries, like the upstream docker registry. It also implements "simple image signing".

The containers/image library also allows you to inspect a repository on a container registry without pulling down the image. This means it fetches the repository's manifest and it is able to show you a docker inspect-like json output about a whole repository or a tag. This library, in contrast to docker inspect, helps you gather useful information about a repository or a tag without requiring you to run docker pull.

The containers/image library also allows you to translate from one image format to another, for example docker container images to OCI images. It also allows you to copy container images between various registries, possibly converting them as necessary, and to sign and verify images.

Command-line usage

The containers/image project is only a library with no user interface; you can either incorporate it into your Go programs, or use the skopeo tool:

The skopeo tool uses the containers/image library and takes advantage of many of its features, e.g. skopeo copy exposes the containers/image/copy.Image functionality.

Dependencies

This library does not ship a committed version of its dependencies in a vendor subdirectory. This is so you can make well-informed decisions about which libraries you should use with this package in your own projects, and because types defined in the vendor directory would be impossible to use from your projects.

What this project tests against dependencies-wise is located in vendor.conf.

Building

If you want to see what the library can do, or an example of how it is called, consider starting with the skopeo tool instead.

To integrate this library into your project, put it into $GOPATH or use your preferred vendoring tool to include a copy in your project. Ensure that the dependencies documented in vendor.conf are also available (using those exact versions or different versions of your choosing).

This library, by default, also depends on the GpgME and libostree C libraries. Either install them:

Fedora$ dnf install gpgme-devel libassuan-devel libostree-devel
macOS$ brew install gpgme

or use the build tags described below to avoid the dependencies (e.g. using go build -tags …)

Supported build tags

  • containers_image_openpgp: Use a Golang-only OpenPGP implementation for signature verification instead of the default cgo/gpgme-based implementation; the primary downside is that creating new signatures with the Golang-only implementation is not supported.
  • containers_image_ostree_stub: Instead of importing ostree: transport in github.com/containers/image/transports/alltransports, use a stub which reports that the transport is not supported. This allows building the library without requiring the libostree development libraries. The github.com/containers/image/ostree package is completely disabled and impossible to import when this build tag is in use.

Contributing

When developing this library, please use make (or make … BUILDTAGS=…) to take advantage of the tests and validation.

License

ASL 2.0

Contact