Connecter un pod Kubernetes au réseau Docker `oc` via Multus CNI

Contexte

Le schedulerd tourne dans le réseau Docker oc avec accès à mongo, loki, nats et consul. Les jobs Kubernetes (oc-monitord) lancés par le schedulerd n'ont pas accès à ce réseau par défaut.

Multus CNI permet d'attacher une seconde interface réseau au pod, branchée directement sur le bridge Docker oc.

Étape 1 — Récupérer les infos du réseau Docker `oc`

# Nom du bridge sur l'hôte (les 12 premiers caractères de l'ID)
docker network inspect oc --format '{{.Id}}' | cut -c1-12
# → ex: a1b2c3d4e5f6  →  bridge = br-a1b2c3d4e5f6

# Subnet
docker network inspect oc --format '{{range .IPAM.Config}}{{.Subnet}}{{end}}'
# → ex: 172.20.0.0/16

# Gateway
docker network inspect oc --format '{{range .IPAM.Config}}{{.Gateway}}{{end}}'
# → ex: 172.20.0.1

Étape 2 — Installer Multus

kubectl apply -f https://raw.githubusercontent.com/k8snetworkplumbingwg/multus-cni/master/deployments/multus-daemonset.yml

Attendre que les pods soient ready :

kubectl -n kube-system wait --for=condition=ready pod -l app=multus --timeout=60s

Étape 3 — Créer la NetworkAttachmentDefinition

Remplacer br-xxxxxxxxxxxx, le subnet et la gateway par les valeurs récupérées à l'étape 1.

# oc-network-attachment.yaml
apiVersion: k8s.cni.cncf.io/v1
kind: NetworkAttachmentDefinition
metadata:
  name: docker-oc-network
  namespace: default
spec:
  config: '{
    "cniVersion": "0.3.1",
    "type": "bridge",
    "bridge": "br-xxxxxxxxxxxx",
    "isGateway": false,
    "ipMasq": false,
    "ipam": {
      "type": "host-local",
      "subnet": "172.20.0.0/16",
      "rangeStart": "172.20.100.0",
      "rangeEnd": "172.20.100.255",
      "gateway": "172.20.0.1"
    }
  }'

rangeStart / rangeEnd dans une plage haute pour éviter les collisions avec les IPs assignées par Docker.

kubectl apply -f oc-network-attachment.yaml

Étape 4 — Annoter le pod dans le code

Dans daemons/execute_monitor_container.go, ajouter l'annotation sur le PodTemplateSpec :

Template: corev1.PodTemplateSpec{
    ObjectMeta: metav1.ObjectMeta{
        Annotations: map[string]string{
            "k8s.v1.cni.cncf.io/networks": "docker-oc-network",
        },
    },
    Spec: corev1.PodSpec{
        RestartPolicy: corev1.RestartPolicyNever,
        // ...
    },
},

Étape 5 — Vérifier

Une fois un pod lancé :

# Vérifier les interfaces réseau du pod
kubectl exec <pod-name> -- ip addr
# Doit afficher eth0 (réseau K8s) + net1 (réseau oc)

# Tester la résolution DNS vers les services Docker
kubectl exec <pod-name> -- ping mongo
kubectl exec <pod-name> -- ping loki
kubectl exec <pod-name> -- ping nats

Points d'attention

Le plugin CNI bridge doit être disponible sur le node — il l'est par défaut sur k3s.
Le bridge Docker (br-xxxxxxxxxxxx) doit exister sur l'hôte au moment où le pod démarre. Si Docker redémarre, l'ID du bridge peut changer si le réseau est recréé.
La résolution DNS des hostnames Docker (mongo, loki, etc.) depuis le pod nécessite que le pod utilise le DNS Docker (127.0.0.11). Si la résolution ne fonctionne pas, ajouter dans la NAD : "dns": {"nameservers": ["127.0.0.11"]}.

3.3 KiB Raw Blame History

Connecter un pod Kubernetes au réseau Docker oc via Multus CNI