mirror of https://github.com/docker/docs.git
vendor: github.com/docker/cli v27.0.1
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com> Signed-off-by: Paweł Gronowski <pawel.gronowski@docker.com>
This commit is contained in:
parent
75a4367cd9
commit
ba7b34f16b
|
@ -50,7 +50,10 @@ The table below provides an overview of the current status of deprecated feature
|
||||||
|
|
||||||
| Status | Feature | Deprecated | Remove |
|
| Status | Feature | Deprecated | Remove |
|
||||||
|------------|------------------------------------------------------------------------------------------------------------------------------------|------------|--------|
|
|------------|------------------------------------------------------------------------------------------------------------------------------------|------------|--------|
|
||||||
| Deprecated | [Unauthenticated TCP connections](#unauthenticated-tcp-connections) | v26.0 | v27.0 |
|
| Deprecated | [Non-standard fields in image inspect](#non-standard-fields-in-image-inspect) | v27.0 | v28.0 |
|
||||||
|
| Deprecated | [API CORS headers](#api-cors-headers) | v27.0 | v28.0 |
|
||||||
|
| Deprecated | [Graphdriver plugins (experimental)](#graphdriver-plugins-experimental) | v27.0 | v28.0 |
|
||||||
|
| Deprecated | [Unauthenticated TCP connections](#unauthenticated-tcp-connections) | v26.0 | v28.0 |
|
||||||
| Deprecated | [`Container` and `ContainerConfig` fields in Image inspect](#container-and-containerconfig-fields-in-image-inspect) | v25.0 | v26.0 |
|
| Deprecated | [`Container` and `ContainerConfig` fields in Image inspect](#container-and-containerconfig-fields-in-image-inspect) | v25.0 | v26.0 |
|
||||||
| Deprecated | [Deprecate legacy API versions](#deprecate-legacy-api-versions) | v25.0 | v26.0 |
|
| Deprecated | [Deprecate legacy API versions](#deprecate-legacy-api-versions) | v25.0 | v26.0 |
|
||||||
| Removed | [Container short ID in network Aliases field](#container-short-id-in-network-aliases-field) | v25.0 | v26.0 |
|
| Removed | [Container short ID in network Aliases field](#container-short-id-in-network-aliases-field) | v25.0 | v26.0 |
|
||||||
|
@ -112,10 +115,86 @@ The table below provides an overview of the current status of deprecated feature
|
||||||
| Removed | [`--run` flag on `docker commit`](#--run-flag-on-docker-commit) | v0.10 | v1.13 |
|
| Removed | [`--run` flag on `docker commit`](#--run-flag-on-docker-commit) | v0.10 | v1.13 |
|
||||||
| Removed | [Three arguments form in `docker import`](#three-arguments-form-in-docker-import) | v0.6.7 | v1.12 |
|
| Removed | [Three arguments form in `docker import`](#three-arguments-form-in-docker-import) | v0.6.7 | v1.12 |
|
||||||
|
|
||||||
|
### Non-standard fields in image inspect
|
||||||
|
|
||||||
|
**Deprecated in Release: v27.0**
|
||||||
|
**Target For Removal In Release: v28.0**
|
||||||
|
|
||||||
|
The `Config` field returned shown in `docker image inspect` (and as returned by
|
||||||
|
the `GET /images/{name}/json` API endpoint) returns additional fields that are
|
||||||
|
not part of the image's configuration and not part of the [Docker Image Spec]
|
||||||
|
and [OCI Image Specification].
|
||||||
|
|
||||||
|
These fields are never set (and always return the default value for the type),
|
||||||
|
but are not omitted in the response when left empty. As these fields were not
|
||||||
|
intended to be part of the image configuration response, they are deprecated,
|
||||||
|
and will be removed from the API in thee next release.
|
||||||
|
|
||||||
|
The following fields are currently included in the API response, but are not
|
||||||
|
part of the underlying image's Config, and deprecated:
|
||||||
|
|
||||||
|
- `Hostname`
|
||||||
|
- `Domainname`
|
||||||
|
- `AttachStdin`
|
||||||
|
- `AttachStdout`
|
||||||
|
- `AttachStderr`
|
||||||
|
- `Tty`
|
||||||
|
- `OpenStdin`
|
||||||
|
- `StdinOnce`
|
||||||
|
- `Image`
|
||||||
|
- `NetworkDisabled` (already omitted unless set)
|
||||||
|
- `MacAddress` (already omitted unless set)
|
||||||
|
- `StopTimeout` (already omitted unless set)
|
||||||
|
|
||||||
|
[Docker image spec]: https://github.com/moby/docker-image-spec/blob/v1.3.1/specs-go/v1/image.go#L19-L32
|
||||||
|
[OCI Image Spec]: https://github.com/opencontainers/image-spec/blob/v1.1.0/specs-go/v1/config.go#L24-L62
|
||||||
|
|
||||||
|
### Graphdriver plugins (experimental)
|
||||||
|
|
||||||
|
**Deprecated in Release: v27.0**
|
||||||
|
**Disabled by default in Release: v27.0**
|
||||||
|
**Target For Removal In Release: v28.0**
|
||||||
|
|
||||||
|
[Graphdriver plugins](https://github.com/docker/cli/blob/v26.1.4/docs/extend/plugins_graphdriver.md)
|
||||||
|
are an experimental feature that allow extending the Docker Engine with custom
|
||||||
|
storage drivers for storing images and containers. This feature was not
|
||||||
|
maintained since its inception, and will no longer be supported in upcoming
|
||||||
|
releases.
|
||||||
|
|
||||||
|
Support for graphdriver plugins is disabled by default in v27.0, and will be
|
||||||
|
removed v28.0. An `DOCKERD_DEPRECATED_GRAPHDRIVER_PLUGINS` environment variable
|
||||||
|
is provided in v27.0 to re-enable the feature. This environment variable must
|
||||||
|
be set to a non-empty value in the daemon's environment.
|
||||||
|
|
||||||
|
The `DOCKERD_DEPRECATED_GRAPHDRIVER_PLUGINS` environment variable, along with
|
||||||
|
support for graphdriver plugins, will be removed in v28.0. Users of this feature
|
||||||
|
are recommended to instead configure the Docker Engine to use the [containerd image store](https://docs.docker.com/storage/containerd/)
|
||||||
|
and a custom [snapshotter](https://github.com/containerd/containerd/tree/v1.7.18/docs/snapshotters)
|
||||||
|
|
||||||
|
### API CORS headers
|
||||||
|
|
||||||
|
**Deprecated in Release: v27.0**
|
||||||
|
**Target For Removal In Release: v28.0**
|
||||||
|
|
||||||
|
The `api-cors-header` configuration option for the Docker daemon is insecure,
|
||||||
|
and is therefore deprecated and scheduled for removal.
|
||||||
|
Incorrectly setting this option could leave a window of opportunity
|
||||||
|
for unauthenticated cross-origin requests to be accepted by the daemon.
|
||||||
|
|
||||||
|
Starting in Docker Engine v27.0, this flag can still be set,
|
||||||
|
but it has no effect unless the environment variable
|
||||||
|
`DOCKERD_DEPRECATED_CORS_HEADER` is also set to a non-empty value.
|
||||||
|
|
||||||
|
This flag will be removed altogether in v28.0.
|
||||||
|
|
||||||
|
This is a breaking change for authorization plugins and other programs
|
||||||
|
that depend on this option for accessing the Docker API from a browser.
|
||||||
|
If you need to access the API through a browser, use a reverse proxy.
|
||||||
|
|
||||||
### Unauthenticated TCP connections
|
### Unauthenticated TCP connections
|
||||||
|
|
||||||
**Deprecated in Release: v26.0**
|
**Deprecated in Release: v26.0**
|
||||||
**Target For Removal In Release: v27.0**
|
**Target For Removal In Release: v28.0**
|
||||||
|
|
||||||
Configuring the Docker daemon to listen on a TCP address will require mandatory
|
Configuring the Docker daemon to listen on a TCP address will require mandatory
|
||||||
TLS verification. This change aims to ensure secure communication by preventing
|
TLS verification. This change aims to ensure secure communication by preventing
|
||||||
|
@ -188,7 +267,8 @@ CLI to use API version 1.23, which produces an error:
|
||||||
|
|
||||||
```console
|
```console
|
||||||
DOCKER_API_VERSION=1.23 docker version
|
DOCKER_API_VERSION=1.23 docker version
|
||||||
Error response from daemon: client version 1.23 is too old. Minimum supported API version is 1.24, please upgrade your client to a newer version
|
Error response from daemon: client version 1.23 is too old. Minimum supported API version is 1.24,
|
||||||
|
upgrade your client to a newer version
|
||||||
```
|
```
|
||||||
|
|
||||||
An environment variable (`DOCKER_MIN_API_VERSION`) is introduced that allows
|
An environment variable (`DOCKER_MIN_API_VERSION`) is introduced that allows
|
||||||
|
@ -590,7 +670,7 @@ The `--log-opt fluentd-async-connect` option for the fluentd logging driver is
|
||||||
A deprecation message is logged in the daemon logs if the old option is used:
|
A deprecation message is logged in the daemon logs if the old option is used:
|
||||||
|
|
||||||
```console
|
```console
|
||||||
fluent#New: AsyncConnect is now deprecated, please use Async instead
|
fluent#New: AsyncConnect is now deprecated, use Async instead
|
||||||
```
|
```
|
||||||
|
|
||||||
Users are encouraged to use the `fluentd-async` option going forward, as support
|
Users are encouraged to use the `fluentd-async` option going forward, as support
|
||||||
|
@ -627,7 +707,7 @@ An environment variable (`DOCKER_ENABLE_DEPRECATED_PULL_SCHEMA_1_IMAGE`) is
|
||||||
added in Docker v26.0 that allows re-enabling support for these image formats
|
added in Docker v26.0 that allows re-enabling support for these image formats
|
||||||
in the daemon. This environment variable must be set to a non-empty value in
|
in the daemon. This environment variable must be set to a non-empty value in
|
||||||
the daemon's environment (for example, through a [systemd override file](https://docs.docker.com/config/daemon/systemd/)).
|
the daemon's environment (for example, through a [systemd override file](https://docs.docker.com/config/daemon/systemd/)).
|
||||||
Support for the `DOCKER_ENABLE_DEPRECATED_PULL_SCHEMA_1_IMAGE` environment-variable
|
Support for the `DOCKER_ENABLE_DEPRECATED_PULL_SCHEMA_1_IMAGE` environment variable
|
||||||
will be removed in Docker v27.0 after which this functionality is removed permanently.
|
will be removed in Docker v27.0 after which this functionality is removed permanently.
|
||||||
|
|
||||||
### `docker engine` subcommands
|
### `docker engine` subcommands
|
||||||
|
|
|
@ -122,7 +122,7 @@ We have to put the following JSON to `$TMPDIR/config.json`:
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
Please note a couple of points:
|
Note a couple of points:
|
||||||
- `PropagatedMount` is needed so that the docker daemon can see mounts done by the
|
- `PropagatedMount` is needed so that the docker daemon can see mounts done by the
|
||||||
rexray plugin from within the container, otherwise the docker daemon is not able
|
rexray plugin from within the container, otherwise the docker daemon is not able
|
||||||
to mount a docker volume.
|
to mount a docker volume.
|
||||||
|
|
|
@ -2,6 +2,8 @@
|
||||||
title: Docker Engine managed plugin system
|
title: Docker Engine managed plugin system
|
||||||
description: Develop and use a plugin with the managed plugin system
|
description: Develop and use a plugin with the managed plugin system
|
||||||
keywords: "API, Usage, plugins, documentation, developer"
|
keywords: "API, Usage, plugins, documentation, developer"
|
||||||
|
aliases:
|
||||||
|
- "/engine/extend/plugins_graphdriver/"
|
||||||
---
|
---
|
||||||
|
|
||||||
- [Installing and using a plugin](index.md#installing-and-using-a-plugin)
|
- [Installing and using a plugin](index.md#installing-and-using-a-plugin)
|
||||||
|
|
|
@ -1,401 +0,0 @@
|
||||||
---
|
|
||||||
description: "How to manage image and container filesystems with external plugins"
|
|
||||||
keywords: "Examples, Usage, storage, image, docker, data, graph, plugin, api"
|
|
||||||
advisory: experimental
|
|
||||||
---
|
|
||||||
|
|
||||||
<!-- This file is maintained within the docker/cli GitHub
|
|
||||||
repository at https://github.com/docker/cli/. Make all
|
|
||||||
pull requests against that repo. If you see this file in
|
|
||||||
another repository, consider it read-only there, as it will
|
|
||||||
periodically be overwritten by the definitive file. Pull
|
|
||||||
requests which include edits to this file in other repositories
|
|
||||||
will be rejected.
|
|
||||||
-->
|
|
||||||
|
|
||||||
# Graphdriver plugins
|
|
||||||
|
|
||||||
## Changelog
|
|
||||||
|
|
||||||
### 1.13.0
|
|
||||||
|
|
||||||
- Support v2 plugins
|
|
||||||
|
|
||||||
# Docker graph driver plugins
|
|
||||||
|
|
||||||
Docker graph driver plugins enable admins to use an external/out-of-process
|
|
||||||
graph driver for use with Docker engine. This is an alternative to using the
|
|
||||||
built-in storage drivers, such as overlay2.
|
|
||||||
|
|
||||||
You need to install and enable the plugin and then restart the Docker daemon
|
|
||||||
before using the plugin. See the following example for the correct ordering
|
|
||||||
of steps.
|
|
||||||
|
|
||||||
```console
|
|
||||||
$ docker plugin install cpuguy83/docker-overlay2-graphdriver-plugin # this command also enables the driver
|
|
||||||
<output suppressed>
|
|
||||||
$ pkill dockerd
|
|
||||||
$ dockerd --experimental -s cpuguy83/docker-overlay2-graphdriver-plugin
|
|
||||||
```
|
|
||||||
|
|
||||||
# Write a graph driver plugin
|
|
||||||
|
|
||||||
See the [plugin documentation](https://docs.docker.com/engine/extend/) for detailed information
|
|
||||||
on the underlying plugin protocol.
|
|
||||||
|
|
||||||
|
|
||||||
## Graph Driver plugin protocol
|
|
||||||
|
|
||||||
If a plugin registers itself as a `GraphDriver` when activated, then it is
|
|
||||||
expected to provide the rootfs for containers as well as image layer storage.
|
|
||||||
|
|
||||||
### /GraphDriver.Init
|
|
||||||
|
|
||||||
**Request**:
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"Home": "/graph/home/path",
|
|
||||||
"Opts": [],
|
|
||||||
"UIDMaps": [],
|
|
||||||
"GIDMaps": []
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Initialize the graph driver plugin with a home directory and array of options.
|
|
||||||
These are passed through from the user, but the plugin is not required to parse
|
|
||||||
or honor them.
|
|
||||||
|
|
||||||
The request also includes a list of UID and GID mappings, structed as follows:
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"ContainerID": 0,
|
|
||||||
"HostID": 0,
|
|
||||||
"Size": 0
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
**Response**:
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"Err": ""
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Respond with a non-empty string error if an error occurred.
|
|
||||||
|
|
||||||
|
|
||||||
### /GraphDriver.Capabilities
|
|
||||||
|
|
||||||
**Request**:
|
|
||||||
```json
|
|
||||||
{}
|
|
||||||
```
|
|
||||||
|
|
||||||
Get behavioral characteristics of the graph driver. If a plugin does not handle
|
|
||||||
this request, the engine will use default values for all capabilities.
|
|
||||||
|
|
||||||
**Response**:
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"ReproducesExactDiffs": false,
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Respond with values of capabilities:
|
|
||||||
|
|
||||||
* **ReproducesExactDiffs** Defaults to false. Flags that this driver is capable
|
|
||||||
of reproducing exactly equivalent diffs for read-only filesystem layers.
|
|
||||||
|
|
||||||
|
|
||||||
### /GraphDriver.Create
|
|
||||||
|
|
||||||
**Request**:
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"ID": "46fe8644f2572fd1e505364f7581e0c9dbc7f14640bd1fb6ce97714fb6fc5187",
|
|
||||||
"Parent": "2cd9c322cb78a55e8212aa3ea8425a4180236d7106938ec921d0935a4b8ca142",
|
|
||||||
"MountLabel": "",
|
|
||||||
"StorageOpt": {}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Create a new, empty, read-only filesystem layer with the specified
|
|
||||||
`ID`, `Parent` and `MountLabel`. If `Parent` is an empty string, there is no
|
|
||||||
parent layer. `StorageOpt` is map of strings which indicate storage options.
|
|
||||||
|
|
||||||
**Response**:
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"Err": ""
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Respond with a non-empty string error if an error occurred.
|
|
||||||
|
|
||||||
### /GraphDriver.CreateReadWrite
|
|
||||||
|
|
||||||
**Request**:
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"ID": "46fe8644f2572fd1e505364f7581e0c9dbc7f14640bd1fb6ce97714fb6fc5187",
|
|
||||||
"Parent": "2cd9c322cb78a55e8212aa3ea8425a4180236d7106938ec921d0935a4b8ca142",
|
|
||||||
"MountLabel": "",
|
|
||||||
"StorageOpt": {}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Similar to `/GraphDriver.Create` but creates a read-write filesystem layer.
|
|
||||||
|
|
||||||
### /GraphDriver.Remove
|
|
||||||
|
|
||||||
**Request**:
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"ID": "46fe8644f2572fd1e505364f7581e0c9dbc7f14640bd1fb6ce97714fb6fc5187"
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Remove the filesystem layer with this given `ID`.
|
|
||||||
|
|
||||||
**Response**:
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"Err": ""
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Respond with a non-empty string error if an error occurred.
|
|
||||||
|
|
||||||
### /GraphDriver.Get
|
|
||||||
|
|
||||||
**Request**:
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"ID": "46fe8644f2572fd1e505364f7581e0c9dbc7f14640bd1fb6ce97714fb6fc5187",
|
|
||||||
"MountLabel": ""
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Get the mountpoint for the layered filesystem referred to by the given `ID`.
|
|
||||||
|
|
||||||
**Response**:
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"Dir": "/var/mygraph/46fe8644f2572fd1e505364f7581e0c9dbc7f14640bd1fb6ce97714fb6fc5187",
|
|
||||||
"Err": ""
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Respond with the absolute path to the mounted layered filesystem.
|
|
||||||
Respond with a non-empty string error if an error occurred.
|
|
||||||
|
|
||||||
### /GraphDriver.Put
|
|
||||||
|
|
||||||
**Request**:
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"ID": "46fe8644f2572fd1e505364f7581e0c9dbc7f14640bd1fb6ce97714fb6fc5187"
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Release the system resources for the specified `ID`, such as unmounting the
|
|
||||||
filesystem layer.
|
|
||||||
|
|
||||||
**Response**:
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"Err": ""
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Respond with a non-empty string error if an error occurred.
|
|
||||||
|
|
||||||
### /GraphDriver.Exists
|
|
||||||
|
|
||||||
**Request**:
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"ID": "46fe8644f2572fd1e505364f7581e0c9dbc7f14640bd1fb6ce97714fb6fc5187"
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Determine if a filesystem layer with the specified `ID` exists.
|
|
||||||
|
|
||||||
**Response**:
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"Exists": true
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Respond with a boolean for whether or not the filesystem layer with the specified
|
|
||||||
`ID` exists.
|
|
||||||
|
|
||||||
### /GraphDriver.Status
|
|
||||||
|
|
||||||
**Request**:
|
|
||||||
```json
|
|
||||||
{}
|
|
||||||
```
|
|
||||||
|
|
||||||
Get low-level diagnostic information about the graph driver.
|
|
||||||
|
|
||||||
**Response**:
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"Status": [[]]
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Respond with a 2-D array with key/value pairs for the underlying status
|
|
||||||
information.
|
|
||||||
|
|
||||||
|
|
||||||
### /GraphDriver.GetMetadata
|
|
||||||
|
|
||||||
**Request**:
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"ID": "46fe8644f2572fd1e505364f7581e0c9dbc7f14640bd1fb6ce97714fb6fc5187"
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Get low-level diagnostic information about the layered filesystem with the
|
|
||||||
with the specified `ID`
|
|
||||||
|
|
||||||
**Response**:
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"Metadata": {},
|
|
||||||
"Err": ""
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Respond with a set of key/value pairs containing the low-level diagnostic
|
|
||||||
information about the layered filesystem.
|
|
||||||
Respond with a non-empty string error if an error occurred.
|
|
||||||
|
|
||||||
### /GraphDriver.Cleanup
|
|
||||||
|
|
||||||
**Request**:
|
|
||||||
```json
|
|
||||||
{}
|
|
||||||
```
|
|
||||||
|
|
||||||
Perform necessary tasks to release resources help by the plugin, such as
|
|
||||||
unmounting all the layered file systems.
|
|
||||||
|
|
||||||
**Response**:
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"Err": ""
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Respond with a non-empty string error if an error occurred.
|
|
||||||
|
|
||||||
|
|
||||||
### /GraphDriver.Diff
|
|
||||||
|
|
||||||
**Request**:
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"ID": "46fe8644f2572fd1e505364f7581e0c9dbc7f14640bd1fb6ce97714fb6fc5187",
|
|
||||||
"Parent": "2cd9c322cb78a55e8212aa3ea8425a4180236d7106938ec921d0935a4b8ca142"
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Get an archive of the changes between the filesystem layers specified by the `ID`
|
|
||||||
and `Parent`. `Parent` may be an empty string, in which case there is no parent.
|
|
||||||
|
|
||||||
**Response**:
|
|
||||||
|
|
||||||
```
|
|
||||||
{{ TAR STREAM }}
|
|
||||||
```
|
|
||||||
|
|
||||||
### /GraphDriver.Changes
|
|
||||||
|
|
||||||
**Request**:
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"ID": "46fe8644f2572fd1e505364f7581e0c9dbc7f14640bd1fb6ce97714fb6fc5187",
|
|
||||||
"Parent": "2cd9c322cb78a55e8212aa3ea8425a4180236d7106938ec921d0935a4b8ca142"
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Get a list of changes between the filesystem layers specified by the `ID` and
|
|
||||||
`Parent`. If `Parent` is an empty string, there is no parent.
|
|
||||||
|
|
||||||
**Response**:
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"Changes": [{}],
|
|
||||||
"Err": ""
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Respond with a list of changes. The structure of a change is:
|
|
||||||
```json
|
|
||||||
"Path": "/some/path",
|
|
||||||
"Kind": 0,
|
|
||||||
```
|
|
||||||
|
|
||||||
Where the `Path` is the filesystem path within the layered filesystem that is
|
|
||||||
changed and `Kind` is an integer specifying the type of change that occurred:
|
|
||||||
|
|
||||||
- 0 - Modified
|
|
||||||
- 1 - Added
|
|
||||||
- 2 - Deleted
|
|
||||||
|
|
||||||
Respond with a non-empty string error if an error occurred.
|
|
||||||
|
|
||||||
### /GraphDriver.ApplyDiff
|
|
||||||
|
|
||||||
**Request**:
|
|
||||||
|
|
||||||
```
|
|
||||||
{{ TAR STREAM }}
|
|
||||||
```
|
|
||||||
|
|
||||||
Extract the changeset from the given diff into the layer with the specified `ID`
|
|
||||||
and `Parent`
|
|
||||||
|
|
||||||
**Query Parameters**:
|
|
||||||
|
|
||||||
- id (required)- the `ID` of the new filesystem layer to extract the diff to
|
|
||||||
- parent (required)- the `Parent` of the given `ID`
|
|
||||||
|
|
||||||
**Response**:
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"Size": 512366,
|
|
||||||
"Err": ""
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Respond with the size of the new layer in bytes.
|
|
||||||
Respond with a non-empty string error if an error occurred.
|
|
||||||
|
|
||||||
### /GraphDriver.DiffSize
|
|
||||||
|
|
||||||
**Request**:
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"ID": "46fe8644f2572fd1e505364f7581e0c9dbc7f14640bd1fb6ce97714fb6fc5187",
|
|
||||||
"Parent": "2cd9c322cb78a55e8212aa3ea8425a4180236d7106938ec921d0935a4b8ca142"
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Calculate the changes between the specified `ID`
|
|
||||||
|
|
||||||
**Response**:
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"Size": 512366,
|
|
||||||
"Err": ""
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Respond with the size changes between the specified `ID` and `Parent`
|
|
||||||
Respond with a non-empty string error if an error occurred.
|
|
|
@ -530,7 +530,7 @@ For example:
|
||||||
"runtimeType": "io.containerd.runsc.v1",
|
"runtimeType": "io.containerd.runsc.v1",
|
||||||
"options": {
|
"options": {
|
||||||
"TypeUrl": "io.containerd.runsc.v1.options",
|
"TypeUrl": "io.containerd.runsc.v1.options",
|
||||||
"ConfigPath": "/etc/containerd/runsc.toml",
|
"ConfigPath": "/etc/containerd/runsc.toml"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
|
@ -1,6 +1,6 @@
|
||||||
# github.com/moby/moby v27.0.1+incompatible
|
# github.com/moby/moby v27.0.1+incompatible
|
||||||
# github.com/moby/buildkit v0.14.1
|
# github.com/moby/buildkit v0.14.1
|
||||||
# github.com/docker/buildx v0.15.1
|
# github.com/docker/buildx v0.15.1
|
||||||
# github.com/docker/cli v27.0.1-rc.1+incompatible
|
# github.com/docker/cli v27.0.1+incompatible
|
||||||
# github.com/docker/compose/v2 v2.28.1
|
# github.com/docker/compose/v2 v2.28.1
|
||||||
# github.com/docker/scout-cli v1.9.3
|
# github.com/docker/scout-cli v1.9.3
|
||||||
|
|
2
go.mod
2
go.mod
|
@ -15,7 +15,7 @@ require (
|
||||||
|
|
||||||
replace (
|
replace (
|
||||||
github.com/docker/buildx => github.com/docker/buildx v0.15.1
|
github.com/docker/buildx => github.com/docker/buildx v0.15.1
|
||||||
github.com/docker/cli => github.com/docker/cli v26.1.3-0.20240513184838-60f2d38d5341+incompatible
|
github.com/docker/cli => github.com/docker/cli v27.0.1+incompatible
|
||||||
github.com/docker/compose/v2 => github.com/docker/compose/v2 v2.28.1
|
github.com/docker/compose/v2 => github.com/docker/compose/v2 v2.28.1
|
||||||
github.com/docker/scout-cli => github.com/docker/scout-cli v1.9.3
|
github.com/docker/scout-cli => github.com/docker/scout-cli v1.9.3
|
||||||
github.com/moby/buildkit => github.com/moby/buildkit v0.14.0-rc2.0.20240611065153-eed17a45c62b
|
github.com/moby/buildkit => github.com/moby/buildkit v0.14.0-rc2.0.20240611065153-eed17a45c62b
|
||||||
|
|
2
go.sum
2
go.sum
|
@ -106,6 +106,8 @@ github.com/docker/cli v26.1.0+incompatible h1:+nwRy8Ocd8cYNQ60mozDDICICD8aoFGtlP
|
||||||
github.com/docker/cli v26.1.0+incompatible/go.mod h1:JLrzqnKDaYBop7H2jaqPtU4hHvMKP+vjCwu2uszcLI8=
|
github.com/docker/cli v26.1.0+incompatible/go.mod h1:JLrzqnKDaYBop7H2jaqPtU4hHvMKP+vjCwu2uszcLI8=
|
||||||
github.com/docker/cli v26.1.3-0.20240513184838-60f2d38d5341+incompatible h1:9bTMRZTbwJvSrosCeCWS9o9cxtBxxpwOiwlrJZwSWb8=
|
github.com/docker/cli v26.1.3-0.20240513184838-60f2d38d5341+incompatible h1:9bTMRZTbwJvSrosCeCWS9o9cxtBxxpwOiwlrJZwSWb8=
|
||||||
github.com/docker/cli v26.1.3-0.20240513184838-60f2d38d5341+incompatible/go.mod h1:JLrzqnKDaYBop7H2jaqPtU4hHvMKP+vjCwu2uszcLI8=
|
github.com/docker/cli v26.1.3-0.20240513184838-60f2d38d5341+incompatible/go.mod h1:JLrzqnKDaYBop7H2jaqPtU4hHvMKP+vjCwu2uszcLI8=
|
||||||
|
github.com/docker/cli v27.0.1+incompatible h1:d/OrlblkOTkhJ1IaAGD1bLgUBtFQC/oP0VjkFMIN+B0=
|
||||||
|
github.com/docker/cli v27.0.1+incompatible/go.mod h1:JLrzqnKDaYBop7H2jaqPtU4hHvMKP+vjCwu2uszcLI8=
|
||||||
github.com/docker/compose-cli v1.0.35 h1:uZyEHLalfqBS2PiTpA1LAULyJmuQ+YtZg7nG4Xl3/Cc=
|
github.com/docker/compose-cli v1.0.35 h1:uZyEHLalfqBS2PiTpA1LAULyJmuQ+YtZg7nG4Xl3/Cc=
|
||||||
github.com/docker/compose-cli v1.0.35/go.mod h1:mSXI4hFLpRU3EtI8NTo32bNwI0UXSr8jnq+/rYjGAUU=
|
github.com/docker/compose-cli v1.0.35/go.mod h1:mSXI4hFLpRU3EtI8NTo32bNwI0UXSr8jnq+/rYjGAUU=
|
||||||
github.com/docker/compose/v2 v2.22.0 h1:3rRz4L7tPU75wRsV8JZh2/aTgerQvPa1cpzZN+tHqUY=
|
github.com/docker/compose/v2 v2.22.0 h1:3rRz4L7tPU75wRsV8JZh2/aTgerQvPa1cpzZN+tHqUY=
|
||||||
|
|
Loading…
Reference in New Issue