From ddaddc60d9295c116429e53f25e118279916a2a7 Mon Sep 17 00:00:00 2001 From: Budh Ram Gurung Date: Thu, 28 Sep 2017 12:30:17 +0530 Subject: [PATCH] Issue #40 Update prometheus add-on README to use admin user to login with --- add-ons/prometheus/README.md | 35 +++++++++++++++++++++-------------- 1 file changed, 21 insertions(+), 14 deletions(-) diff --git a/add-ons/prometheus/README.md b/add-ons/prometheus/README.md index 76efa4c..a5ee896 100644 --- a/add-ons/prometheus/README.md +++ b/add-ons/prometheus/README.md @@ -1,30 +1,37 @@ # Prometheus Add-on -An addon that will deploy Prometheus. +An add-on that will deploy [Prometheus](https://prometheus.io/) on the OpenShift cluster provided by [Minishift](https://github.com/minishift/minishift). -NOTE: Requires Origin >= 3.6.0-rc.0 +## Prerequisites -Verify you have installed these addons, by following the [general readme](../../README.adoc#download-and-use-community-add-ons). +- Origin version >= 3.6.0 +- A _cluster-admin_ user which is required to access Prometheus web UI. -## Deploy prometheus -To deploy prometheus do: +_NOTE_: [`admin-user`](https://github.com/minishift/minishift/tree/master/addons/admin-user) add-on provides a way to create _admin_ user with _cluster-admin_ role + +Verify that you have installed the add-on by following [general readme](../../README.adoc#download-use-community-addons). + +## Deploy Prometheus +To deploy Prometheus do: ``` minishift addon apply prometheus --addon-env namespace=kube-system ``` -_NOTE_: You should provide the namespace where it will be installed with the addon-env namespace, like this: +## Use Prometheus -## Use prometheus -Prometheus will be available at: +- Prometheus will be available at: -``` -$ minishift openshift service prometheus -n -``` + ``` + $ minishift openshift service prometheus -n kube-system + ``` + + _NOTE_: There service is exposed though SSL, so use _https_ to access it. + +- Login with cluster-admin user in OpenShift console during `Sign in with a Account` action. -_NOTE_: There service is exposed though SSL, so use https to access it. -## Delete prometheus -Delete prometheus with: +## Delete Prometheus +Delete Prometheus with: ``` oc delete sa,clusterrolebinding,route,svc,secret,deployment,configmap -l app=prometheus -n --as=system:admin