docs/release/installation/deployment-guide.rst

   1 ===================================
   2 Welcome to Kuberef's documentation!
   3 ===================================
   4
   5 Introduction
   6 ============
   7
   8 Kuberef aims to develop and deliver a Kubernetes-based reference
   9 implementation according to CNTT RA-2 in close collaboration with the
  10 CNTT RI-2 workstream.
  11
  12 .. note::
  13
  14     This is just an example of a possible RI-2 deployment. Kuberef aims to
  15     support and include other potential hardware and Kubernetes deployers as well. More
  16     details can be found in the `Kuberef Wiki <https://wiki.opnfv.org/spaces/viewspace.action?key=KUB>`_.
  17
  18 Infrastructure Prerequisites
  19 =============================
  20
  21 Please refer to Chapter 3 of `CNTT RI-2 Documentation <https://github.com/cntt-n/CNTT/blob/master/doc/ref_impl/cntt-ri2/chapters/chapter03.md>`_
  22 for detailed information on the server and network specifications.
  23
  24 Additionally, please make note of the following:
  25
  26 1. Ensure that you have KVM installed and set up on your jump server. This is needed
  27    because the deployment will spin up a VM which will then carry out the host and
  28    Kubernetes installation.
  29
  30 2. Generate SSH keypair.
  31
  32 3. Add user to the sudo and libvirt group and have passwordless sudo enabled.
  33
  34 4. Install Ansible (tested with 2.9.14) and yq.
  35
  36 Deployment
  37 =============================
  38
  39 Please refer to Chapter 4 of `CNTT RI-2 Documentation <https://github.com/cntt-n/CNTT/blob/master/doc/ref_impl/cntt-ri2/chapters/chapter04.md>`_
  40 for instructions to get started with the deployment.
  41
  42 Once the deployment is successful, you will have a fully functional RI-2 setup!
  43
  44 Validation of the Reference Implementation
  45 ===========================================
  46
  47 Kuberef has been validated by running test cases defined in CNTT RC2 Cookbook.
  48 For setting up RC2 Conformance toolchain, please refer to `CNTT RC-2 Chapter 03 <https://github.com/cntt-n/CNTT/blob/master/doc/ref_cert/RC2/chapters/chapter03.md>`_.