Crea una subnet globale per il bilanciamento del carico interno

Questa pagina ti guida nella creazione di una subnet globale in Google Distributed Cloud (GDC) air-gapped e nell'utilizzo di questa subnet per un bilanciatore del carico interno (ILB).

Le subnet globali consentono di configurare le operazioni di bilanciamento del carico interno in più zone dell'organizzazione GDC. Il bilanciamento del carico offre i vantaggi di prestazioni, affidabilità e disponibilità migliorate di applicazioni e servizi distribuendo il traffico di rete su più server. Per saperne di più sulle subnet globali per il bilanciamento del carico, consulta Informazioni sulle subnet per il bilanciamento del carico.

Questa pagina è rivolta agli sviluppatori del gruppo di operatori di applicazioni che vogliono gestire il bilanciamento del carico per la propria organizzazione. Per saperne di più, consulta Pubblici per la documentazione di GDC con air gap .

Prima di iniziare

Per creare una subnet globale e configurarla per gli ILB, devi avere:

  • La proprietà del progetto per cui stai configurando il bilanciatore del carico. Per saperne di più, consulta Creare un progetto.
  • I ruoli di identità e accesso necessari:

    • Chiedi all'amministratore IAM dell'organizzazione di concederti il ruolo Amministratore del bilanciatore del carico (load-balancer-admin).
    • Chiedi all'amministratore IAM dell'organizzazione di concederti il ruolo Amministratore del bilanciatore del carico globale (global-load-balancer-admin).
    • Chiedi all'amministratore IAM dell'organizzazione di concederti il ruolo Amministratore dell'organizzazione della subnet (subnet-org-admin). Si tratta di un ruolo di amministratore della piattaforma per l'organizzazione.
    • Chiedi all'amministratore IAM dell'organizzazione di concederti il ruolo Amministratore del progetto della subnet (subnet-project-admin). Si tratta di un ruolo di Application Operator per il progetto.

    Per saperne di più, consulta Descrizioni dei ruoli predefiniti.

Creare una subnet globale principale

La subnet globale principale che crei in questa sezione funge da pool di indirizzi IP da cui provengono gli indirizzi IP dell'ILB. Specifichi i genitori della subnet utilizzando il campo spec.parentReference.name. Hai due opzioni per configurare il CIDR per questa subnet principale:

Per saperne di più sulla differenza tra le configurazioni CIDR statiche e dinamiche, consulta Configurazione CIDR statica e dinamica.

Creare una subnet utilizzando una configurazione CIDR statica

Utilizza una configurazione CIDR statica quando hai bisogno di un controllo preciso sullo spazio degli indirizzi IP. Questa subnet ha un tipo Branch. Per saperne di più sui tipi di subnet root, branch, e leaf, consulta Gerarchia delle subnet.

Per creare una subnet globale principale con una configurazione CIDR statica, aggiungi il blocco CIDR scelto al campo spec.ipv4Request.cidr:

kubectl --kubeconfig GLOBAL_API_SERVER apply -f - <<EOF
apiVersion: ipam.global.gdc.goog/v1
kind: Subnet
metadata:
  labels:
    ipam.gdc.goog/vpc: default-vpc
  name: ILB_PARENT_SUBNET_NAME
  namespace: platform
spec:
  ipv4Request:
    cidr: STATIC_CIDR
  parentReference:
    name: PARENT_NAME
    namespace: platform
  propagationStrategy: None
  type: Branch
EOF

Sostituisci quanto segue:

  • GLOBAL_API_SERVER: il percorso kubeconfig del server API di gestione globale. Per saperne di più, consulta Server API globali e zonali servers. Se non hai ancora generato un file kubeconfig per il server API, consulta Accedi per i dettagli.
  • ILB_PARENT_SUBNET_NAME: il nome scelto per la subnet globale principale per l'ILB.
  • STATIC_CIDR: il blocco CIDR specifico che vuoi allocare per questa subnet principale, ad esempio 10.0.10.0/27.
  • PARENT_NAME: il nome della subnet principale esistente da cui viene creata questa nuova subnet.

Per configurare questa subnet in modo che funzioni con gli ILB, devi creare una subnet leaf per l'ILB.

Creare una subnet utilizzando una configurazione CIDR dinamica

La configurazione CIDR dinamica alloca automaticamente un blocco CIDR disponibile di una dimensione specificata dalla subnet principale. Ciò semplifica la gestione degli indirizzi IP, soprattutto in ambienti di grandi dimensioni. Questa subnet ha un tipo Branch. Per saperne di più sui tipi di subnet root, branch, e leaf, consulta Gerarchia delle subnet.

Per creare una subnet globale principale con un CIDR dinamico, configura il campo spec.ipv4Request.prefixLength con la lunghezza del prefisso scelta:

kubectl --kubeconfig GLOBAL_API_SERVER apply -f - <<EOF
apiVersion: ipam.global.gdc.goog/v1
kind: Subnet
metadata:
  labels:
    ipam.gdc.goog/vpc: default-vpc
  name: ILB_PARENT_SUBNET_NAME
  namespace: platform
spec:
  ipv4Request:
    prefixLength: PREFIX_LENGTH
  parentReference:
    name: PARENT_NAME
    namespace: platform
  propagationStrategy: None
  type: Branch

EOF

Sostituisci quanto segue:

  • ILB_PARENT_SUBNET_NAME: il nome scelto per la subnet principale ILB, ad esempio lb-global-lancer-ilb-subnet.
  • STATIC_CIDR: il blocco CIDR specifico che vuoi utilizzare, ad esempio 10.0.10.0/27. Questa variabile è applicabile solo alla configurazione CIDR statica.
  • PARENT_NAME: il nome della subnet principale esistente da cui viene creata questa nuova subnet, ad esempio default-vpc-workload-cidr.
  • PREFIX_LENGTH: la lunghezza del prefisso scelta per il CIDR allocato dinamicamente, ad esempio 27. Questa variabile è applicabile solo alla configurazione CIDR dinamica.

Per configurare questa subnet in modo che funzioni con gli ILB, devi creare una subnet leaf per l'ILB.

Creare una subnet leaf per l'ILB

Dopo aver configurato la subnet globale principale, devi creare una subnet leaf per allocare un singolo indirizzo IP per il servizio ILB globale. Questa subnet leaf deve avere un valore del campo type di Leaf e deve risiedere nello stesso spazio dei nomi del progetto delle risorse del bilanciatore del carico, come ForwardingRule, BackendService e Backend.

Per creare la subnet leaf e collegarla all'ILB:

  1. Crea una subnet leaf con un valore prefixLength di 32, in quanto è destinata ad allocare un singolo indirizzo IP. Il valore parentReference fa riferimento alla subnet globale principale creata in precedenza:

    kubectl --kubeconfig GLOBAL_API_SERVER apply -f - <<EOF
    apiVersion: ipam.global.gdc.goog/v1
    kind: Subnet
    metadata:
      labels:
        ipam.gdc.goog/allocation-preference: default
        ipam.gdc.goog/vpc: default-vpc
      name: ILB_IP_SUBNET_NAME
      namespace: PROJECT_NAMESPACE
    spec:
      ipv4Request:
        prefixLength: 32
      parentReference:
        name: PARENT_REF
        namespace: platform
      type: Leaf
    EOF
    

    Sostituisci quanto segue:

    • ILB_IP_SUBNET_NAME: il nome scelto per la subnet leaf, ad esempio lb-project-ilb-ip.
    • PROJECT_NAMESPACE: lo spazio dei nomi Kubernetes corrispondente al progetto in cui si trovano gli oggetti ILB, ad esempio lb-project.
    • PARENT_REF: il nome della subnet principale da cui questa subnet leaf ricava l'indirizzo IP, ad esempio la subnet globale principale creata in precedenza.
  2. Collega la subnet leaf appena creata, che contiene l'indirizzo IP allocato, alla risorsa ForwardingRuleInternal dell'ILB. Nella risorsa ForwardingRuleInternal, aggiorna il campo spec.cidrRef.name in modo che faccia riferimento al nome della subnet leaf creata nel passaggio precedente:

    kubectl --kubeconfig GLOBAL_API_SERVER apply -f - <<EOF
    apiVersion: networking.global.gdc.goog/v1
    kind: ForwardingRuleInternal
    metadata:
      name: FRI_NAME
      namespace: PROJECT_NAMESPACE
    spec:
      ports:
        - port: PORT
          protocol: PROTOCOL
      backendServiceRef:
        name: BES_NAME
      cidrRef:
        name: LEAF_SUBNET_NAME
    EOF
    

    Sostituisci quanto segue:

    • FRI_NAME: il nome scelto per l'oggetto ForwardingRuleInternal, ad esempio nginx-ilb-static-fr.
    • PORT: il numero di porta su cui l'ILB è in ascolto per il traffico in entrata, ad esempio 80.
    • PROTOCOL: il protocollo di rete utilizzato dall'ILB, ad esempio TCP o UDP.
    • BES_NAME: il nome di BackendService associato a questa risorsa ForwardingRuleInternal, ad esempio nginx-bes.
    • LEAF_SUBNET_NAME: il nome della subnet leaf creata nel passaggio precedente, ad esempio lb-project-ilb-ip.