docs/oom_setup_paas.rst

   1 .. This work is licensed under a Creative Commons Attribution 4.0
   2 .. International License.
   3 .. http://creativecommons.org/licenses/by/4.0
   4 .. Copyright 2021 Nokia
   5
   6 .. Links
   7 .. _Cert-Manager Installation documentation: https://cert-manager.io/docs/installation/kubernetes/
   8 .. _Cert-Manager kubectl plugin documentation: https://cert-manager.io/docs/usage/kubectl-plugin/
   9
  10 .. _oom_setup_paas:
  11
  12 ONAP PaaS set-up (optional)
  13 ###########################
  14
  15 Starting from Honolulu release, Cert-Manager and Prometheus Stack are a part
  16 of k8s PaaS for ONAP operations and can be optionally installed to provide
  17 additional functionality for ONAP engineers.
  18
  19 The versions of PaaS compoents that are supported by OOM are as follows:
  20
  21 .. table:: ONAP PaaS components
  22
  23   ==============     =============  =================
  24   Release            Cert-Manager   Prometheus Stack
  25   ==============     =============  =================
  26   honolulu           1.2.0          13.x
  27   ==============     =============  =================
  28
  29 This guide provides instructions on how to install the following PaaS
  30 components for ONAP:
  31
  32 - Cert-Manager
  33 - Prometheus Stack
  34
  35 Cert-Manager
  36 ============
  37
  38 Cert-Manager is a native Kubernetes certificate management controller.
  39 It can help with issuing certificates from a variety of sources, such as
  40 Let’s Encrypt, HashiCorp Vault, Venafi, a simple signing key pair, self
  41 signed or external issuers. It ensures certificates are valid and up to
  42 date, and attempt to renew certificates at a configured time before expiry.
  43
  44 Installation steps
  45 ------------------
  46
  47 The recommended version of Cert-Manager for Kubernetes 1.19 is v1.2.0.
  48 Cert-Manager is deployed using regular YAML manifests which include all
  49 the needed resources (the CustomResourceDefinitions, cert-manager,
  50 namespace, and the webhook component).
  51
  52 Full installation instructions, including details on how to configure extra
  53 functionality in Cert-Manager can be found in the
  54 `Cert-Manager Installation documentation`_.
  55
  56 There is also a kubectl plugin (kubectl cert-manager) that can help you
  57 to manage cert-manager resources inside your cluster. For installation
  58 steps, please refer to `Cert-Manager kubectl plugin documentation`_.
  59
  60 Installation can be as simple as::
  61
  62   > kubectl apply -f https://github.com/jetstack/cert-manager/releases/download/v1.2.0/cert-manager.yaml
  63
  64 Prometheus Stack
  65 ================
  66
  67 Prometheus is an open-source systems monitoring and alerting toolkit with
  68 an active ecosystem.
  69
  70 Kube Prometheus Stack is a collection of Kubernetes manifests, Grafana
  71 dashboards, and Prometheus rules combined with documentation and scripts to
  72 provide easy to operate end-to-end Kubernetes cluster monitoring with
  73 Prometheus using the Prometheus Operator. As it includes both Prometheus
  74 Operator and Grafana dashboards, there is no need to set up them separately.
  75
  76 Installation steps
  77 ------------------
  78
  79 The recommended version of kube-prometheus-stack chart for
  80 Kubernetes 1.19 is 13.x (which is currently the latest major chart version),
  81 for example 13.3.1.
  82
  83 In order to install Prometheus Stack, you must follow these steps:
  84
  85 - Create the namespace for Prometheus Stack::
  86
  87     > kubectl create namespace prometheus
  88
  89 - Add the prometheus-community Helm repository::
  90
  91     > helm repo add prometheus-community https://prometheus-community.github.io/helm-charts
  92
  93 - Update your local Helm chart repository cache::
  94
  95     > helm repo update
  96
  97 - To install the kube-prometheus-stack Helm chart in latest version::
  98
  99     > helm install prometheus prometheus-community/kube-prometheus-stack --namespace=prometheus
 100
 101   To install the kube-prometheus-stack Helm chart in specific version, for example 13.3.1::
 102
 103     > helm install prometheus prometheus-community/kube-prometheus-stack --namespace=prometheus --version=13.3.1