2017-07-17 13:48:22 +00:00
|
|
|
% kpod(1) kpod - Simple management tool for pods and images
|
2016-12-02 15:15:15 +00:00
|
|
|
% Dan Walsh
|
2017-07-17 13:48:22 +00:00
|
|
|
# kpod "1" "September 2016" "kpod"
|
|
|
|
## NAME
|
|
|
|
kpod - Simple management tool for containers and images
|
2016-12-02 15:15:15 +00:00
|
|
|
|
2017-07-17 13:48:22 +00:00
|
|
|
## SYNOPSIS
|
2017-08-10 17:58:29 +00:00
|
|
|
**kpod** [*options*] COMMAND
|
2016-12-02 15:15:15 +00:00
|
|
|
|
|
|
|
# DESCRIPTION
|
|
|
|
kpod is a simple client only tool to help with debugging issues when daemons
|
|
|
|
such as CRI runtime and the kubelet are not responding or failing. A shared API
|
|
|
|
layer could be created to share code between the daemon and kpod. kpod does not
|
|
|
|
require any daemon running. kpod utilizes the same underlying components that
|
2017-05-12 13:36:15 +00:00
|
|
|
crio uses i.e. containers/image, container/storage, oci-runtime-tool/generate,
|
|
|
|
runc or any other OCI compatible runtime. kpod shares state with crio and so
|
|
|
|
has the capability to debug pods/images created by crio.
|
2016-12-02 15:15:15 +00:00
|
|
|
|
|
|
|
**kpod [GLOBAL OPTIONS]**
|
|
|
|
|
2017-07-17 13:48:22 +00:00
|
|
|
## GLOBAL OPTIONS
|
2016-12-02 15:15:15 +00:00
|
|
|
|
|
|
|
**--help, -h**
|
|
|
|
Print usage statement
|
|
|
|
|
2017-08-10 17:58:29 +00:00
|
|
|
**--config value, -c**=**"config.file"**
|
|
|
|
Path of a config file detailing container server configuration options
|
|
|
|
|
|
|
|
**--debug**
|
|
|
|
Print debugging information
|
|
|
|
|
|
|
|
**--root**=**value**
|
|
|
|
Path to the root directory in which data, including images, is stored
|
|
|
|
|
|
|
|
**--runroot**=**value**
|
|
|
|
Path to the 'run directory' where all state information is stored
|
|
|
|
|
2017-08-14 17:30:24 +00:00
|
|
|
**--runtime**=**value**
|
2017-08-30 20:03:26 +00:00
|
|
|
Path to the OCI compatible binary used to run containers
|
2017-08-14 17:30:24 +00:00
|
|
|
|
2017-08-10 17:58:29 +00:00
|
|
|
**--storage-driver, -s**=**value**
|
|
|
|
Select which storage driver is used to manage storage of images and containers (default is overlay)
|
|
|
|
|
|
|
|
**--storage-opt**=**value**
|
|
|
|
Used to pass an option to the storage driver
|
|
|
|
|
2016-12-02 15:15:15 +00:00
|
|
|
**--version, -v**
|
|
|
|
Print the version
|
|
|
|
|
2017-07-17 13:48:22 +00:00
|
|
|
## COMMANDS
|
2016-12-02 15:15:15 +00:00
|
|
|
|
2017-08-13 10:35:20 +00:00
|
|
|
### diff
|
|
|
|
Inspect changes on a container or image's filesystem
|
|
|
|
|
|
|
|
### export
|
|
|
|
Export container's filesystem contents as a tar archive
|
|
|
|
|
|
|
|
### history
|
|
|
|
Shows the history of an image
|
|
|
|
|
2017-07-17 13:48:22 +00:00
|
|
|
### images
|
2017-06-16 17:24:00 +00:00
|
|
|
List images in local storage
|
|
|
|
|
2017-08-13 10:35:20 +00:00
|
|
|
### info
|
|
|
|
Displays system information
|
|
|
|
|
|
|
|
### inspect
|
|
|
|
Display a container or image's configuration
|
|
|
|
|
2017-09-13 20:56:27 +00:00
|
|
|
### kill
|
|
|
|
Kill the main process in one or more containers
|
|
|
|
|
2017-08-13 10:35:20 +00:00
|
|
|
### load
|
|
|
|
Load an image from docker archive
|
|
|
|
|
2017-08-17 19:12:24 +00:00
|
|
|
### logs
|
|
|
|
Display the logs of a container
|
|
|
|
|
2017-08-13 10:35:20 +00:00
|
|
|
### mount
|
|
|
|
Mount a working container's root filesystem
|
|
|
|
|
2017-08-21 16:23:54 +00:00
|
|
|
### ps
|
|
|
|
Prints out information about containers
|
|
|
|
|
2017-08-13 10:35:20 +00:00
|
|
|
### pull
|
|
|
|
Pull an image from a registry
|
|
|
|
|
|
|
|
### push
|
|
|
|
Push an image from local storage to elsewhere
|
|
|
|
|
2017-08-14 17:30:24 +00:00
|
|
|
### rename
|
|
|
|
Rename a container
|
|
|
|
|
2017-08-30 20:03:26 +00:00
|
|
|
### rm
|
|
|
|
Remove one or more containers
|
|
|
|
|
2017-07-17 13:48:22 +00:00
|
|
|
### rmi
|
2017-06-16 17:24:00 +00:00
|
|
|
Removes one or more locally stored images
|
|
|
|
|
2017-08-13 10:35:20 +00:00
|
|
|
### save
|
|
|
|
Save an image to docker-archive or oci
|
|
|
|
|
2017-08-17 19:12:24 +00:00
|
|
|
### stats
|
|
|
|
Display a live stream of one or more containers' resource usage statistics
|
|
|
|
|
2017-09-06 17:30:34 +00:00
|
|
|
### stop
|
|
|
|
Stops one or more running containers.
|
|
|
|
|
2017-07-17 13:48:22 +00:00
|
|
|
### tag
|
2017-08-13 10:35:20 +00:00
|
|
|
Add an additional name to a local image
|
2017-06-27 13:45:25 +00:00
|
|
|
|
2017-08-13 10:35:20 +00:00
|
|
|
### umount
|
|
|
|
Unmount a working container's root file system
|
|
|
|
|
|
|
|
### version
|
|
|
|
Display the version information
|
kpod: info subcommand
Design: The output of the `info` subcommand ought to be directly
consumable in a format like JSON or yaml.
The structure being a map of sorts.
Each subsection of information being an individual cluster under the
top-level, like platform info, debug, storage, etc.
Even if there are errors under the top level key, the value will be a
map with the key of "error" and the value as the message of the
`err.Error()`. In this way, the command always returns usable output.
Ideally there will be a means for anything that can register info to do
so independently from it being in the single info.go, so this approach
is having a typed signature for the function that gives info, but i'm
sure it could be better.
Current iteration of this outputs the following as a limited user:
```yaml
host:
MemFree: 711307264
MemTotal: 2096222208
SwapFree: 2147479552
SwapTotal: 2147479552
arch: amd64
cpus: 1
os: linux
store:
error: 'mkdir /var/run/containers/storage: permission denied'
```
and as root (`sudo kpod info -D`):
```yaml
debug:
compiler: gc
go version: go1.7.6
goroutines: 3
host:
MemFree: 717795328
MemTotal: 2096222208
SwapFree: 2147479552
SwapTotal: 2147479552
arch: amd64
cpus: 1
os: linux
store:
ContainerStore:
number: 1
GraphDriverName: overlay2
GraphRoot: /var/lib/containers/storage
ImageStore:
number: 1
```
And with the `--json --debug` flag:
```json
{
"debug": {
"compiler": "gc",
"go version": "go1.7.6",
"goroutines": 3
},
"host": {
"MemFree": 709402624,
"MemTotal": 2096222208,
"SwapFree": 2147479552,
"SwapTotal": 2147479552,
"arch": "amd64",
"cpus": 1,
"os": "linux"
},
"store": {
"ContainerStore": {
"number": 1
},
"GraphDriverName": "overlay2",
"GraphRoot": "/var/lib/containers/storage",
"ImageStore": {
"number": 1
}
}
}
```
Signed-off-by: Vincent Batts <vbatts@hashbangbash.com>
2017-07-13 13:11:36 +00:00
|
|
|
|
2017-07-17 13:48:22 +00:00
|
|
|
## SEE ALSO
|
2017-05-12 13:36:15 +00:00
|
|
|
crio(8), crio.conf(5)
|
2016-12-02 15:15:15 +00:00
|
|
|
|
2017-07-17 13:48:22 +00:00
|
|
|
## HISTORY
|
2016-12-02 15:15:15 +00:00
|
|
|
Dec 2016, Originally compiled by Dan Walsh <dwalsh@redhat.com>
|