Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/deoxxa/docker-events

Create an event emitter from dockerode's events response
https://github.com/deoxxa/docker-events

Last synced: 7 days ago
JSON representation

Create an event emitter from dockerode's events response

Awesome Lists containing this project

README

        

docker-events
=============

Create an event emitter from dockerode's events response

Overview
--------

Docker exposes an event API, allowing one to monitor the happenings of a Docker
host. dockerode allows for consumption of this API, albeit in a very raw form.
docker-events does a bit of work for you, turning the raw API of dockerode into
something a little more high-level by parsing the response stream and pushing
things out of an EventEmitter.

API
---

### DockerEvents (constructor)

```js
var emitter = new DockerEvents({
docker: new Dockerode(options),
});
```

### start

```js
emitter.start();
```

### stop

```js
emitter.stop();
```

### #connect

```js
emitter.on("connect", function() {
console.log("connected to docker api");
});
```

### #disconnect

```js
emitter.on("disconnect", function() {
console.log("disconnected to docker api; reconnecting");
});
```

### #_message

```js
emitter.on("_message", function(message) {
console.log("got a message from docker: %j", message);
});
```

### #create

```js
emitter.on("create", function(message) {
console.log("container created: %j", message);
});
```

### #start

```js
emitter.on("start", function(message) {
console.log("container started: %j", message);
});
```

### #stop

```js
emitter.on("stop", function(message) {
console.log("container stopped: %j", message);
});
```

### #die

```js
emitter.on("die", function(message) {
console.log("container died: %j", message);
});
```

### #destroy

```js
emitter.on("destroy", function(message) {
console.log("container destroyed: %j", message);
});
```

License
-------

3-clause BSD. A copy is included with the source.

Contact
-------

* GitHub ([deoxxa](http://github.com/deoxxa))
* Twitter ([@deoxxa](http://twitter.com/deoxxa))
* Email ([[email protected]](mailto:[email protected]))