api/services/instrospection: add PluginInfo
The new `PlunginInfo()` call can be used for instrospecting the details
of the runtime plugin.
```console
$ ctr plugins inspect-runtime --runtime=io.containerd.runc.v2 --runc-binary=runc
{
"Name": "io.containerd.runc.v2",
"Version": {
"Version": "v2.0.0-beta.0-XX-gXXXXXXXXX.m",
"Revision": "v2.0.0-beta.0-XX-gXXXXXXXXX.m"
},
"Options": {
"binary_name": "runc"
},
"Features": {
"ociVersionMin": "1.0.0",
"ociVersionMax": "1.1.0-rc.2",
...,
},
"Annotations": null
}
```
The shim binary has to support `-info` flag, see `runtime/v2/README.md`
Replaces PR 8509 (`api/services/task: add RuntimeInfo()`)
Co-authored-by: Derek McGowan <derek@mcg.dev>
Signed-off-by: Akihiro Suda <akihiro.suda.cz@hco.ntt.co.jp>
This commit is contained in:
@@ -243,6 +243,29 @@ The delete command MUST accept the following flags:
|
||||
|
||||
The delete command will be executed in the container's bundle as its `cwd` except for on Windows and FreeBSD platforms.
|
||||
|
||||
### Command-like flags
|
||||
#### `-v`
|
||||
Each shim SHOULD implement a `-v` flag.
|
||||
This command-like flag prints the shim implementation version and exits.
|
||||
The output is not machine-parsable.
|
||||
|
||||
#### `-info`
|
||||
Each shim SHOULD implement a `-info` flag.
|
||||
This command-like flag gets the option protobuf from stdin, prints the shim info protobuf (see below) to stdout, and exits.
|
||||
|
||||
```proto
|
||||
message RuntimeInfo {
|
||||
string name = 1;
|
||||
RuntimeVersion version = 2;
|
||||
// Options from stdin
|
||||
google.protobuf.Any options = 3;
|
||||
// OCI-compatible runtimes should use https://github.com/opencontainers/runtime-spec/blob/main/features.md
|
||||
google.protobuf.Any features = 4;
|
||||
// Annotations of the shim. Irrelevant to features.Annotations.
|
||||
map<string, string> annotations = 5;
|
||||
}
|
||||
```
|
||||
|
||||
### Host Level Shim Configuration
|
||||
|
||||
containerd does not provide any host level configuration for shims via the API.
|
||||
|
||||
Reference in New Issue
Block a user