21

GitHub - moncho/dry: dry - A Docker manager for the terminal @

 6 years ago
source link: https://github.com/moncho/dry
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.

README.md

dry

MIT License wercker status Go Report Card GoDoc Coverage Status Github All Releases Join the chat at https://gitter.im/moncho/dry Release

Dry is a terminal application to manage Docker. It shows information about Containers, Images and Networks, and, if running a Docker Swarm, it also shows all kinds of information about the state of the Swarm cluster. It can connect to both local or remote Docker daemons.

Besides showing information, it can be used to manage Docker. Most of the commands that the official Docker CLI has, are available in dry with the same behaviour. A list of available commands and their keybinds can be found in dry's help screen or in this README.

Lastly, it can also be used as a monitoring tool for Docker containers.

Dry is installed as a single binary and does not require external libraries.

The demo below shows a dry session.

asciicast

dry keybinds

Global

Keybinding Description % filter list F1 sort list F5 refresh list F8 show docker disk usage F9 show last 10 docker events F10 show docker info 1 show container list 2 show image list 3 show network list 4 show node list (on Swarm mode) 5 show service list (on Swarm mode) ArrowUp move the cursor one line up ArrowDown move the cursor one line down g move the cursor to the top G move the cursor to the bottom q quit dry

Container commands

Keybinding Description Enter show container command menu F2 toggle on/off showing stopped containers i inspect l container logs e remove s stats Ctrl+e remove all stopped containers Ctrl+k kill Ctrl+r start/restart Ctrl+t stop

Image commands

Keybinding Description i history r run command in new container Ctrl+d remove dangling images Ctrl+e remove image Ctrl+f remove image (force) Enter inspect

Network commands

Keybinding Description Ctrl+e remove network Enter inspect

Service commands

Keybinding Description i inspect service l service logs Ctrl+r remove service Ctrl+s scale service Enter show service tasks

Moving around buffers

Keybinding Description ArrowUp move the cursor one line up ArrowDown move the cursor one line down g move the cursor to the beginning of the buffer G move the cursor to the end of the buffer n after search, move forwards to the next search hit N after search, move backwards to the previous search hit s search pg up move the cursor "screen size" lines up pg down move the cursor "screen size" lines down

Installation

The easiest way to install the latest binaries for Linux and Mac is to run this in your shell:

curl -sSf https://moncho.github.io/dry/dryup.sh | sudo sh
sudo chmod 755 /usr/local/bin/dry

Binaries

If you dont like to curl | sh, binaries are provided.

Mac OS X / Homebrew

If you're on OS X and want to use homebrew:

brew tap moncho/dry
brew install dry

Docker

docker run -it -v /var/run/docker.sock:/var/run/docker.sock moncho/dry

Arch Linux

yaourt -S dry-bin

Usage

Open a console, type dry. It will try to connect to:

  • A Docker host given as a parameter (-H).
  • if none given, a Docker host defined in the $DOCKER_HOST environment variable.
  • if not defined, to unix:///var/run/docker.sock.

If no connection with a Docker host succeeds, dry will exit immediately.

dry -p launches dry with pprof package active.

Contributing

All contributions are welcome.

  • Fork the project.
  • Make changes on a topic branch.
  • Pull request.

Copyright and license

Code released under the MIT license. See LICENSE for the full license text.

Credits

Built on top of:

Also reused some code and ideas from the Docker project.


report

Recommend

About Joyk


Aggregate valuable and interesting links.
Joyk means Joy of geeK