Implementazione di un modello di rete in modalità piatta con il supporto BGP

Questo documento descrive come implementare un modello di rete in modalità flat con Border Supporto del protocollo BGP (Gateway Protocol). Quando implementi un modello di rete con BGP BGP, il BGP garantisce dinamicamente che i pod in domini di livello 2 diversi comunicare tra loro. Il networking in modalità flat con BGP a volte è chiamato un IP flat dinamico.

Per ulteriori informazioni sui modelli di rete flat-mode, vedi Modelli di rete piatti e in modalità a isola.

Come implementare una rete in modalità piatta che utilizza BGP

Il networking in modalità flat con BGP viene abilitato quando crei un nuovo cluster. Tu non è possibile abilitare questa funzionalità per un cluster esistente. Una volta attivata questa funzione, puoi apportare modifiche ad alcune impostazioni di configurazione.

Per implementare un cluster su un modello di rete in modalità flat con supporto BGP:

1. Modifica il file di configurazione del cluster:

   • Imposta il campo spec.clusterNetwork.advancedNetworking su true.

   • Se vuoi abilitare il networking in modalità flat per IPv4, imposta il valore spec.clusterNetwork.flatIPv4 su true.

     Per un'alternativa, vedi Cluster a doppio stack (isola IPv4, IP piatto dinamico IPv6), che configura il cluster con il networking in modalità flat solo per IPv6.

   apiVersion: baremetal.cluster.gke.io/v1
   kind: Cluster
   metadata:
     name: bm
     namespace: cluster-bm
   spec:
     type: user
     ...
     clusterNetwork:
       advancedNetworking: true
       flatIPv4: true
     ...
   

   Se il campo spec.clusterNetwork.flatIPv4 è impostato su true, il campo spec.clusterNetwork.pods.cidrBlocks viene ignorato e può essere omesso. Tuttavia, devi aggiungere un manifest ClusterCIDRConfigs nel cluster di configurazione del deployment (per nodo, per pool di nodi e/o per cluster).

2. Aggiungi un manifest NetworkGatewayGroup al file di configurazione del cluster:

   Specifica gli IP mobili da utilizzare per il peering BGP. Assicurati che le risorse nome è default e lo spazio dei nomi è lo spazio dei nomi del cluster.

   ---
   apiVersion: networking.gke.io/v1
   kind: NetworkGatewayGroup
   metadata:
     name: default
     namespace: cluster-bm
   spec:
     floatingIPs:
     - 10.0.1.100
     - 10.0.2.100
   

   La NetworkGatewayGroup risorsa personalizzata gestisce un elenco di uno o più indirizzi IP mobili. Il BGP Le sessioni di peering vengono avviate da indirizzi IP mobili specificati nella risorsa personalizzata NetworkGatewayGroup.

3. Aggiungi un manifest FlatIPMode al file di configurazione del cluster:

   Il nome della risorsa FlatIPMode deve essere default e lo spazio dei nomi è lo spazio dei nomi del cluster. Il valore peerSelector flatip-peer: "true" corrisponde alle etichette negli oggetti BGPPeer bgppeer1 e bgppeer2 (definite in nel passaggio successivo), quindi entrambi i peer vengono utilizzati per il networking in modalità flat.

   Il seguente manifest FlatIPMode è per IPv4 a stack singolo e in modalità flat il networking con BGP. Per configurazioni alternative, consulta Esempi di configurazione.

   ---
   apiVersion: baremetal.cluster.gke.io/v1alpha1
   kind: FlatIPMode
   metadata:
     name: default
     namespace: cluster-bm
   spec:
     enableBGPIPv4: true
     enableBGPIPv6: false
     peerSelector:
       flatip-peer: "true"
   

4. Aggiungi uno o più manifest BGPPeer al file di configurazione del cluster:

   Scegli tu i nomi delle risorse, ma tutte le risorse BGPPeer devono essere nello spazio dei nomi del cluster.

   Nota: l'IPv6 non è supportato per i peer e le sessioni BGP. Puoi configurare BGP solo con indirizzi IPv4.

   ---
   apiVersion: networking.gke.io/v1
   kind: BGPPeer
   metadata:
     name: bgppeer1
     namespace: cluster-bm
     labels:
       flatip-peer: "true"
   spec:
     localASN: 65001
     peerASN: 65000
     peerIP: 10.0.1.254
     sessions: 2
   ---
   apiVersion: networking.gke.io/v1
   kind: BGPPeer
   metadata:
     name: bgppeer2
     namespace: cluster-bm
     labels:
       flatip-peer: "true"
   spec:
     localASN: 65001
     peerASN: 65000
     peerIP: 10.0.2.254
     sessions: 2
   

5. Aggiungi un manifest ClusterCIDRConfig al file di configurazione del cluster:

   Anche la risorsa CusterCIDRConfig deve trovarsi nello spazio dei nomi del cluster.

   apiVersion: baremetal.cluster.gke.io/v1alpha1
   kind: ClusterCIDRConfig
   metadata:
     name: cluster-wide-1
     namespace: cluster-bm
   spec:
     ipv4:
       cidr: "192.168.0.0/16"
       perNodeMaskSize: 24
   

   ClusterCIDRConfig è una risorsa personalizzata che specifica gli intervalli CIDR dei pod da allocati ai nodi in modo dinamico. La CNI utilizza gli intervalli CIDR dei pod allocati su un nodo per allocare indirizzi IP ai singoli pod in esecuzione Nodo. ClusterCIDRConfig viene utilizzato anche per Networking a doppio stack Per ulteriori informazioni informazioni sulla risorsa personalizzata ClusterCIDRConfig, incluso l'utilizzo vedi esempi, vedi Informazioni sulla risorsa personalizzata ClusterCIDRConfig.

6. Crea il cluster:

   bmctl create cluster
   

   Per ulteriori informazioni sulla creazione di cluster, consulta Panoramica della creazione del cluster.

   Se il tuo ambiente supporta BGP multiprotocollo (MP-BGP), IPv4 e IPv6 le route possono essere annunciate su queste sessioni IPv4. Per esempi di vari del modello, inclusi esempi che utilizzano MP-BGP, consulta la sezione Configurazione esempi.

Modifica la configurazione del networking in modalità piatta basata su BGP

Dopo aver creato il cluster configurato per l'utilizzo di un modello di rete in modalità flat con BGP, puoi aggiornare alcune impostazioni di configurazione. Utilizza il cluster di amministrazione kubeconfig quando aggiorni successivamente le risorse correlate a BGP (NetworkGatewayGroup, FlatIPMode e BGPPeer). Il cluster di amministrazione quindi riconcilia le modifiche al cluster utente. Se modifichi queste risorse direttamente il cluster utente, il cluster di amministrazione sovrascrive le modifiche riconciliazioni successive.

Configurazioni di esempio

Le seguenti sezioni includono esempi di configurazione del cluster per diversi varianti del modello di rete in modalità flat con BGP. La configurazione di esempio i file non sono completi. La maggior parte delle impostazioni del cluster che non sono pertinenti alla modalità flat il networking con BGP è stato omesso.

Attenzione: gli indirizzi IP visualizzati nei seguenti esempi di configurazione sono esempi. Sostituisci gli indirizzi IP con i tuoi.

Cluster IPv4 a stack singolo

Il seguente esempio di file di configurazione del cluster mostra le impostazioni per configurazione di un cluster IPv4 a stack singolo con networking in modalità flat con BGP:

apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
metadata:
  name: bm
  namespace: cluster-bm
spec:
  ...
  clusterNetwork:
    advancedNetworking: true
    flatIPv4: true
    services:
      cidrBlocks:
      - 10.96.0.0/12
  ...
---
apiVersion: baremetal.cluster.gke.io/v1alpha1
kind: ClusterCIDRConfig          
metadata:
  name: cluster-wide-1
  namespace: cluster-bm          # Must match the cluster namespace
spec:
  ipv4:
    cidr: "222.2.0.0/16"
    perNodeMaskSize: 24
---
apiVersion: networking.gke.io/v1
kind: NetworkGatewayGroup
metadata:
  name: default
  namespace: cluster-bm           # Must match the cluster namespace
spec:
  floatingIPs:
  - 10.0.1.100
  - 10.0.3.100
---
apiVersion: baremetal.cluster.gke.io/v1alpha1
kind: FlatIPMode
metadata:
  name: default
  namespace: cluster-bm            # Must match the cluster namespace
spec:
  enableBGPIPv4: true
  enableBGPIPv6: false
  peerSelector:
    flatipmode-peer: "true"
---
apiVersion: networking.gke.io/v1
kind: BGPPeer
metadata:
  name: bgppeer1
  namespace: cluster-bm            # Must match the cluster namespace
  labels:
    flatipmode-peer: "true"
spec:
  localASN: 65001
  peerASN: 65002
  peerIP: 10.0.1.254
  sessions: 2
---
apiVersion: networking.gke.io/v1
kind: BGPPeer
metadata:
  name: bgppeer2
  namespace: cluster-bm            # Must match the cluster namespace
  labels:
    flatipmode-peer: "true"
spec:
  localASN: 65001
  peerASN: 65002
  peerIP: 10.0.3.254
  sessions: 2

Cluster a doppio stack (isola IPv4, IP piatto dinamico IPv6)

Il seguente esempio di file di configurazione del cluster mostra le impostazioni per Configurazione di un cluster a doppio stack (IPv4/IPv6) con networking flat-mode con BGP solo per IPv6:

Nota: per impostazione predefinita, il campo spec.flatIPv4 è false e può essere omesso per questa impostazione. configurazione. Abbiamo incluso questo campo nel seguente esempio per aiutarti a e paragoni.

apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
metadata:
  name: bm
  namespace: cluster-bm
spec:
  ...
  clusterNetwork:
    advancedNetworking: true
    flatIPv4: false
    pods:
      cidrBlocks:
      - 192.168.0.0/16
    services:
      cidrBlocks:
      - 10.96.0.0/12
      # Additional IPv6 CIDR block determines if the cluster is dual-stack
      - 2620:0:1000:2630:5:2::/112
  ... 
---
apiVersion: baremetal.cluster.gke.io/v1alpha1
kind: ClusterCIDRConfig          
metadata:
  name: cluster-wide-1
  namespace: cluster-bm          # Must match the cluster namespace
spec:
  ipv4:
    cidr: "192.168.0.0/16"
    perNodeMaskSize: 24
  ipv6:
    cidr: "2222:3::/112"
    perNodeMaskSize: 120
---
apiVersion: networking.gke.io/v1
kind: NetworkGatewayGroup
metadata:
  name: default
  namespace: cluster-bm           # Must match the cluster namespace
spec:
  floatingIPs:
  - 10.0.1.100
  - 10.0.3.100
---
apiVersion: baremetal.cluster.gke.io/v1alpha1
kind: FlatIPMode
metadata:
  name: default
  namespace: cluster-bm            # Must match the cluster namespace
spec:
  enableBGPIPv4: false
  enableBGPIPv6: true
  peerSelector:
    flatipmode-peer: "true"
---
apiVersion: networking.gke.io/v1
kind: BGPPeer
metadata:
  name: bgppeer1
  namespace: cluster-bm            # Must match the cluster namespace
  labels:
    flatipmode-peer: "true"
spec:
  localASN: 65001
  peerASN: 65002
  peerIP: 10.0.1.254
  sessions: 2
---
apiVersion: networking.gke.io/v1
kind: BGPPeer
metadata:
  name: bgppeer2
  namespace: cluster-bm            # Must match the cluster namespace
  labels:
    flatipmode-peer: "true"
spec:
  localASN: 65001
  peerASN: 65002
  peerIP: 10.0.3.254
  sessions: 2

Cluster a doppio stack (IPv4 Dynamic Flat IP, IPv6 Dynamic Flat IP)

Il seguente esempio di file di configurazione del cluster mostra le impostazioni per configurazione di un cluster a doppio stack con networking in modalità flat con BGP:

apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
metadata:
  name: bm
  namespace: cluster-bm
spec:
  ...
  clusterNetwork:
    advancedNetworking: true
    flatIPv4: true
    pods:
      cidrBlocks:
      - 192.168.0.0/16
    services:
      cidrBlocks:
      - 10.96.0.0/12
      # Additional IPv6 CIDR block determines if the cluster is dual-stack
      - 2620:0:1000:2630:5:2::/112
  ... 
---
apiVersion: baremetal.cluster.gke.io/v1alpha1
kind: ClusterCIDRConfig          
metadata:
  name: cluster-wide-1
  namespace: cluster-bm          # Must match the cluster namespace
spec:
  ipv4:
    cidr: "222.2.0.0/16"
    perNodeMaskSize: 24
  ipv6:
    cidr: "2222:3::/112"
    perNodeMaskSize: 120
---
apiVersion: networking.gke.io/v1
kind: NetworkGatewayGroup
metadata:
  name: default
  namespace: cluster-bm           # Must match the cluster namespace
spec:
  floatingIPs:
  - 10.0.1.100
  - 10.0.3.100
---
apiVersion: baremetal.cluster.gke.io/v1alpha1
kind: FlatIPMode
metadata:
  name: default
  namespace: cluster-bm            # Must match the cluster namespace
spec:
  enableBGPIPv4: true
  enableBGPIPv6: true
  peerSelector:
    flatipmode-peer: "true"
---
apiVersion: networking.gke.io/v1
kind: BGPPeer
metadata:
  name: bgppeer1
  namespace: cluster-bm            # Must match the cluster namespace
  labels:
    flatipmode-peer: "true"
spec:
  localASN: 65001
  peerASN: 65002
  peerIP: 10.0.1.254
  sessions: 2
---
apiVersion: networking.gke.io/v1
kind: BGPPeer
metadata:
  name: bgppeer2
  namespace: cluster-bm            # Must match the cluster namespace
  labels:
    flatipmode-peer: "true"
spec:
  localASN: 65001
  peerASN: 65002
  peerIP: 10.0.3.254
  sessions: 2

Risoluzione dei problemi

Per aiutarti a risolvere i problemi relativi al networking in modalità flat con BGP, questo include le istruzioni per verificare la configurazione:

1. Verifica se viene creato un oggetto FlatIPModes nello spazio dei nomi del cluster sulla cluster di amministrazione:

   kubectl get flatipmodes -A --kubeconfig ADMIN_KUBECONFIG
   

   La risposta dovrebbe avere un aspetto simile a questo:

   NAMESPACE                 NAME      AGE
   cluster-bm                default   2d17h
   

2. Verifica se viene creato un oggetto flatipmodes.networking.gke.io sull'utente cluster:

   L'ambito dell'oggetto flatipmodes.networking.gke.io è cluster.

   kubectl get flatipmodes.networking.gke.io --kubeconfig USER_KUBECONFIG
   

   La risposta dovrebbe avere un aspetto simile a questo:

   NAME      AGE
   default   2d17h
   

3. Scarica le BGPSessions risorse per visualizzare le sessioni correnti:

   kubectl get bgpsessions -A --kubeconfig USER_KUBECONFIG
   

   La risposta dovrebbe avere un aspetto simile a questo:

   NAMESPACE     NAME                LOCAL ASN   PEER ASN   LOCAL IP       PEER IP        STATE            LAST REPORT
   kube-system   10.0.1.254-node-01  65500       65000      10.0.1.100     10.0.1.254     Established      2s
   kube-system   10.0.1.254-node-02  65500       65000      10.0.3.100     10.0.1.254     NotEstablished   2s
   kube-system   10.0.3.254-node-01  65500       65000      10.0.1.100     10.0.3.254     NotEstablished   2s
   kube-system   10.0.3.254-node-02  65500       65000      10.0.3.100     10.0.3.254     Established      2s
   

4. Scarica le risorse BGPAdvertisedRoute per visualizzare le route attualmente in corso pubblicizzato:

   kubectl get bgpadvertisedroutes -A --kubeconfig USER_KUBECONFIG
   

   La risposta dovrebbe essere simile alla seguente:

   NAMESPACE     NAME                     PREFIX         METRIC
   kube-system   route-via-222-22-208-240   222.2.0.0/24   
   kube-system   route-via-222-22-209-240   222.2.1.0/24   
   

   I nomi delle route indicano l'hop successivo. Ad esempio, route-via-222-22-208-240 dalla precedente risposta di esempio indica che l'hop successivo per Il prefisso pubblicizzato 222.2.0.0/24 è 222.22.208.240.