joshuachp/dockrs

dockrs

• mock: will mock the docker client to use in the tests

dockrs's Issues

Implement logs command

Fetch the logs of a container

dockrs logs [OPTIONS] CONTAINER

Implement stop command

Stop one or more running containers

dockrs stop [OPTIONS] CONTAINER [CONTAINER...]

Create dockrs scaffolding

• Add build CI
• add test CI
• Add fmt CI

Choose a crate/library for interacting with the Docker daemon

Prepare two different pull request to show the difference between:

• https://crates.io/crates/bollard
• https://crates.io/crates/shiplift

Focusing on :

• coverage of Docker Engine API
• simplicity of API to use
• crate/repo maintenance ( Actively Developed / Maintained )
  ....

Implement events command

Get real time events from the server

dockrs events [OPTIONS]

Also try writing a function that returns a channel of DockerEvent.

struct DockerEvent{
 object_type: ObjectType,
 event: Event,
 action: String
}
....

fn docker_events() -> Receiver<DockerEvent>{}

Object types

Containers

Docker containers report the following events:

• attach
• commit
• copy
• create
• destroy
• detach
• die
• exec_create
• exec_detach
• exec_die
• exec_start
• export
• health_status
• kill
• oom
• pause
• rename
• resize
• restart
• start
• stop
• top
• unpause
• update

Images

Docker images report the following events:

• delete
• import
• load
• pull
• push
• save
• tag
• untag

Volumes

Docker volumes report the following events:

• create
• destroy
• mount
• unmount

Networks

Docker networks report the following events:

• create
• connect
• destroy
• disconnect
• remove

Daemons

Docker daemons report the following events:

• reload

https://docs.docker.com/engine/reference/commandline/events/

Implement Run command

Create and run a new container from an image

dockrs run [OPTIONS] IMAGE [COMMAND] [ARG...]

ref https://docs.docker.com/engine/reference/commandline/run/

Implement ps command

List containers

dockrs ps [OPTIONS]

Options:

• -a --all: Show all containers (default shows just running)
• --size: Show disk usage by container
• -f --filtered: [id, name, exited, status, network]

Implement start command

Start one or more stopped containers

dockrs start [OPTIONS] CONTAINER [CONTAINER...]

Implement pull command

Download an image from a registry

dockrs pull [OPTIONS] NAME[:TAG|@DIGEST]

ref https://docs.docker.com/engine/reference/commandline/pull/