Skip to content
Work with containers' images
Go Other
  1. Go 99.6%
  2. Other 0.4%
Branch: master
Clone or download
mtrmac Merge pull request #798 from containers/dependabot/go_modules/github.…
…com/klauspost/compress-1.9.8

Bump github.com/klauspost/compress from 1.9.7 to 1.9.8
Latest commit 8ccd741 Jan 23, 2020
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
copy
directory Fix this value is never used Nov 26, 2019
docker Add a log entry after each pullSource access failure Jan 9, 2020
docs Add registries warning to registries.conf Dec 13, 2019
image Fix Error return value is not checked Nov 26, 2019
internal internal/pkg/keyctl: drop deprecation warning Dec 4, 2019
manifest Change golint to golangci-lint Nov 27, 2019
oci Fix Error return value is not checked Nov 26, 2019
openshift Fix Error return value is not checked Nov 26, 2019
ostree Redefine ImageDestination.MustMatchRuntimeOS to also include architec… Nov 22, 2019
pkg Add internal error handling Nov 27, 2019
signature Always use SigningMechanism implementations by reference Jan 20, 2020
storage storage_test.go: check storage interfaces Nov 28, 2019
tarball Clean up various imports Oct 25, 2019
transports Update to major version v5 Oct 25, 2019
types Allow for disabling schema1 MIME types for docker destinations Jan 8, 2020
version Move to v5.1.1-dev Dec 13, 2019
.cirrus.yml Enable Cirrus validation tests Dec 4, 2019
.gitignore Issue #475 Add flag for image compress layer for oci destination Jul 12, 2018
.golangci.yml Enable Cirrus validation tests Dec 4, 2019
.pullapprove.yml *: add pullapprove Jun 27, 2016
.travis.Dockerfile Change golint to golangci-lint Nov 27, 2019
.travis.yml Makefile: split tools installation Dec 4, 2019
CONTRIBUTING.md Modify CONTRIBUTING.md to prefer smaller commits over squashing them Nov 6, 2017
LICENSE Move to Apache 2 license Jun 24, 2016
MAINTAINERS add @vrothberg to the list of MAINTAINERS Jan 11, 2019
Makefile make test-skopeo: only run unit tests Dec 4, 2019
README.md Replace `vendor.conf` by `go.mod` Sep 2, 2019
doc.go Update to major version v5 Oct 25, 2019
go.mod Bump github.com/klauspost/compress from 1.9.7 to 1.9.8 Jan 22, 2020
go.sum Bump github.com/klauspost/compress from 1.9.7 to 1.9.8 Jan 22, 2020
registries.conf Add registries warning to registries.conf Dec 13, 2019

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 ships as a Go module.

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, include it as a Go module, put it into $GOPATH or use your preferred vendoring tool to include a copy in your project. Ensure that the dependencies documented in go.mod 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 ostree-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: Import ostree: transport in github.com/containers/image/transports/alltransports. This builds the library requiring the libostree development libraries. Otherwise a stub which reports that the transport is not supported gets used. The github.com/containers/image/ostree package is completely disabled and impossible to import when this build tag is not in use.

Contributing

Information about contributing to this project.

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

License

Apache License 2.0

SPDX-License-Identifier: Apache-2.0

Contact

  • Mailing list: containers-dev
  • IRC: #container-projects on freenode.net
You can’t perform that action at this time.