github.com/cilium/cilium@v1.16.2/Documentation/installation/k8s-install-rke.rst (about)

     1  .. only:: not (epub or latex or html)
     2  
     3      WARNING: You are looking at unreleased Cilium documentation.
     4      Please use the official rendered version released here:
     5      https://docs.cilium.io
     6  
     7  .. _rke_install:
     8  
     9  ********************************************
    10  Installation using Rancher Kubernetes Engine
    11  ********************************************
    12  
    13  This guide walks you through installation of Cilium on **standalone**
    14  `Rancher Kubernetes Engine (RKE) <https://www.rancher.com/products/secure-kubernetes-distribution>`__
    15  clusters, SUSE's CNCF-certified Kubernetes distribution with built-in security
    16  and compliance capabilities.
    17  RKE solves the common frustration of installation complexity with Kubernetes by
    18  removing most host dependencies and presenting a stable path for deployment,
    19  upgrades, and rollbacks.
    20  
    21  If you're using the Rancher Management Console/UI to install your RKE clusters, head
    22  over to the :ref:`Installation using Rancher <rancher_managed_rke_clusters>` guide.
    23  
    24  .. _rke1_cni_none:
    25  
    26  Install a Cluster Using RKE1
    27  =============================
    28  
    29  The first step is to install a cluster based on the `RKE1 Kubernetes installation guide <https://rke.docs.rancher.com/installation>`__.
    30  When creating the cluster, make sure to `change the default network plugin <https://rancher.com/docs/rke/latest/en/config-options/add-ons/network-plugins/custom-network-plugin-example/>`__
    31  in the generated ``config.yaml`` file.
    32  
    33  Change:
    34  
    35  .. code-block:: yaml
    36  
    37    network:
    38      options:
    39        flannel_backend_type: "vxlan"
    40      plugin: "canal"
    41  
    42  To:
    43  
    44  .. code-block:: yaml
    45  
    46    network:
    47      plugin: none
    48  
    49  
    50  Install a Cluster Using RKE2
    51  =============================
    52  
    53  The first step is to install a cluster based on the `RKE2 Kubernetes installation guide <https://docs.rke2.io/install/quickstart>`__.
    54  You can either use the `RKE2-integrated Cilium version <https://docs.rke2.io/install/network_options#install-a-cni-plugin>`__
    55  or you can configure the RKE2 cluster with ``cni: none`` (see `doc <https://docs.rke2.io/reference/server_config>`__),
    56  and install Cilium with Helm. You can use either method while the
    57  directly integrated one is recommended for most users.
    58  
    59  Cilium power-users might want to use the ``cni: none`` method as Rancher is using
    60  a custom ``rke2-cilium`` `Helm chart <https://github.com/rancher/rke2-charts/tree/main-source/packages/rke2-cilium>`__
    61  with independent release cycles for its integrated Cilium version. By instead using the
    62  out-of-band Cilium installation (based on the official
    63  `Cilium Helm chart <https://github.com/cilium/charts>`__),
    64  power-users gain more flexibility from a Cilium perspective.
    65  
    66  Deploy Cilium
    67  =============
    68  
    69  .. tabs::
    70  
    71      .. group-tab:: Helm v3
    72  
    73          Install Cilium via ``helm install``:
    74  
    75          .. parsed-literal::
    76  
    77             helm repo add cilium https://helm.cilium.io
    78             helm repo update
    79             helm install cilium |CHART_RELEASE| \\
    80                --namespace $CILIUM_NAMESPACE
    81  
    82      .. group-tab:: Cilium CLI
    83  
    84          .. include:: cli-download.rst
    85  
    86          Install Cilium by running:
    87  
    88          .. parsed-literal::
    89  
    90              cilium install |CHART_VERSION|
    91  
    92  .. include:: k8s-install-validate.rst
    93  
    94  .. include:: next-steps.rst