f7d31e2be4
To allow for updating extensions without collisions, we have moved to using a map type that can be explicitly selected via the field path for updates. This ensures that multiple parties can operate on their extensions without stepping on each other's toes or incurring an inordinate number of round trips. Signed-off-by: Stephen J Day <stephen.day@docker.com>
91 lines
2.6 KiB
Go
91 lines
2.6 KiB
Go
package containers
|
|
|
|
import (
|
|
"context"
|
|
"time"
|
|
|
|
"github.com/gogo/protobuf/types"
|
|
)
|
|
|
|
// Container represents the set of data pinned by a container. Unless otherwise
|
|
// noted, the resources here are considered in use by the container.
|
|
//
|
|
// The resources specified in this object are used to create tasks from the container.
|
|
type Container struct {
|
|
// ID uniquely identifies the container in a nameapace.
|
|
//
|
|
// This property is required and cannot be changed after creation.
|
|
ID string
|
|
|
|
// Labels provide metadata extension for a contaienr.
|
|
//
|
|
// These are optional and fully mutable.
|
|
Labels map[string]string
|
|
|
|
// Image specifies the image reference used for a container.
|
|
//
|
|
// This property is optional but immutable.
|
|
Image string
|
|
|
|
// Runtime specifies which runtime should be used when launching container
|
|
// tasks.
|
|
//
|
|
// This property is required and immutable.
|
|
Runtime RuntimeInfo
|
|
|
|
// Spec should carry the the runtime specification used to implement the
|
|
// container.
|
|
//
|
|
// This field is required but mutable.
|
|
Spec *types.Any
|
|
|
|
// SnapshotKey specifies the snapshot key to use for the container's root
|
|
// filesystem. When starting a task from this container, a caller should
|
|
// look up the mounts from the snapshot service and include those on the
|
|
// task create request.
|
|
//
|
|
// This field is not required but immutable.
|
|
SnapshotKey string
|
|
|
|
// Snapshotter specifies the snapshotter name used for rootfs
|
|
//
|
|
// This field is not required but immutable.
|
|
Snapshotter string
|
|
|
|
// CreatedAt is the time at which the container was created.
|
|
CreatedAt time.Time
|
|
|
|
// UpdatedAt is the time at which the container was updated.
|
|
UpdatedAt time.Time
|
|
|
|
// Extensions stores client-specified metadata
|
|
Extensions map[string]types.Any
|
|
}
|
|
|
|
type RuntimeInfo struct {
|
|
Name string
|
|
Options *types.Any
|
|
}
|
|
|
|
type Store interface {
|
|
Get(ctx context.Context, id string) (Container, error)
|
|
|
|
// List returns containers that match one or more of the provided filters.
|
|
List(ctx context.Context, filters ...string) ([]Container, error)
|
|
|
|
// Create a container in the store from the provided container.
|
|
Create(ctx context.Context, container Container) (Container, error)
|
|
|
|
// Update the container with the provided container object. ID must be set.
|
|
//
|
|
// If one or more fieldpaths are provided, only the field corresponding to
|
|
// the fieldpaths will be mutated.
|
|
Update(ctx context.Context, container Container, fieldpaths ...string) (Container, error)
|
|
|
|
// Delete a container using the id.
|
|
//
|
|
// nil will be returned on success. If the container is not known to the
|
|
// store, ErrNotFound will be returned.
|
|
Delete(ctx context.Context, id string) error
|
|
}
|