Questa pagina è stata tradotta dall'API Cloud Translation.

Controllare la comunicazione con indirizzi IP permanenti sui pod GKE

Standard

Questa pagina mostra come implementare indirizzi IP permanenti sui pod di Google Kubernetes Engine (GKE). Puoi assumere il controllo della rete dei pod GKE con la mappatura degli indirizzi IP permanenti personalizzati. Per scoprire di più sugli indirizzi IP permanenti, sui relativi casi d'uso e sui vantaggi, consulta Informazioni sugli indirizzi IP permanenti per i pod GKE.

Requisiti

GKE versione 1.29 o successive.
Scegli se prenotare gli indirizzi IP forniti da Google (indirizzi IP forniti da Google) o utilizzare i tuoi indirizzi IP (BYOIP).
Configura l'applicazione in esecuzione nei pod in modo che riconosca e utilizzi gli indirizzi IP permanenti assegnati.
Gli indirizzi IP permanenti per i pod GKE richiedono GKE Dataplane V2 e cluster con il networking multiplo abilitato.

Limitazioni

La rete predefinita non supporta gli indirizzi IP permanenti. Devi abilitare il networking multiplo durante la creazione del cluster.
Configura le applicazioni in modo che utilizzino indirizzi IP permanenti assegnati. GKE non aggiunge automaticamente la configurazione dell'indirizzo IP alle interfacce di rete del pod.
Puoi associare ogni indirizzo IP permanente a un solo pod alla volta. Quando sono disponibili più pod, in genere GKE invia il traffico al pod più recente. Tuttavia, GKE lo fa solo se il pod più recente è integro, il che significa che lo stato della condizione Ready è True per impostazione predefinita. Puoi configurare questo comportamento e modificarlo utilizzando l'impostazione reactionMode su GKEIPRoute.
GKE supporta solo gli indirizzi IPv4 come indirizzi IP permanenti.
GKE supporta solo più reti di tipo Device o livello 3 per gli indirizzi IP permanenti.

Prima di iniziare

Prima di iniziare, assicurati di aver eseguito le seguenti operazioni:

Attiva l'API Google Kubernetes Engine.

Attiva l'API Google Kubernetes Engine

Se vuoi utilizzare Google Cloud CLI per questa attività, installa e poi inizializza gcloud CLI. Se hai già installato gcloud CLI, ottieni la versione più recente eseguendo gcloud components update.
Nota: per le installazioni esistenti di gcloud CLI, assicurati di impostare le proprietà compute/region e compute/zone. Se imposti le posizioni predefinite, puoi evitare errori in gcloud CLI come il seguente: One of [--zone, --region] must be supplied: Please specify location.

Abilita GKE Enterprise.
Scopri di più sugli indirizzi IP.
Esamina i requisiti e le limitazioni.

Prezzi

Le seguenti funzionalità di Network Function Optimizer (NFO) sono supportate solo su cluster che si trovano all'interno di progetti in cui è abilitato GKE Enterprise:

Supporto di più reti per i pod
Supporto degli indirizzi IP permanenti per i pod (anteprima)
Criteri di rete multirete (anteprima)
Supporto di Service Steering per i pod (anteprima)

Per capire le modifiche relative all'abilitazione della versione Google Kubernetes Engine (GKE) Enterprise, consulta Prezzi di GKE Enterprise.

Implementare indirizzi IP permanenti per i pod GKE

Gli indirizzi IP permanenti in GKE offrono un modo per assegnare ai pod un'identità di rete stabile, anche se i pod stessi vengono aggiornati o spostati.

Questa sezione riassume il flusso di lavoro per implementare gli indirizzi IP permanenti per i pod GKE:

Crea un cluster: crea un cluster in cui siano abilitate l'API Gateway, GKE Dataplane V2 e il networking multiplo.
Prenota un indirizzo IP: decidi se hai bisogno di un indirizzo IP esterno (accessibile pubblicamente) o interno (solo Google Cloud) e prenotalo. Scegli la stessa regione del tuo cluster GKE.
Crea un gateway: configura l'oggetto Kubernetes Gateway che contiene gli indirizzi IP permanenti riservati e ti consente di creare regole (GKEIPRoutes) su quali pod del cluster possono utilizzare questi indirizzi IP permanenti.
Crea o identifica i carichi di lavoro con reti aggiuntive per gli indirizzi IP permanenti: prepara i pod per l'utilizzo di indirizzi IP permanenti attivando più interfacce di rete e definendo la rete in cui si trovano gli indirizzi IP permanenti.
Crea l'oggetto GKEIPRoute per i carichi di lavoro selezionati: configura GKEIPRoute per assegnare l'indirizzo IP permanente a un pod specifico. Puoi utilizzare le etichette per scegliere come target i pod giusti e, facoltativamente, configurare la modalità di reazione del routing alle modifiche dei pod.
Configura la consapevolezza dell'applicazione: configura l'applicazione all'interno del pod in modo che utilizzi attivamente l'indirizzo IP permanente.
Monitoraggio: tieni traccia dello stato del gateway e degli oggetti GKEIPRoute per assicurarti che tutto funzioni come previsto.

Per implementare l'indirizzo IP permanente per i pod GKE, segui questi passaggi:

Passaggio 1: crea un cluster GKE Dataplane V2 e il networking multiplo abilitati

Per abilitare le funzionalità avanzate di routing di rete e gestione degli indirizzi IP necessarie per implementare gli indirizzi IP permanenti sui pod GKE, devi create un cluster GKE Dataplane V2 e con il networking multiplo abilitato.

Passaggio 2: prenota indirizzi IP permanenti

Per stabilire identità di rete affidabili per i pod e configurare indirizzi IP permanenti, devi prima acquisire indirizzi IP permanenti. Puoi scegliere tra prenotare gli indirizzi IP forniti da Google o utilizzare i tuoi (BYOIP).

Passaggio 2a: prenota gli indirizzi IP forniti da Google

Per prenotare indirizzi IP esterni, esegui il seguente comando:

gcloud compute addresses create ADDRESS_NAME \
   --region=REGION

Sostituisci quanto segue:

ADDRESS_NAME: il nome da associare a questo indirizzo.
REGION: la regione in cui vuoi prenotare questo indirizzo. Questa regione deve essere la stessa del pod a cui vuoi collegare l'indirizzo IP.

Nota: devi specificare una regione quando prenoti un indirizzo IP perché le regole di inoltro, che gestiscono il routing del traffico per gli indirizzi IP permanenti, sono regionali. Affinché il routing funzioni correttamente, l'indirizzo IP e il cluster GKE devono trovarsi nella stessa regione.

Per prenotare gli indirizzi IP interni, esegui il seguente comando:

gcloud compute addresses create ADDRESS_NAME \
    --region REGION
    --subnet SUBNETWORK \
    --addresses IP_ADDRESS

Sostituisci quanto segue:

ADDRESS_NAME: i nomi di uno o più indirizzi che vuoi prenotare. In caso di più indirizzi, specifica tutti gli indirizzi come elenco separato da spazi. Ad esempio, example-address-1 example-address-2 example-address-3
REGION: la regione per questa richiesta.
SUBNETWORK: la subnet per questo indirizzo IPv4 interno.

Per garantire che il traffico venga indirizzato correttamente all'interno della tua rete privata, gli indirizzi IP interni devono appartenere a una subnet designata.

Per ulteriori informazioni sugli indirizzi IP esterni e interni, consulta Prenotare un indirizzo IP esterno statico e Prenotare un indirizzo IP interno statico.

Passaggio 2b: utilizza i tuoi indirizzi IP (BYOIP)

Puoi utilizzare i tuoi indirizzi IP (BYOIP) anziché quelli forniti da Google. BYOIP è utile se hai bisogno di indirizzi IP specifici per le tue applicazioni o se stai spostando sistemi esistenti in Google Cloud. Per utilizzare BYOIP, Google convalida la tua proprietà dell'intervallo di indirizzi IP e, dopo che gli indirizzi IP sono stati importati in Google Cloud, puoi assegnarli come indirizzi IP permanenti per i pod GKE. Per ulteriori informazioni, vedi Utilizzare i tuoi indirizzi IP.

Passaggio 3: crea gli oggetti Gateway

Gli oggetti gateway contengono gli indirizzi IP e definiscono i pod idonei a utilizzarli. Per controllare la modalità di assegnazione degli indirizzi IP permanenti ai pod GKE, utilizzerai gli oggetti Gateway.

Crea un oggetto Kubernetes Gateway della classe appropriata:
- gke-persistent-regional-external-managed per gli indirizzi IP esterni (pubblici).
- gke-persistent-regional-internal-managed per gli indirizzi IP interni (solo Google Cloud).
Nella sezione Indirizzi del gateway, elenca gli indirizzi IP permanenti (forniti da Google o BYOIP) gestiti da questo gateway.
Utilizza la sezione Listeners per determinare quali pod (e i relativi oggetti GKEIPRoute associati) possono potenzialmente utilizzare gli indirizzi IP del gateway. Listeners agisce come filtro in base allo spazio dei nomi di GKEIPRoute in cui esiste un oggetto GKEIPRoute.

Puoi scegliere tra le seguenti opzioni di selezione dello spazio dei nomi Kubernetes:
- Tutti gli spazi dei nomi: qualsiasi GKEIPRoute nel cluster.
- Selettore: GKEIPRoute negli spazi dei nomi di GKEIPRoute corrispondenti a un'etichetta specifica.
- Stessa rete: solo GKEIPRoutes nello stesso spazio dei nomi di GKEIPRoute del gateway.

Il seguente esempio fornisce l'accesso a livello di cluster agli indirizzi IP permanenti esterni, consentendo a qualsiasi pod di utilizzarli potenzialmente.

Salva il seguente manifest di esempio come allowed-pod-ips.yaml:

kind: Gateway
apiVersion: gateway.networking.k8s.io/v1beta1
metadata:
  namespace: default
  name: allowed-pod-ips
spec:
  gatewayClassName: gke-persistent-regional-external-managed

  listeners:
    - name: default
      port: 443
      protocol: none
      allowedRoutes:
        namespaces:
          from: All

  addresses:
    - value: "34.123.10.1/32"
      type: "gke.networking.io/cidr"
    - value: "34.123.10.2/32"
      type: "gke.networking.io/cidr"

dove:

addresses: elenca tutti gli indirizzi IP le cui autorizzazioni sono gestite dal gateway specifico.
listeners: utilizzato per identificare gli spazi dei nomi da cui gli oggetti GKEIPRoute possono fare riferimento a questo gateway.

Applica il manifest al cluster:

kubectl apply -f allowed-pod-ips.yaml

Passaggio 4: crea o identifica i carichi di lavoro con reti aggiuntive per gli indirizzi IP permanenti

Configura i pod su più reti e crea oggetti di rete che indicano le reti a cui appartiene l'indirizzo IP permanente.

Passaggio 5: crea l'oggetto `GKEIPRoute` per i carichi di lavoro selezionati

Per assegnare un indirizzo IP persistente a un pod selezionato, crea un oggetto GKEIPRoute.

Salva il seguente manifest di esempio come my-ip-route.yaml:

kind: GKEIPRoute
apiVersion: networking.gke.io/v1
metadata:
  namespace: default
  name: my-ip-route
spec:
  parentRefs:
  - name: allowed-pod-ips
    namespace: default
  addresses:
  - value: "34.123.10.1/32"
    type: "gke.networking.io/cidr"
  network: blue-network
  reactionMode: ReadyCondition
  podSelector: # Only one pod is selected.
    matchLabels:
      component: proxy

dove:

parentRefs: indica il gateway da cui vengono utilizzati gli indirizzi IP permanenti. Questo campo è immutabile.
addresses: elenca tutti gli indirizzi IP permanenti instradati al pod identificato con podSelector. Questo campo è mutabile. Per IPv4, sono supportati solo gli indirizzi /32.
podSelector: specifica le etichette che identificano il pod a cui vengono instradati gli indirizzi IP permanenti. Questo campo è mutabile e si applica allo stesso spazio dei nomi in cui è inserito GKEIPRoute. Se selezioni più pod, vengono presi in considerazione due fattori aggiuntivi: la data di creazione del pod (GKE sceglie quello più recente) e l'impostazione del campo reactionMode.
reactionMode: specifica il comportamento di questa funzionalità quando viene creato o eliminato un pod specifico (selezionato da podSelector). Questo campo è facoltativo e il valore predefinito è ReadyCondition. Il campo ReadyCondition è immutabile. Puoi impostare reactionMode per controllare il comportamento della funzionalità quando i pod vengono creati, eliminati o aggiornati.
network: indica l'interfaccia di rete su un pod a cui vengono instradati gli indirizzi IP permanenti. Questo campo è immutabile.

Applica il manifest al cluster:

kubectl apply -f my-ip-route.yaml

Assegna indirizzi IP permanenti ai pod StatefulSet

Per assegnare un indirizzo IP permanente a un pod specifico all'interno di un StatefulSet, utilizza il nome host prevedibile del pod e l'etichettatura automatica di Kubernetes, come mostrato nell'esempio seguente:

Salva il seguente manifest di esempio come my-pod-ips.yaml:

kind: GKEIPRoute
apiVersion: networking.gke.io/v1
metadata:
  namespace: proxy-ss-ns
  name: my-pod-ips
spec:
  parentRefs:
  - name: allowed-pod-ips
    namespace: default
  addresses:
  - value: "34.123.10.1/32"
    type: "gke.networking.io/cidr"
  - value: "34.123.10.2/32"
    type: "gke.networking.io/cidr"
  network: blue-network
  reactionMode: ReadyCondition
  podSelector:
    matchLabels:
      statefulset.kubernetes.io/pod-name: proxy-ss-1
---
apiVersion: apps/v1
kind: StatefulSet
metadata:
  namespace: proxy-ss-ns
  name: proxy-ss
spec:
  selector:
    matchLabels:
      component: proxy
  serviceName: "proxy"
  replicas: 3
  template:
    metadata:
      annotations:
        networking.gke.io/default-interface: 'eth0'
        networking.gke.io/interfaces: '[{"interfaceName":"eth0","network":"default"}, {"interfaceName":"eth1","network":"blue-network"}]'
      labels:
        component: proxy
    spec:
      containers:
      - name: hello-app
        image: us-docker.pkg.dev/google-samples/containers/gke/hello-app:1.0

Applica il manifest al cluster (assicurati di avere una rete denominata "blue-network"):

kubectl apply -f my-pod-ips.yaml

Assegna indirizzi IP permanenti ai pod di deployment

Per assegnare un indirizzo IP permanente al pod più recente in un deployment, applica un GKEIPRoute con la seguente configurazione:

Salva il seguente manifest di esempio come my-pod-ips.yaml:

kind: GKEIPRoute
apiVersion: networking.gke.io/v1
metadata:
  namespace: proxy-deploy-ns
  name: my-pod-ips
spec:
  parentRefs:
  - name: allowed-pod-ips
    namespace: default
  addresses:
  - value: "34.123.10.1/32"
    type: "gke.networking.io/cidr"
  - value: "34.123.10.2/32"
    type: "gke.networking.io/cidr"
  network: blue-network
  reactionMode: ReadyCondition
  podSelector:
    matchLabels:
      component: proxy
---
apiVersion: apps/v1
kind: Deployment
metadata:
  namespace: proxy-deploy-ns
  name: proxy-deploy
spec:
  selector:
    matchLabels:
      component: proxy
  replicas: 4 # Latest Pod is used
  template:
    metadata:
      annotations:
        networking.gke.io/default-interface: 'eth0'
        networking.gke.io/interfaces: '[{"interfaceName":"eth0","network":"default"}, {"interfaceName":"eth1","network":"blue-network"}]'
      labels:
        component: proxy
    spec:
      containers:
      - name: hello-app
        image: us-docker.pkg.dev/google-samples/containers/gke/hello-app:1.0

Applica il manifest al cluster (assicurati di avere una rete denominata "blue-network"):

kubectl apply -f my-ip-route.yaml

Passaggio 6: utilizza indirizzi IP permanenti all'interno del pod

L'assegnazione di un indirizzo IP permanente a un pod GKE utilizzando un GKEIPRoute non rende automaticamente gli indirizzi IP utilizzabili dalla tua applicazione. Gli indirizzi IP permanenti vengono gestiti a livello di routing di rete, ma la configurazione predefinita del pod non ne è a conoscenza. Devi configurare la configurazione della tua applicazione in modo che riconosca e utilizzi l'indirizzo all'interno del pod. Per farlo, il tuo pod richiederà autorizzazioni di privilegio.

Per configurare l'applicazione, valuta le seguenti opzioni:

net.ipv4.ip_nonlocal_bind: modifica un'impostazione di sistema per consentire all'applicazione di utilizzare indirizzi IP non assegnati direttamente alla sua interfaccia.
ip address add: utilizza questo comando all'interno della logica dell'applicazione per aggiungere manualmente l'indirizzo IP permanente a un'interfaccia.
Socket non elaborati: per un maggiore controllo, la tua applicazione potrebbe interagire direttamente con lo stack di rete (avanzato).
Pila di indirizzi IP nello spazio utente: in casi specializzati, all'interno del pod potrebbe essere eseguita un'applicazione separata per gestire l'indirizzo IP (molto avanzato).

Personalizzare il comportamento dell'indirizzo IP permanente durante le modifiche del pod

Questa sezione descrive il comportamento dell'indirizzo IP permanente per il pod GKE quando il pod di destinazione viene creato o eliminato. Il controller GKE monitora i pod e la configurazione GKEIPRoute. Quando rileva che è in corso un aggiornamento, riassegna automaticamente l'indirizzo IP permanente a un pod adatto in base al reactionMode scelto.

Scopri come la funzionalità di indirizzo IP permanente gestisce automaticamente le modifiche ai pod e le opzioni di configurazione a tua disposizione:

Scegli tra ReadyCondition o Exists all'interno del reactionMode campo della configurazione GKEIPRoute. Tieni conto delle esigenze della tua applicazione in merito alla velocità di assegnazione dell'indirizzo IP rispetto ai requisiti di idoneità rigorosi.
Se utilizzi ReadyCondition per verificare l'idoneità, assicurati che i pod abbiano implementato correttamente i sondaggi di idoneità di Kubernetes. In caso contrario, l'indirizzo IP permanente potrebbe non funzionare come previsto.
Ti consigliamo di monitorare lo stato dei pod e il campo Conditions dell'oggetto GKEIPRoute per assicurarti che il sistema funzioni correttamente. Lo stato true della condizione Ready indica che il sistema funziona correttamente.

Risolvere i problemi di comunicazione con gli indirizzi IP permanenti per i pod

Questa sezione mostra come risolvere i problemi relativi agli indirizzi IP permanenti per i pod.

`NoPodsFound` se non vengono trovati pod corrispondenti

Sintomo

L'oggetto GKEIPRoute specifica un podSelector (un insieme di etichette) per identificare i pod associati all'indirizzo IP permanente. Lo stato NoPodsFound indica che non sono presenti pod negli spazi dei nomi NoPodsFound scelti come target con le etichette corrispondenti.GKEIPRoute's

Cause potenziali

Etichette errate: il pod con cui intendi utilizzare l'indirizzo IP permanente potrebbe avere etichette errate o nessuna etichetta.
Non esistono pod: se reactionMode == Exists, controlla se il pod è assegnato a un nodo controllando il campo pod.Spec.nodeName. È possibile che nello spazio dei nomi GKEIPRoute's non siano in esecuzione pod corrispondenti al selettore.
Pod not Ready (Pod non pronto): se reactionMode == ReadyCondition, controlla se lo stato del pod è READY. Anche se esiste un pod corrispondente, se non è in uno stato Ready, non può gestire il traffico e quindi non viene selezionato.

Risoluzione

Controlla le etichette: verifica che le etichette in GKEIPRoute's podSelector corrispondano a quelle che hai applicato al pod previsto.
Verifica l'esistenza del pod: assicurati che un pod con le etichette corrette esista effettivamente negli spazi dei nomi GKEIPRoute's specificati da Listeners del tuo gateway. Se reactionMode == Exists, controlla se il pod è assegnato a un nodo controllando il campo pod.Spec.nodeName
Conferma l'idoneità del pod: se reactionMode == ReadyCondition, controlla se lo stato del pod è READY. Assicurati che il pod sia nello stato Ready utilizzando il seguente comando:
```
kubectl get pods -n <namespace>
```
I pod in altri stati (ad esempio "Pending", "Error") non sono selezionati.
Configura i pod per rispondere sull'indirizzo IP persistente assegnato.

`Mutated` quando è stato trovato un pod corrispondente e la programmazione dell'indirizzo IP permanente è in corso