Consenti connessioni dirette ai pod Autopilot tramite hostPort

Questa pagina mostra come esporre una porta casuale in un pod in esecuzione in un Cluster Autopilot di Google Kubernetes Engine (GKE).

L'esposizione di una porta in un pod consente al pod di accettare le connessioni in entrata direttamente, senza un bilanciatore del carico. GKE sceglie una porta da aprire in modo casuale da un intervallo specificato nella specifica del pod. Questo tipo di modello l'esposizione alle porte è utile quando il carico di lavoro richiede connessioni in entrata dirette senza fare affidamento su un numero di porta permanente. Un esempio di questo tipo di carico di lavoro è una risorsa Agones GameServer con il criterio predefinito della porta Dynamic.

Quando richiedi una porta casuale, GKE esegue l'override del valore nella Campo hostPort nella specifica del container per la porta GKE selezionato per te.

Prima di iniziare

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

  • Attiva l'API Google Kubernetes Engine.
    • Abilita 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.
  • Assicurati di avere un Cluster GKE Autopilot con la versione 1.24.7-gke.1200 e successive o 1.25.3-gke.1100 e successive.

Limitazioni

Puoi assegnare hostPort casuali solo per i pod statici o per i pod che sono gestiti da un controller personalizzato come Agones. Questa funzionalità non è supportato su Controller gestiti per Kubernetes come i deployment.

Richiedi una porta casuale

  1. Salva il seguente manifest come host-port-pod.yaml:

    apiVersion: v1
kind: Pod
metadata:
  name: game-pod
  annotations:
    autopilot.gke.io/host-port-assignment: '{"min":MIN_PORT,"max":MAX_PORT}'
spec:
  containers:
  - name: local-chat
    image: ubuntu
    ports:
    - containerPort: 80
      hostPort: HOST_PORT1
      protocol: tcp
  - name: game-server
    image: ubuntu
    ports:
    - containerPort: 80
      hostPort: HOST_PORT2
      protocol: udp

    Sostituisci quanto segue:

    • MIN_PORT: il numero minimo di porta per l'intervallo da cui GKE sceglie una porta casuale.
    • MAX_PORT: il numero di porta massimo per l'intervallo da cui GKE sceglie una porta casuale.
    • HOST_PORT1, HOST_PORT2: qualsiasi numero di porta valido. Quando il pod è pianificato, GKE aggiorna questo campo con la porta assegnata in modo casuale. Se hai più container, utilizza numeri di porta diversi per ogni container.

    L'intervallo di porte (la differenza tra MAX_PORT e MIN_PORT) devono essere almeno 1000 porte.

  2. Applica il manifest:

    kubectl apply -f host-port-pod.yaml

Quando applichi il manifest, GKE seleziona una porta casuale e assegna la porta al container. Se GKE assegna lo stesso valore di porta a due pod, GKE posiziona automaticamente su nodi separati per evitare conflitti tra le porte.

Controlla la porta assegnata

Per trovare il numero di porta che GKE ha assegnato ai tuoi container, e analizza il pod:

kubectl get pod game-pod --output=yaml

L'output è simile al seguente:

apiVersion: v1
kind: Pod
metadata:
  annotations:
    autopilot.gke.io/host-port-assignment: '{"min":MIN_PORT,"max":MAX_PORT,"portsAssigned":{"HOST_PORT1":7300,"HOST_PORT2":7450}}'
  name: game-pod
  namespace: default
spec:
  containers:
  - name: local-chat
    image: ubuntu
    imagePullPolicy: IfNotPresent
    ports:
    - containerPort: 80
      hostPort: 7300
      protocol: TCP
  - name: game-server
    image: ubuntu
    imagePullPolicy: IfNotPresent
    ports:
    - containerPort: 80
      hostPort: 7450
      protocol: UDP

In questo output:

  • metadata.annotations.autopilot.gke.io/host-port-assignment: le assegnazioni delle porte, che mostrano il valore originale di hostPort impostato per ogni contenitore e il valore aggiornato di hostPort assegnato da GKE. Questo campo è utile se hai richiesto più porte nella specifica del pod.
  • spec.containers.ports.hostPort: la porta aperta che GKE assegnati a ciascun container.

Passaggi successivi

Supporto di Track Agones su Autopilot su GitHub.