docs/install/install-kubernetes.rst

.. _install-kubernetes:

RhodeCode Kubernetes Deployment
===============================

.. important::
    Setup RhodeCode in K8s is in beta testing right now, and our team doing the testing in AWS EKS. 
    If you want to use RhodeCode in K8s and faced problems please reach out to our team in the Community Slack Channel or via ticket if you on the Enterprise license.

.. tip::
    Requirements:

    - RhodeCode 5.x
    - Kubernetes 1.21+ cluster
    - Helm 3.0+
    - NFS shared storage
    - One of the CSI drivers: NFS CSI / AWS EFS CSI / Azure Files CSI
    - `prometheus-community.github.io/helm-chart`_ 0.11.0

Diagram of the helm chart components
------------------------------------

.. image:: ../images/helm-chart-diagram.png

Installation
------------

1. Find the latest version of chart by the link `hub.docker.com/r/rhodecode/rhodecode/tags`_
2. Fetch the latest version of chart and extract values.yaml file.

.. code-block:: bash

    $ export VERSION=0.1.0-alpha.73
    $ helm fetch oci://registry-1.docker.io/rhodecode/rhodecode  --version ${VERSION}
    $ tar -zxvf rhodecode-${VERSION}.tgz rhodecode/values.yaml

3. Update values.yaml or create a custom one with values overrides.
4. Install using the values.yaml file:

.. code-block:: bash

    $ helm install rhodecode oci://registry-1.docker.io/rhodecode/rhodecode  --version ${VERSION} --create-namespace --namespace rhodecode  -f rhodecode/values.yaml

Update
------

1. Change the values.yaml or custome values file using a text editor.
2. Upgrade using the values.yaml file:

.. code-block:: bash

    $ helm upgrade rhodecode oci://registry-1.docker.io/rhodecode/rhodecode  --version ${VERSION} --namespace rhodecode  -f rhodecode/values.yaml

Uninstall
---------

.. code-block:: bash

    $ helm delete rhodecode --namespace rhodecode

.. note::

   There is known issues with setup on AWS EKS with EFS, please refer to: :ref:`known-issues`

.. _prometheus-community.github.io/helm-chart: https://prometheus-community.github.io/helm-chart
.. _hub.docker.com/r/rhodecode/rhodecode/tags: https://hub.docker.com/r/rhodecode/rhodecode/tags