add README, samples

Author: Ilja Weis

.goreleaser.yml

@@ -0,0 +1,14 @@
+builds:
+  - binary: check_kubernetes
+    goos:
+    - windows
+    - darwin
+    - linux
+    goarch:
+    - amd64
+    env:
+    - CGO_ENABLED=0
+archive:
+  format: tar.gz
+release:
+  draft: true

README.md

@@ -1,7 +1,27 @@
-See https://github.com/kubernetes/client-go/blob/master/INSTALL.md on 
-how to install the dependencies.
+# check_kubernetes
 
-    $ go get k8s.io/client-go/...
+Icinga/Nagios Kubernetes check. Checks state of individual objects.
 
-should work.
+For use with https://github.com/Nexinto/kubernetes-icinga.
 
+## Usage
+
+```bash
+check_kubernetes -kubeconfig ... -type deployment -namespace kube-system -name kube-dns
+
+```
+
+Supported types:
+
+* pod
+* replicaset
+* deployment
+* daemonset
+* statefulset
+* node
+* componentstatus
+* service
+
+## Using Icinga
+
+Use the configuration in `examples/check_kubernetes.conf` to configure check_kubernetes as a check_command in Icinga.

examples/check_kubernetes.conf

@@ -0,0 +1,14 @@
+object CheckCommand "check_kubernetes" {
+
+   command = [
+     PluginDir + "/check_kubernetes"
+   ]
+
+   arguments = {
+     "-kubeconfig" = "$kubernetes_config$"
+     "-type" = "$kubernetes_type$"
+     "-name" = "$kubernetes_name$"
+     "-namespace" = "$kubernetes_namespace$"
+   }
+
+}