Skip to content

Commit

Permalink
prepare for release v0.0.1
Browse files Browse the repository at this point in the history
  • Loading branch information
Sanderhuisman committed Feb 19, 2019
1 parent 9adf90a commit ee0294a
Show file tree
Hide file tree
Showing 2 changed files with 54 additions and 4 deletions.
38 changes: 34 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,10 @@

[![maintainer](https://img.shields.io/badge/maintainer-Sander%20Huisman%20-blue.svg?style=for-the-badge)](https://github.com/Sanderhuisman)

## About

This repository contains custom components I developed for my own [Home-Assistant](https://www.home-assistant.io) setup. Feel free to use the components and report bugs if you find them. If you want to contribute, please report a bug or pull request and I will reply as soon as possible. Please star & watch my project such I can see how many people like my components and for you to stay in the loop as updates come along.

## Components

* [Docker Monitor](#docker_monitor)
Expand All @@ -10,9 +14,22 @@

### Docker Monitor <a name="docker_monitor"></a>

The Docker monitor allows you to monitor statistics and turn on/off containers. The monitor can connected to a daemon through the url parameter. When home assistant is used within a Docker container, the daemon can be mounted as follows `-v /var/run/docker.sock:/var/run/docker.sock`.
The Docker monitor allows you to monitor statistics and turn on/off containers. The monitor can connected to a daemon through the url parameter. When home assistant is used within a Docker container, the daemon can be mounted as follows `-v /var/run/docker.sock:/var/run/docker.sock`. The monitor is based on [Glances](https://github.com/nicolargo/glances) and [ha-dockermon](https://github.com/philhawthorne/ha-dockermon) and combines (in my opinion the best of both integrated in HA :)).

**Important note: as the loading path of platforms have been changed in issue [#20807](https://github.com/home-assistant/home-assistant/pull/20807), the current version is not compliant with HA versions 0.88 and above. This is currently been tested and will soon be released**

#### Events

The monitor can listen for events on the Docker event bus and can fire an event on the Home Assistant Bus. The monitor will use the following event:

* `{name}_container_event` with name the same set in the configuration.

**Important note: as the loading path of platforms have been changed in issue [#20807](https://github.com/home-assistant/home-assistant/pull/20807), the current version is not compliant with HA versions from 0.88 and above. This is currently been tested and will soon be released**
The event will contain the following data:

* `Container`: Container name
* `Image`: Container image
* `Status`: Container satus
* `Id`: Container ID (long)

#### Configuration

Expand Down Expand Up @@ -40,6 +57,7 @@ docker_monitor:
| name | string (Optional) | Client name of Docker daemon. Defaults to `Docker`. |
| url | string (Optional) | Host URL of Docker daemon. Defaults to `unix://var/run/docker.sock`. |
| scan_interval | time_period (Optional) | Update interval. Defaults to 10 seconds. |
| events | boolean (Optional) | Listen for events from Docker. Defaults to false. |
| containers | list (Optional) | Array of containers to monitor. Defaults to all containers. |
| monitored_conditions | list (Optional) | Array of conditions to be monitored. Defaults to all conditions |

Expand Down Expand Up @@ -113,6 +131,18 @@ sensor:
| P1 | PM10 | µg/m3 |
| P2 | PM2.5 | µg/m3 |

## About
## Track Updates
This custom component can be tracked with the help of [custom-lovelace](https://github.com/ciotlosm/custom-lovelace) cards with the [custom_updater](https://github.com/custom-cards/tracker-card) card.

In your configuration.yaml

```yaml
custom_updater:
component_urls:
- 'https://raw.githubusercontent.com/Sanderhuisman/home-assistant-custom-components/master/custom_updater.json'
```

## Credits

## Contributing
* [frenck](https://github.com/frenck/home-assistant-config)
* [robmarkcole](https://github.com/robmarkcole/Hue-sensors-HASS)
20 changes: 20 additions & 0 deletions custom_updater.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
{
"docker_monitor" : {
"updated_at" : "2019-02-19",
"version" : "0.0.1",
"changelog" : "https://github.com/Sanderhuisman/home-assistant-custom-components/releases/latest",
"visit_repo" : "https://github.com/Sanderhuisman/home-assistant-custom-components"
},
"eetlijst" : {
"updated_at" : "2019-02-19",
"version" : "0.0.1",
"changelog" : "https://github.com/Sanderhuisman/home-assistant-custom-components/releases/latest",
"visit_repo" : "https://github.com/Sanderhuisman/home-assistant-custom-components"
},
"luftdaten" : {
"updated_at" : "2019-02-19",
"version" : "0.0.1",
"changelog" : "https://github.com/Sanderhuisman/home-assistant-custom-components/releases/latest",
"visit_repo" : "https://github.com/Sanderhuisman/home-assistant-custom-components"
}
}

0 comments on commit ee0294a

Please sign in to comment.