Skip to content

Latest commit

 

History

History
70 lines (49 loc) · 2.38 KB

k3s.rst

File metadata and controls

70 lines (49 loc) · 2.38 KB
Raw
.. only:: not (epub or latex or html)

    WARNING: You are looking at unreleased Cilium documentation.
    Please use the official rendered version released here:
    https://docs.cilium.io

Getting Started Using K3s

This guide walks you through installation of Cilium on K3s, a highly available, certified Kubernetes distribution designed for production workloads in unattended, resource-constrained, remote locations or inside IoT appliances.

This guide assumes installation on amd64 architecture. Cilium is presently supported on amd64 architecture with ARM support planned for a future release.

Install a Master Node

The first step is to install a K3s master node making sure to disable support for the default CNI plugin:

curl -sfL https://get.k3s.io | INSTALL_K3S_EXEC='--flannel-backend=none --no-flannel' sh -

Install Agent Nodes (Optional)

K3s can run in standalone mode or as a cluster making it a great choice for local testing with multi-node data paths. Agent nodes are joined to the master node using a node-token which can be found on the master node at /var/lib/rancher/k3s/server/node-token.

Install K3s on agent nodes and join them to the master node making sure to replace the variables with values from your environment:

curl -sfL https://get.k3s.io | INSTALL_K3S_EXEC='--disable-network-policy --no-flannel' K3S_URL='https://${MASTER_IP}:6443' K3S_TOKEN=${NODE_TOKEN} sh -

Should you encounter any issues during the installation, please refer to the :ref:`troubleshooting_k8s` section and / or seek help on the Slack channel.

Please consult the Kubernetes :ref:`k8s_requirements` for information on how you need to configure your Kubernetes cluster to operate with Cilium.

Mount the eBPF Filesystem

On each node, run the following to mount the eBPF Filesystem:

sudo mount bpffs -t bpf /sys/fs/bpf

Now that you have a Kubernetes cluster with Cilium up and running, you can take a couple of next steps to explore various capabilities: