Skip to content

Latest commit

 

History

History
88 lines (57 loc) · 2.38 KB

services.rst

File metadata and controls

88 lines (57 loc) · 2.38 KB
Raw

Accessing Cluster Services

MetalK8s GUI

This GUI is deployed during the :doc:`Bootstrap installation <./bootstrap>`, and can be used for operating, extending and upgrading a MetalK8s cluster.

Gather Required Information

Get the ingress control plane IP.

root@bootstrap $ kubectl --kubeconfig=/etc/kubernetes/admin.conf \
  get svc -n metalk8s-ingress ingress-nginx-control-plane-controller \
  -o=jsonpath='{.spec.externalIPs[0]}{"\n"}'
<the ingress control plane IP>

Use MetalK8s UI

Once you have gathered the IP address and the port number, open your web browser and navigate to the URL https://<ip>:8443, replacing placeholders with the values retrieved before.

The login page is loaded, and should resemble the following:

img/ui/login.png

Log in with the default login / password (admin@metalk8s.invalid / password).

Note

To change the default password as provided above, refer to :ref:`this procedure <change-dex-static-user-password>`.

The landing page should look like this:

img/ui/monitoring.png

This page displays two monitoring indicators:

  1. the Cluster Status, which evaluates if control plane services are all up and running
  2. the list of alerts stored in :term:`Alertmanager`.

Grafana

Grafana is available on the same host as the MetalK8s UI, under /grafana. Log in with the default credentials: admin@metalk8s.invalid / password.

Salt

MetalK8s uses SaltStack to manage the cluster. The Salt Master runs in a :term:`Pod` on the :term:`Bootstrap node`.

The Pod name is salt-master-<bootstrap hostname>, and it contains two containers: salt-master and salt-api.

To interact with the Salt Master with the usual CLIs, open a terminal in the salt-master container (assuming the Bootstrap hostname to be bootstrap):

root@bootstrap $ kubectl exec -it -n kube-system -c salt-master \
                   --kubeconfig /etc/kubernetes/admin.conf \
                   salt-master-bootstrap bash
.. todo::

   - how to access / use SaltAPI
   - how to get logs from these containers