From bf9f1cc482544a1f93c73588f3d6d44aba2a4a51 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Adri=C3=A1n=20Pino?= Date: Wed, 22 Nov 2023 20:28:21 +0100 Subject: [PATCH] Add readme --- README.md | 31 ++++++++++++++++++++++++++++++- 1 file changed, 30 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 0160d1d..01700f5 100644 --- a/README.md +++ b/README.md @@ -1 +1,30 @@ -# multuscni-tests +# Multus CNI Testing Repository + +## Introduction + +This repository is dedicated to testing and demonstrating the capabilities of the [Multus CNI](https://github.com/k8snetworkplumbingwg/multus-cni) plugin in a Kubernetes environment. Multus CNI is an extended Container Network Interface (CNI) plugin that enables attaching multiple network interfaces to pods in Kubernetes. It acts as a "meta-plugin" that calls other CNI plugins and allows for configuring multiple networking interfaces in a single pod. + +## Multus CNI Overview + +Multus CNI provides the flexibility of combining different networking solutions, enabling more complex networking topologies and addressing more advanced networking needs in Kubernetes. It supports all reference CNI plugins (like Flannel, DHCP, Macvlan) alongside with several others. + +## Repository Structure + +This repository contains configurations and YAML definitions for testing different network interfaces using Multus CNI, including: + +- **Bridge:** Network configurations for creating a bridge network. +- **Host-Device:** Configurations for directly attaching a host's network device to a pod. +- **Macvlan:** Demonstrations of using the macvlan interface for pod networking. +- **Ipvlan:** Examples of using the ipvlan interface, which is similar to macvlan but with some differences in implementation and use cases. + +Additionally, a `clean` directory is included for cleanup scripts and instructions in /clean + +## Getting Started + +To get started with testing: + +1. Clone this repository to your Kubernetes master node. +2. Navigate to the directory of the network type you wish to test (e.g., `cd bridge`). +3. Apply the YAML files using `kubectl apply -f .yaml`. + +Refer to the individual `readme.txt` files in each directory for more detailed instructions or notes about each networking type.