129 lines
6.1 KiB
Go
129 lines
6.1 KiB
Go
package image
|
|
|
|
import (
|
|
"time"
|
|
|
|
"github.com/containers/image/docker/reference"
|
|
"github.com/containers/image/manifest"
|
|
"github.com/containers/image/pkg/strslice"
|
|
"github.com/containers/image/types"
|
|
"github.com/opencontainers/go-digest"
|
|
imgspecv1 "github.com/opencontainers/image-spec/specs-go/v1"
|
|
)
|
|
|
|
type config struct {
|
|
Cmd strslice.StrSlice
|
|
Labels map[string]string
|
|
}
|
|
|
|
type v1Image struct {
|
|
ID string `json:"id,omitempty"`
|
|
Parent string `json:"parent,omitempty"`
|
|
Comment string `json:"comment,omitempty"`
|
|
Created time.Time `json:"created"`
|
|
ContainerConfig *config `json:"container_config,omitempty"`
|
|
DockerVersion string `json:"docker_version,omitempty"`
|
|
Author string `json:"author,omitempty"`
|
|
// Config is the configuration of the container received from the client
|
|
Config *config `json:"config,omitempty"`
|
|
// Architecture is the hardware that the image is build and runs on
|
|
Architecture string `json:"architecture,omitempty"`
|
|
// OS is the operating system used to build and run the image
|
|
OS string `json:"os,omitempty"`
|
|
}
|
|
|
|
type image struct {
|
|
v1Image
|
|
History []imageHistory `json:"history,omitempty"`
|
|
RootFS *rootFS `json:"rootfs,omitempty"`
|
|
}
|
|
|
|
type imageHistory struct {
|
|
Created time.Time `json:"created"`
|
|
Author string `json:"author,omitempty"`
|
|
CreatedBy string `json:"created_by,omitempty"`
|
|
Comment string `json:"comment,omitempty"`
|
|
EmptyLayer bool `json:"empty_layer,omitempty"`
|
|
}
|
|
|
|
type rootFS struct {
|
|
Type string `json:"type"`
|
|
DiffIDs []digest.Digest `json:"diff_ids,omitempty"`
|
|
BaseLayer string `json:"base_layer,omitempty"`
|
|
}
|
|
|
|
// genericManifest is an interface for parsing, modifying image manifests and related data.
|
|
// Note that the public methods are intended to be a subset of types.Image
|
|
// so that embedding a genericManifest into structs works.
|
|
// will support v1 one day...
|
|
type genericManifest interface {
|
|
serialize() ([]byte, error)
|
|
manifestMIMEType() string
|
|
// ConfigInfo returns a complete BlobInfo for the separate config object, or a BlobInfo{Digest:""} if there isn't a separate object.
|
|
// Note that the config object may not exist in the underlying storage in the return value of UpdatedImage! Use ConfigBlob() below.
|
|
ConfigInfo() types.BlobInfo
|
|
// ConfigBlob returns the blob described by ConfigInfo, iff ConfigInfo().Digest != ""; nil otherwise.
|
|
// The result is cached; it is OK to call this however often you need.
|
|
ConfigBlob() ([]byte, error)
|
|
// OCIConfig returns the image configuration as per OCI v1 image-spec. Information about
|
|
// layers in the resulting configuration isn't guaranteed to be returned to due how
|
|
// old image manifests work (docker v2s1 especially).
|
|
OCIConfig() (*imgspecv1.Image, error)
|
|
// LayerInfos returns a list of BlobInfos of layers referenced by this image, in order (the root layer first, and then successive layered layers).
|
|
// The Digest field is guaranteed to be provided; Size may be -1.
|
|
// WARNING: The list may contain duplicates, and they are semantically relevant.
|
|
LayerInfos() []types.BlobInfo
|
|
// EmbeddedDockerReferenceConflicts whether a Docker reference embedded in the manifest, if any, conflicts with destination ref.
|
|
// It returns false if the manifest does not embed a Docker reference.
|
|
// (This embedding unfortunately happens for Docker schema1, please do not add support for this in any new formats.)
|
|
EmbeddedDockerReferenceConflicts(ref reference.Named) bool
|
|
imageInspectInfo() (*types.ImageInspectInfo, error) // To be called by inspectManifest
|
|
// UpdatedImageNeedsLayerDiffIDs returns true iff UpdatedImage(options) needs InformationOnly.LayerDiffIDs.
|
|
// This is a horribly specific interface, but computing InformationOnly.LayerDiffIDs can be very expensive to compute
|
|
// (most importantly it forces us to download the full layers even if they are already present at the destination).
|
|
UpdatedImageNeedsLayerDiffIDs(options types.ManifestUpdateOptions) bool
|
|
// UpdatedImage returns a types.Image modified according to options.
|
|
// This does not change the state of the original Image object.
|
|
UpdatedImage(options types.ManifestUpdateOptions) (types.Image, error)
|
|
}
|
|
|
|
func manifestInstanceFromBlob(src types.ImageSource, manblob []byte, mt string) (genericManifest, error) {
|
|
switch mt {
|
|
// "application/json" is a valid v2s1 value per https://github.com/docker/distribution/blob/master/docs/spec/manifest-v2-1.md .
|
|
// This works for now, when nothing else seems to return "application/json"; if that were not true, the mapping/detection might
|
|
// need to happen within the ImageSource.
|
|
case manifest.DockerV2Schema1MediaType, manifest.DockerV2Schema1SignedMediaType, "application/json":
|
|
return manifestSchema1FromManifest(manblob)
|
|
case imgspecv1.MediaTypeImageManifest:
|
|
return manifestOCI1FromManifest(src, manblob)
|
|
case manifest.DockerV2Schema2MediaType:
|
|
return manifestSchema2FromManifest(src, manblob)
|
|
case manifest.DockerV2ListMediaType:
|
|
return manifestSchema2FromManifestList(src, manblob)
|
|
default:
|
|
// If it's not a recognized manifest media type, or we have failed determining the type, we'll try one last time
|
|
// to deserialize using v2s1 as per https://github.com/docker/distribution/blob/master/manifests.go#L108
|
|
// and https://github.com/docker/distribution/blob/master/manifest/schema1/manifest.go#L50
|
|
//
|
|
// Crane registries can also return "text/plain", or pretty much anything else depending on a file extension “recognized” in the tag.
|
|
// This makes no real sense, but it happens
|
|
// because requests for manifests are
|
|
// redirected to a content distribution
|
|
// network which is configured that way. See https://bugzilla.redhat.com/show_bug.cgi?id=1389442
|
|
return manifestSchema1FromManifest(manblob)
|
|
}
|
|
}
|
|
|
|
// inspectManifest is an implementation of types.Image.Inspect
|
|
func inspectManifest(m genericManifest) (*types.ImageInspectInfo, error) {
|
|
info, err := m.imageInspectInfo()
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
layers := m.LayerInfos()
|
|
info.Layers = make([]string, len(layers))
|
|
for i, layer := range layers {
|
|
info.Layers[i] = layer.Digest.String()
|
|
}
|
|
return info, nil
|
|
}
|