02719bdbb5
Enable inspection (aka "shallow pull") of images' manifest info, and also the creation of manifest lists (aka "fat manifests"). The workflow for creating a manifest list will be: `docker manifest create new-list-ref-name image-ref [image-ref...]` `docker manifest annotate new-list-ref-name image-ref --os linux --arch arm` `docker manifest push new-list-ref-name` The annotate step is optional. Most architectures are fine by default. There is also a `manifest inspect` command to allow for a "shallow pull" of an image's manifest: `docker manifest inspect manifest-or-manifest_list`. To be more in line with the existing external manifest tool, there is also a `-v` option for inspect that will show information depending on what the reference maps to (list or single manifest). Signed-off-by: Christy Perez <christy@linux.vnet.ibm.com> Signed-off-by: Daniel Nephin <dnephin@docker.com>
80 lines
2.5 KiB
Go
80 lines
2.5 KiB
Go
package manifest
|
|
|
|
import (
|
|
"github.com/docker/cli/cli/command"
|
|
"github.com/docker/cli/cli/manifest/store"
|
|
"github.com/docker/cli/cli/manifest/types"
|
|
"github.com/docker/distribution/reference"
|
|
"golang.org/x/net/context"
|
|
)
|
|
|
|
type osArch struct {
|
|
os string
|
|
arch string
|
|
}
|
|
|
|
// Remove any unsupported os/arch combo
|
|
// list of valid os/arch values (see "Optional Environment Variables" section
|
|
// of https://golang.org/doc/install/source
|
|
// Added linux/s390x as we know System z support already exists
|
|
var validOSArches = map[osArch]bool{
|
|
{os: "darwin", arch: "386"}: true,
|
|
{os: "darwin", arch: "amd64"}: true,
|
|
{os: "darwin", arch: "arm"}: true,
|
|
{os: "darwin", arch: "arm64"}: true,
|
|
{os: "dragonfly", arch: "amd64"}: true,
|
|
{os: "freebsd", arch: "386"}: true,
|
|
{os: "freebsd", arch: "amd64"}: true,
|
|
{os: "freebsd", arch: "arm"}: true,
|
|
{os: "linux", arch: "386"}: true,
|
|
{os: "linux", arch: "amd64"}: true,
|
|
{os: "linux", arch: "arm"}: true,
|
|
{os: "linux", arch: "arm64"}: true,
|
|
{os: "linux", arch: "ppc64le"}: true,
|
|
{os: "linux", arch: "mips64"}: true,
|
|
{os: "linux", arch: "mips64le"}: true,
|
|
{os: "linux", arch: "s390x"}: true,
|
|
{os: "netbsd", arch: "386"}: true,
|
|
{os: "netbsd", arch: "amd64"}: true,
|
|
{os: "netbsd", arch: "arm"}: true,
|
|
{os: "openbsd", arch: "386"}: true,
|
|
{os: "openbsd", arch: "amd64"}: true,
|
|
{os: "openbsd", arch: "arm"}: true,
|
|
{os: "plan9", arch: "386"}: true,
|
|
{os: "plan9", arch: "amd64"}: true,
|
|
{os: "solaris", arch: "amd64"}: true,
|
|
{os: "windows", arch: "386"}: true,
|
|
{os: "windows", arch: "amd64"}: true,
|
|
}
|
|
|
|
func isValidOSArch(os string, arch string) bool {
|
|
// check for existence of this combo
|
|
_, ok := validOSArches[osArch{os, arch}]
|
|
return ok
|
|
}
|
|
|
|
func normalizeReference(ref string) (reference.Named, error) {
|
|
namedRef, err := reference.ParseNormalizedNamed(ref)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
if _, isDigested := namedRef.(reference.Canonical); !isDigested {
|
|
return reference.TagNameOnly(namedRef), nil
|
|
}
|
|
return namedRef, nil
|
|
}
|
|
|
|
// getManifest from the local store, and fallback to the remote registry if it
|
|
// doesn't exist locally
|
|
func getManifest(ctx context.Context, dockerCli command.Cli, listRef, namedRef reference.Named, insecure bool) (types.ImageManifest, error) {
|
|
data, err := dockerCli.ManifestStore().Get(listRef, namedRef)
|
|
switch {
|
|
case store.IsNotFound(err):
|
|
return dockerCli.RegistryClient(insecure).GetManifest(ctx, namedRef)
|
|
case err != nil:
|
|
return types.ImageManifest{}, err
|
|
default:
|
|
return data, nil
|
|
}
|
|
}
|