Utilizzo di un proxy con GKE su AWS

Questo argomento mostra come instradare il traffico da GKE su AWS Management Service e connettersi tramite un proxy HTTP/HTTPS.

GKE su AWS richiede l'accesso a internet per i seguenti motivi:

  • Il servizio di gestione registra i cluster utente con Connect.
  • I cluster utente eseguono l'agente Connect.
  • Tutti i nodi dei servizi di gestione e dei cluster utente scaricano le immagini da Container Registry.

Puoi indirizzare questo traffico tramite un proxy HTTP o HTTPS. A partire da GKE su AWS 1.8, puoi configurare singole impostazioni del proxy per il tuo servizio di gestione e per ciascuno dei tuoi cluster. Per saperne di più su come modificare le impostazioni del proxy, consulta Modifica delle impostazioni del proxy del cluster.

Puoi dichiarare le impostazioni del proxy in un file JSON a cui viene fatto riferimento in anthos-gke.yaml.

Prerequisiti

Prima di configurare GKE su AWS per l'utilizzo di un proxy, devi abilitare gli endpoint VPC AWS, definire un gruppo di sicurezza per il proxy e consentire le connessioni in uscita a determinati servizi Google Cloud.

Per utilizzare un proxy HTTP, i cluster utente devono eseguire Kubernetes 1.17 o versioni successive.

Abilita endpoint VPC

Prima di configurare un proxy, devi creare endpoint VPC per l'installazione di GKE su AWS. Gli endpoint VPC consentono alle risorse in subnet private di accedere ai servizi AWS senza accesso a internet pubblico.

La seguente tabella elenca i servizi AWS per i quali GKE su AWS richiede endpoint VPC, insieme al tipo di endpoint e ai gruppi di sicurezza per ciascun componente GKE su AWS che richiede l'accesso all'endpoint.

Servizio Tipo di endpoint Gruppi di sicurezza
Scalabilità automatica Interfaccia Gestione, piano di controllo, pool di nodi
EC2 Interfaccia Gestione, piano di controllo, pool di nodi
Bilanciamento del carico Interfaccia Gestione, piano di controllo, pool di nodi
Servizio di gestione chiavi Interfaccia Gestione, piano di controllo, pool di nodi
S3 Gateway Gestione, piano di controllo, pool di nodi
Servizio token di sicurezza (STS) Interfaccia Gestione, piano di controllo, pool di nodi

Puoi creare endpoint dalla console VPC AWS. Le opzioni impostate durante la creazione degli endpoint VPC dipendono dalla configurazione del VPC.

Definisci un gruppo di sicurezza

I componenti di GKE su AWS devono potersi connettere al server proxy. Crea o individua un gruppo di sicurezza AWS che consenta le connessioni in uscita verso il server proxy. Il gruppo di sicurezza deve consentire l'accesso in uscita dai gruppi di sicurezza del piano di gestione, del piano di controllo e del pool di nodi all'indirizzo proxy e alla porta. Salva l'ID di questo gruppo di sicurezza (ad esempio sg-12345678).

Tipo Protocollo Da porta Trasferimento Indirizzo
In uscita TCP Porta proxy Porta proxy Gruppo di sicurezza proxy

Consenti le connessioni in uscita ai servizi Google Cloud

Affinché GKE su AWS possa connettersi ai servizi Google Cloud, il server proxy deve consentire il traffico ai seguenti domini:

  • gkeconnect.googleapis.com
  • gkehub.googleapis.com
  • oauth2.googleapis.com
  • storage.googleapis.com
  • www.googleapis.com
  • gcr.io
  • k8s.gcr.io
  • EC2-REGION.ec2.archive.ubuntu.com

Sostituisci EC2-REGION con la regione AWS EC2 in cui viene eseguita l'installazione di GKE su AWS. Ad esempio, us-west-1.ec2.archive.ubuntu.com/.

Se utilizzi Cloud Service Mesh con Prometheus e Kiali, consenti l'accesso in uscita dai seguenti domini:

  • docker.io
  • quay.io

Creazione del file JSON di configurazione del proxy in corso...

Il file JSON di configurazione del proxy contiene un oggetto con tre coppie chiave/valore, con i nomi delle chiavi httpProxy, httpsProxy e noProxy. I nomi utente e le password vengono criptati mediante la chiave KMS AWS prima di essere applicati al server.

{
  "httpProxy": "HTTP_PROXY",
  "httpsProxy": "HTTPS_PROXY",
  "noProxy": "NO_PROXY"
}

Sostituisci quanto segue:

  • HTTP_PROXY con l'indirizzo del server proxy tramite il quale instradare le richieste HTTP.
  • HTTPS_PROXY con il server proxy attraverso il quale instradare le richieste HTTPS.
  • NO_PROXY con un elenco facoltativo di IP, intervalli CIDR e domini in cui non viene utilizzato il proxy.

Per ulteriori informazioni, consulta la sezione Informazioni di riferimento sulla configurazione. Ad esempio, la seguente configurazione utilizza un proxy in 10.0.0.254 ed esclude un certo numero di siti.

{
  "httpProxy": "http://user:password@10.0.0.254:80",
  "httpsProxy": "http://user:password@10.0.0.254:443",
  "noProxy": "localhost,127.0.0.1,169.254.169.254,10.0.0.0/16,example.com"
}

Aggiunta del proxy ad anthos-gke.yaml

Configura AWSManagementService seguendo questa procedura:

  1. Passa alla directory con la tua configurazione GKE su AWS. Hai creato questa directory durante l'installazione del servizio di gestione.

    cd anthos-aws

  2. Apri anthos-gke.yaml in un editor di testo. Aggiungi un valore per spec.proxy come nell'esempio seguente.

    apiVersion: multicloud.cluster.gke.io/v1
    kind: AWSManagementService
    metadata:
      name: management
    spec:
      version: aws-1.14.1-gke.0
      proxy: PROXY_JSON_FILE
      securityGroupIDs:
      - SECURITY_GROUP_ID
      ...
    

    Sostituisci quanto segue:

    • PROXY_JSON_FILE con il percorso relativo della configurazione JSON del proxy.
    • SECURITY_GROUP_ID con l'ID di un gruppo di sicurezza con accesso al server proxy.

    Salva il file.

  3. Esegui anthos-gke aws management init per generare un file anthos-gke.status.yaml con configurazione aggiuntiva. Il comando init convalida anche l'oggetto AWSManagementService nel file anthos-gke.yaml.

    anthos-gke aws management init
    
  4. Esegui anthos-gke aws management apply per aggiornare il servizio di gestione su AWS.

    anthos-gke aws management apply
    
  5. Quindi, Crea un cluster utente. Includi il gruppo di sicurezza del proxy rispettivamente in spec.controlPlane.securityGroupIDs e spec.securityGroupIDs di AWSCluster e AWSNodePool. Il cluster ha quindi accesso al proxy.

Riferimento per la configurazione

Campo Descrizione Esempio Obbligatorio
httpProxy L'URL di un server proxy. Il valore deve includere un nome host/indirizzo IP e, facoltativamente, una porta, un nome utente e una password. "http://user:password@10.184.37.42:80"
httpsProxy Un URL del proxy per il traffico HTTPS criptato. Se non viene fornito il valore httpsProxy, verrà utilizzato l'URL httpProxy. "http://user:password@10.101.16.31:80" No
noProxy Un elenco separato da virgole di URL da escludere dal proxy. Ogni valore può essere un indirizzo IP, un intervallo CIDR, un nome di dominio o il carattere asterix (*). I domini specificati con un punto iniziale (ad es. ".google.com") indicano che è necessario un sottodominio. Un'unica sterice * indica che non è necessario eseguire alcun proxy. "1.2.3.4,10.0.0.0/16,example.com,.site.com" No

Passaggi successivi

Per saperne di più sul completamento di un'installazione di GKE su AWS, consulta quanto segue:

Per informazioni sulla modifica delle impostazioni del proxy del cluster, vedi: