github.com/imran-kn/cilium-fork@v1.6.9/Documentation/gettingstarted/minikube.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      http://docs.cilium.io
     6  
     7  .. _gs_minikube:
     8  
     9  ******************************
    10  Getting Started Using Minikube
    11  ******************************
    12  
    13  This guide uses `minikube <https://kubernetes.io/docs/getting-started-guides/minikube/>`_
    14  to demonstrate deployment and operation of Cilium in a single-node Kubernetes cluster.
    15  The minikube VM requires approximately 5GB of RAM and supports hypervisors like VirtualBox
    16  that run on Linux, macOS, and Windows.
    17  
    18  Install kubectl & minikube
    19  ==========================
    20  
    21  1. Install ``kubectl`` version >= v1.10.0 as described in the `Kubernetes Docs <https://kubernetes.io/docs/tasks/tools/install-kubectl/>`_.
    22  
    23  2. Install ``minikube`` >= v1.3.1 as per minikube documentation: `Install Minikube <https://kubernetes.io/docs/tasks/tools/install-minikube/>`_.
    24  
    25  .. note::
    26  
    27     It is important to validate that you have minikube v1.3.1 installed. Older
    28     versions of minikube are shipping a kernel configuration that is *not*
    29     compatible with the TPROXY requirements of Cilium >= 1.6.0.
    30  
    31  ::
    32  
    33       minikube version
    34       minikube version: v1.3.1
    35       commit: ca60a424ce69a4d79f502650199ca2b52f29e631
    36  
    37  3. Create a minikube cluster:
    38  
    39  ::
    40  
    41       minikube start --network-plugin=cni --memory=4096
    42  
    43  4. Mount the BPF filesystem
    44  
    45  ::
    46  
    47       minikube ssh -- sudo mount bpffs -t bpf /sys/fs/bpf
    48  
    49  .. note::
    50  
    51     In case of installing Cilium for a specific Kubernetes version, the
    52     ``--kubernetes-version vx.y.z`` parameter can be appended to the ``minikube
    53     start`` command for bootstrapping the local cluster. By default, minikube
    54     will install the most recent version of Kubernetes.
    55  
    56  Install Cilium
    57  ==============
    58  
    59  Install Cilium as `DaemonSet
    60  <https://kubernetes.io/docs/concepts/workloads/controllers/daemonset/>`_ into
    61  your new Kubernetes cluster. The DaemonSet will automatically install itself as
    62  Kubernetes CNI plugin.
    63  
    64  .. parsed-literal::
    65  
    66      kubectl create -f \ |SCM_WEB|\/install/kubernetes/quick-install.yaml
    67  
    68  .. include:: k8s-install-validate.rst
    69  
    70  
    71  Next steps
    72  ==========
    73  
    74  Now that you have a Kubernetes cluster with Cilium up and running, you can take
    75  a couple of next steps to explore various capabilities:
    76  
    77  * :ref:`gs_http`
    78  * :ref:`gs_dns`
    79  * :ref:`gs_cassandra`
    80  * :ref:`gs_kafka`