github.com/cilium/cilium@v1.16.2/Documentation/network/kubernetes/ipam-cluster-pool.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  .. _gsg_ipam_crd_cluster_pool:
     8  
     9  **************************************
    10  CRD-Backed by Cilium Cluster-Pool IPAM
    11  **************************************
    12  
    13  This is a quick tutorial walking through how to enable CRD-backed by Cilium
    14  cluster-pool IPAM. The purpose of this tutorial is to show how components are
    15  configured and resources interact with each other to enable users to automate or
    16  extend on their own.
    17  
    18  For more details, see the section :ref:`ipam_crd_cluster_pool`
    19  
    20  Enable Cluster-pool IPAM mode
    21  =============================
    22  
    23  #. Setup Cilium for Kubernetes using helm with the options:
    24     ``--set ipam.mode=cluster-pool``.
    25  #. Depending if you are using IPv4 and / or IPv6, you might want to adjust
    26     the ``podCIDR`` allocated for your cluster's pods with the options:
    27  
    28     * ``--set ipam.operator.clusterPoolIPv4PodCIDRList=<IPv4CIDR>``
    29     * ``--set ipam.operator.clusterPoolIPv6PodCIDRList=<IPv6CIDR>``
    30  
    31  #. To adjust the CIDR size that should be allocated for each node you can use
    32     the following options:
    33  
    34     * ``--set ipam.operator.clusterPoolIPv4MaskSize=<IPv4MaskSize>``
    35     * ``--set ipam.operator.clusterPoolIPv6MaskSize=<IPv6MaskSize>``
    36  
    37  #. Deploy Cilium and Cilium-Operator. Cilium will automatically wait until the
    38     ``podCIDR`` is allocated for its node by Cilium Operator.
    39  
    40  Validate installation
    41  =====================
    42  
    43  #. Validate that Cilium has started up correctly
    44  
    45     .. code-block:: shell-session
    46  
    47             $ cilium-dbg status --all-addresses
    48             KVStore:                Ok   etcd: 1/1 connected, has-quorum=true: https://192.168.60.11:2379 - 3.3.12 (Leader)
    49             [...]
    50             IPAM:                   IPv4: 2/256 allocated,
    51             Allocated addresses:
    52               10.0.0.1 (router)
    53               10.0.0.3 (health)
    54  
    55  #. Validate the ``spec.ipam.podCIDRs`` section:
    56  
    57     .. code-block:: shell-session
    58  
    59         $ kubectl get cn k8s1 -o yaml
    60         apiVersion: cilium.io/v2
    61         kind: CiliumNode
    62         metadata:
    63           name: k8s1
    64           [...]
    65         spec:
    66           ipam:
    67             podCIDRs:
    68               - 10.0.0.0/24