GitHub - ozlerhakan/rapid: :whale: A lightweight Docker Developer Interface for Docker Remote API
Skip to content

🐳 A lightweight Docker Developer Interface for Docker Remote API

License

Notifications You must be signed in to change notification settings

ozlerhakan/rapid

Repository files navigation

duke rapid logo

Travis devDependency Status License Analytics

screen

Rapid Docker Interface provides a connection between Docker queries and your Docker Host. Rapid changes the way of using Docker Engine API with ease. The Command Editor is your new Docker client communicating with the Engine. You can easily request supported Docker queries of Docker Remote API. Rapid Dashboard was distinguished as a Duke’s Choice Award 2017 Winner in October at JavaOne. The award is one of nine awards issued for the innovative application of Java in 2017.

Installation

Supported tags:

The command below will pull the latest image of Rapid into your local docker host and start a container as daemon listening internally on port 8080 and we need to give access to the host’s Docker daemon by mapping to the Docker socket:

$ docker run -d --name rapid  \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -p 8080:8080 \
  ozlerhakan/rapid

If your docker host runs via docker machine, go into it using $docker-machine ssh and run the command.

then open your browser to http://localhost:8080 or http://<docker-host-vm-ip>:8080, have fun!

In Docker Swarm World, you can run the rapid as a service like below:

$ docker service create --name rapid \
  --mount="type=bind,source=/var/run/docker.sock,target=/var/run/docker.sock" \
  --constraint "node.role == manager" \
  -p 8080:8080 \
  ozlerhakan/rapid

Demo

Try in PWD

Notes

  1. Header Parameters (X-Registry-Auth) are not supported.

  2. Tags ending with arm should work on supported versions of the Raspberry Pi models.

Versions

Docker Version API & Tag Version Changes

17.07.x

1.31, latest

API changes

17.06.x

1.30, latest

API changes

17.05.x

1.29

API changes

17.03.1

1.27

API changes

Editor Shortcuts

Rapid contains the following shortcuts. Any other shortcut suggestions are always welcome.

Windows Mac Detail

Ctrl+D

+D

Duplicate line

Ctrl+Shift+C

++C

Copy the selection as cURL

Ctrl+X

+X

Remove current line

Shift+Enter

+

Start new line

Alt+Shift+Up

++Up

Move line up

Alt+Shift+Down

++Down

Move line down

Ctrl+Mouse_Scroll_Up

+Mouse_Scroll_Up

Zoom in

Ctrl+Mouse_Scroll_Down

+Mouse_Scroll_Down

Zoom out

Ctrl+Alt+H

++H

Show shortcuts

Ctrl+Shift+R

++R

Clear editor

Ctrl+/

+/

Comment/Uncomment with line comment

cURL Details

The following cURL commands are all valid so as to paste them into the command editor. When you paste a valid command, Rapid converts it to a corresponding valid Docker remote query.

curl --unix-socket /var/run/docker.sock \
 -H "Content-Type: application/json" \
 -X POST http:/v1.32/containers/create \
 -d '
 {"Image": "alpine", "Cmd": ["echo", "hello world"]}
 '

curl --unix-socket /var/run/docker.sock -H "Content-Type: application/json" \
  -X POST http:/v1.32/containers/create \
  -d '{"Image": "alpine", "Cmd": ["echo", "hello world"]}'

curl --unix-socket /var/run/docker.sock \
 -H "Content-Type: application/json" \
 -X POST http:/v1.32/containers/create \
 -d '{"Image": "alpine", "Cmd": ["echo", "hello world"]}'

curl --unix-socket /var/run/docker.sock -X GET http:/v1.32/containers/json

curl --unix-socket /var/run/docker.sock -X GET http:/v1.32/images/json

curl --unix-socket /var/run/docker.sock -XGET http:/v1.32/containers/json

curl --unix-socket /var/run/docker.sock -XGET "http:/v1.32/containers/1c6594faf5/logs?stdout=1"

curl --unix-socket /var/run/docker.sock  -H "Content-Type: application/json"  -X POST http:/v1.32/containers/create -d'
 {"Image": "alpine", "Cmd": ["echo", "hello world"]}
 '

curl --unix-socket /var/run/docker.sock  -H "Content-Type: application/json"  -XPOST http:/v1.32/containers/create -d' {"Image": "alpine", "Cmd": ["echo", "hello world"]}'

curl --unix-socket /var/run/docker.sock\
  -X POST "http:/v1.32/commit?container=0888269a9d&repo=helloworld"

The ++C shortcut enables you to convert the selection to the equivalent cURL command and copy it to clipboard.

a selected query from the command editor
POST containers/create?name=mycontainer
{
    "Image": "alpine",
    "Cmd": [
        "echo",
        "hello world"
    ]
}
the equivalent cURL command of the query above
curl --unix-socket /var/run/docker.sock -XPOST "http:/v1.32/containers/create?name=mycontainer" -H "Content-Type: application/json" -d'
{
    "Image": "alpine",
    "Cmd": [
        "echo",
        "hello world"
    ]
}'

Contributing

Any comments/issues/PRs are always welcome!

License

Rapid is released under MIT.