Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/genuinetools/riddler
A tool to convert docker inspect to the opencontainers runc spec.
https://github.com/genuinetools/riddler
cli docker linux oci opencontainers runc
Last synced: about 1 month ago
JSON representation
A tool to convert docker inspect to the opencontainers runc spec.
- Host: GitHub
- URL: https://github.com/genuinetools/riddler
- Owner: genuinetools
- License: mit
- Created: 2016-01-13T07:23:15.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2020-09-17T20:08:53.000Z (about 4 years ago)
- Last Synced: 2024-08-04T01:23:24.008Z (4 months ago)
- Topics: cli, docker, linux, oci, opencontainers, runc
- Language: Go
- Homepage:
- Size: 10.4 MB
- Stars: 251
- Watchers: 15
- Forks: 21
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# riddler
[](https://github.com/genuinetools/riddler/actions?query=workflow%3A%22make+all%22)
[](https://github.com/genuinetools/riddler/actions?query=workflow%3A%22make+image%22)
[](https://godoc.org/github.com/genuinetools/riddler)
[](https://github.com/genuinetools/riddler/releases)
A tool to convert `docker inspect` to the
[opencontainers/specs](https://github.com/opencontainers/specs)
and [opencontainers/runc](https://github.com/opencontainers/runc).
**Table of Contents**
- [NOTE](#note)
- [Installation](#installation)
- [Binaries](#binaries)
- [Via Go](#via-go)
- [Usage](#usage)
- [Installation](#installation-1)
- [TODO](#todo)
## NOTE
This project is no longer maintained. If you are using a version of
docker greater than 1.11 then you can just copy the config from
`/var/run/docker/libcontainerd` like so:
```console
$ docker ps -a
CONTAINER ID CREATED STATUS PORTS NAMES
d4da95779a3c 3 minutes ago Up 3 minutes 80/tcp modest_meitner
$ sudo tree /var/run/docker/libcontainerd -L 1
/var/run/docker/libcontainerd
├── containerd
├── d4da95779a3c287b28b421194f04374b6330e6ff10f5ca1a99d03828d84f1635
├── docker-containerd.pid
├── docker-containerd.sock
└── event.ts
$ sudo tree /var/run/docker/libcontainerd/d4da95779a3c.../
/var/run/docker/libcontainerd/d4da95779a3c.../
├── config.json
├── init-stderr
├── init-stdin
└── init-stdout
$ sudo file /var/run/docker/libcontainerd/d4da95779a3c.../config.json
/var/run/docker/libcontainerd/d4da95779a3c.../config.json: ASCII text, with very long lines
```
## Installation
#### Binaries
For installation instructions from binaries please visit the [Releases Page](https://github.com/genuinetools/riddler/releases).
#### Via Go
```console
$ go get github.com/genuinetools/riddler
```
## Usage
```console
$ riddler -h
riddler - A tool to convert docker inspect to the opencontainers runc spec.
Usage: riddler
Flags:
--host Docker Daemon socket(s) to connect to (default: unix:///var/run/docker.sock)
--idlen Length of UID/GID ID space ranges for user namespaces (default: 0)
--idroot Root UID/GID for user namespaces (default: 0)
--bundle Path to the root of the bundle directory (default: )
-d enable debug logging (default: false)
-f, --force force overwrite existing files (default: false)
--hook Hooks to prefill into spec file. (ex. --hook prestart:netns) (default: [])
Commands:
version Show the version information.
```
## Installation
For seccomp and apparmor support you will need:
- `sys/apparmor.h`
- `seccomp.h`
**OR** to compile without those run:
```console
$ make build BUILDTAGS=""
```
**example**
```console
# just pass the container name or id on run
$ riddler chrome
config.json has been saved.
```
### TODO
- fixup various todos (mostly runtime config parsing)
- add more unit tests for each field