986f076276
Add a new generic container registry client via a new `container` package. Use this to create a command line utility as well as a new upload target for container registries. The code uses the github.com/containers/* project and packages to interact with container registires that is also used by skopeo, podman et al. One if the dependencies is `proglottis/gpgme` that is using cgo to bind libgpgme, so we have to add the corresponding devel package to the BuildRequires as well as installing it on CI. Checks will follow later via an integration test.
114 lines
4.5 KiB
Go
114 lines
4.5 KiB
Go
// Copyright 2016 The Linux Foundation
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
package v1
|
|
|
|
import (
|
|
"time"
|
|
|
|
digest "github.com/opencontainers/go-digest"
|
|
)
|
|
|
|
// ImageConfig defines the execution parameters which should be used as a base when running a container using an image.
|
|
type ImageConfig struct {
|
|
// User defines the username or UID which the process in the container should run as.
|
|
User string `json:"User,omitempty"`
|
|
|
|
// ExposedPorts a set of ports to expose from a container running this image.
|
|
ExposedPorts map[string]struct{} `json:"ExposedPorts,omitempty"`
|
|
|
|
// Env is a list of environment variables to be used in a container.
|
|
Env []string `json:"Env,omitempty"`
|
|
|
|
// Entrypoint defines a list of arguments to use as the command to execute when the container starts.
|
|
Entrypoint []string `json:"Entrypoint,omitempty"`
|
|
|
|
// Cmd defines the default arguments to the entrypoint of the container.
|
|
Cmd []string `json:"Cmd,omitempty"`
|
|
|
|
// Volumes is a set of directories describing where the process is likely write data specific to a container instance.
|
|
Volumes map[string]struct{} `json:"Volumes,omitempty"`
|
|
|
|
// WorkingDir sets the current working directory of the entrypoint process in the container.
|
|
WorkingDir string `json:"WorkingDir,omitempty"`
|
|
|
|
// Labels contains arbitrary metadata for the container.
|
|
Labels map[string]string `json:"Labels,omitempty"`
|
|
|
|
// StopSignal contains the system call signal that will be sent to the container to exit.
|
|
StopSignal string `json:"StopSignal,omitempty"`
|
|
}
|
|
|
|
// RootFS describes a layer content addresses
|
|
type RootFS struct {
|
|
// Type is the type of the rootfs.
|
|
Type string `json:"type"`
|
|
|
|
// DiffIDs is an array of layer content hashes (DiffIDs), in order from bottom-most to top-most.
|
|
DiffIDs []digest.Digest `json:"diff_ids"`
|
|
}
|
|
|
|
// History describes the history of a layer.
|
|
type History struct {
|
|
// Created is the combined date and time at which the layer was created, formatted as defined by RFC 3339, section 5.6.
|
|
Created *time.Time `json:"created,omitempty"`
|
|
|
|
// CreatedBy is the command which created the layer.
|
|
CreatedBy string `json:"created_by,omitempty"`
|
|
|
|
// Author is the author of the build point.
|
|
Author string `json:"author,omitempty"`
|
|
|
|
// Comment is a custom message set when creating the layer.
|
|
Comment string `json:"comment,omitempty"`
|
|
|
|
// EmptyLayer is used to mark if the history item created a filesystem diff.
|
|
EmptyLayer bool `json:"empty_layer,omitempty"`
|
|
}
|
|
|
|
// Image is the JSON structure which describes some basic information about the image.
|
|
// This provides the `application/vnd.oci.image.config.v1+json` mediatype when marshalled to JSON.
|
|
type Image struct {
|
|
// Created is the combined date and time at which the image was created, formatted as defined by RFC 3339, section 5.6.
|
|
Created *time.Time `json:"created,omitempty"`
|
|
|
|
// Author defines the name and/or email address of the person or entity which created and is responsible for maintaining the image.
|
|
Author string `json:"author,omitempty"`
|
|
|
|
// Architecture is the CPU architecture which the binaries in this image are built to run on.
|
|
Architecture string `json:"architecture"`
|
|
|
|
// Variant is the variant of the specified CPU architecture which image binaries are intended to run on.
|
|
Variant string `json:"variant,omitempty"`
|
|
|
|
// OS is the name of the operating system which the image is built to run on.
|
|
OS string `json:"os"`
|
|
|
|
// OSVersion is an optional field specifying the operating system
|
|
// version, for example on Windows `10.0.14393.1066`.
|
|
OSVersion string `json:"os.version,omitempty"`
|
|
|
|
// OSFeatures is an optional field specifying an array of strings,
|
|
// each listing a required OS feature (for example on Windows `win32k`).
|
|
OSFeatures []string `json:"os.features,omitempty"`
|
|
|
|
// Config defines the execution parameters which should be used as a base when running a container using the image.
|
|
Config ImageConfig `json:"config,omitempty"`
|
|
|
|
// RootFS references the layer content addresses used by the image.
|
|
RootFS RootFS `json:"rootfs"`
|
|
|
|
// History describes the history of each layer.
|
|
History []History `json:"history,omitempty"`
|
|
}
|