Deployment su più aree geografiche

Attualmente, stai visualizzando la versione 1.7 della documentazione ibrida Apigee. Per ulteriori informazioni, consulta la sezione Versioni supportate.

Questo argomento descrive un deployment in più aree geografiche per Apigee ibrida su GKE, Anthos GKE con deployment on-prem, RedHat OpenShift e su Microsoft® Azure Kubernetes Service (AKS). Seleziona la tua piattaforma nei prerequisiti e nelle procedure.

Le topologia per il deployment in più aree geografiche includono:

• Active-Active: se hai eseguito il deployment delle applicazioni in più località geografiche e hai bisogno di una risposta API a bassa latenza, per i tuoi deployment. Hai la possibilità di eseguire il deployment di ambienti ibridi in più località geografiche più vicine ai tuoi clienti. Ad esempio: US West Coast, US East Coast, Europa, APAC.
• Passiva attiva: quando hai un'area geografica principale e un'area geografica di failover o ripristino di emergenza.

Le aree geografiche in un deployment ibrido a più aree geografiche comunicano tramite Cassandra, come mostra la seguente immagine:

Prerequisiti

GKE

Prima di configurare la modalità ibrida per più aree geografiche, devi completare i seguenti prerequisiti:

• Configura i cluster Kubernetes in più aree geografiche con blocchi CIDR diversi
• Impostare la comunicazione tra aree geografiche
• Requisiti di Cassandra in più aree geografiche:
  • Assicurati che lo spazio dei nomi di rete del pod abbia connettività tra le aree geografiche, inclusi firewall, vpn, peering vpc e peering vNet. È il caso della maggior parte delle installazioni GKE.
  • Se lo spazio dei nomi di rete dei pod non ha connettività tra cluster (i cluster sono in esecuzione in modalità di rete "island"), abilita la funzionalità hostNetwork di Kubernetes impostando cassandra.hostNetwork: true nel file di override per tutte le aree geografiche nell'installazione di più aree geografiche ibride di Apigee.

    Per informazioni sulla funzionalità hostNetwork di Kubernetes, consulta gli spazi dei nomi host nella documentazione di Kubernetes.

  • Abilita hostNetwork sui cluster esistenti prima di espandere la configurazione di più aree geografiche in nuove aree geografiche.
  • Se è abilitato hostNetwork, assicurati che i nodi worker possano eseguire ricerche DNS inverse. Apigee cassandra utilizza la ricerca DNS sia anticipata che inversa per ottenere l'IP host durante l'avvio.
    Suggerimento: se la risoluzione DNS non funziona, prova questa soluzione alternativa.

    Aggiungi una voce host statica nel file /etc/hosts di ogni nodo worker cassandra, simile al seguente:

    echo -e "\\n127.0.1.1 ${HOSTNAME}" >> "/etc/hosts"

    o

    "\\nWORKER-NODE-IP ${HOSTNAME}" >> "/etc/hosts"

  • Apri le porte Cassandra 7000 e 7001 tra i cluster Kubernetes in tutte le aree geografiche per consentire ai nodi worker in tutte le aree geografiche e nei data center di comunicare. Vedi Configurare le porte.

Per informazioni dettagliate, consulta la documentazione di Kubernetes.

NOTA: Apigee consiglia di garantire che i tuoi server siano sincronizzati.

Diverse funzionalità come la scadenza e la revoca del token si basano su tempi di sistema precisi. Se ospiti i componenti runtime in data center diversi, assicurati che gli orari del sistema siano sincronizzati.

Puoi utilizzare uno strumento come ntpdate per verificare che i tempi del server siano sincronizzati.

GKE On-Prem

Prima di configurare la modalità ibrida per più aree geografiche, devi completare i seguenti prerequisiti:

• Configura i cluster Kubernetes in più aree geografiche con blocchi CIDR diversi
• Impostare la comunicazione tra aree geografiche
• Requisiti di Cassandra in più aree geografiche:
  • Se lo spazio dei nomi di rete dei pod non ha connettività tra cluster (i cluster sono in esecuzione in modalità di rete "island", il caso predefinito nelle installazioni GKE on-prem), abilita la funzionalità hostNetwork di Kubernetes impostando cassandra.hostNetwork: true nel file di override per tutte le aree geografiche nell'installazione di più aree geografiche ibride di Apigee.

    Per informazioni sulla funzionalità hostNetwork di Kubernetes, consulta gli spazi dei nomi host nella documentazione di Kubernetes.

  • Abilita hostNetwork sui cluster esistenti prima di espandere la configurazione di più aree geografiche in nuove aree geografiche.
  • Se è abilitato hostNetwork, assicurati che i nodi worker possano eseguire ricerche DNS inverse. Apigee cassandra utilizza la ricerca DNS sia anticipata che inversa per ottenere l'IP host durante l'avvio.
    Suggerimento: se la risoluzione DNS non funziona, prova questa soluzione alternativa.

    Aggiungi una voce host statica nel file /etc/hosts di ogni nodo worker cassandra, simile al seguente:

    echo -e "\\n127.0.1.1 ${HOSTNAME}" >> "/etc/hosts"

    o

    "\\nWORKER-NODE-IP ${HOSTNAME}" >> "/etc/hosts"

  • Apri le porte Cassandra 7000 e 7001 tra i cluster Kubernetes in tutte le aree geografiche per consentire ai nodi worker in tutte le aree geografiche e nei data center di comunicare. Vedi Configurare le porte.

Per informazioni dettagliate, consulta la documentazione di Kubernetes.

NOTA: Apigee consiglia di garantire che i tuoi server siano sincronizzati.

Diverse funzionalità come la scadenza e la revoca del token si basano su tempi di sistema precisi. Se ospiti i componenti runtime in data center diversi, assicurati di sincronizzare i tempi di sistema.

Puoi utilizzare uno strumento come ntpdate per verificare che i tempi del server siano sincronizzati.

alias

Prima di configurare la modalità ibrida per più aree geografiche, devi completare i seguenti prerequisiti:

• Prima di passare ai passaggi di configurazione del cluster, segui la guida all'installazione ibrida per eventuali prerequisiti, come GCP e la configurazione dell'organizzazione.
• Requisiti di Cassandra in più aree geografiche:
  • Se lo spazio dei nomi di rete dei pod non ha connettività tra cluster (i cluster sono in esecuzione in modalità di rete "island", nel caso predefinito delle installazioni AKS), abilita la funzionalità hostNetwork di Kubernetes impostando cassandra.hostNetwork: true nel file di override per tutte le aree geografiche nell'installazione di più aree geografiche ibride di Apigee.

    Per informazioni sulla funzionalità hostNetwork di Kubernetes, consulta gli spazi dei nomi host nella documentazione di Kubernetes.

  • Abilita hostNetwork sui cluster esistenti prima di espandere la configurazione di più aree geografiche in nuove aree geografiche.
  • Se è abilitato hostNetwork, assicurati che i nodi worker possano eseguire ricerche DNS inverse. Apigee cassandra utilizza la ricerca DNS sia anticipata che inversa per ottenere l'IP host durante l'avvio.
    Suggerimento: se la risoluzione DNS non funziona, prova questa soluzione alternativa.

    Aggiungi una voce host statica nel file /etc/hosts di ogni nodo worker cassandra, simile al seguente:

    echo -e "\\n127.0.1.1 ${HOSTNAME}" >> "/etc/hosts"

    o

    "\\nWORKER-NODE-IP ${HOSTNAME}" >> "/etc/hosts"

  • Apri le porte Cassandra 7000 e 7001 tra i cluster Kubernetes in tutte le aree geografiche per consentire ai nodi worker in tutte le aree geografiche e nei data center di comunicare. Vedi Configurare le porte.

Per informazioni dettagliate, consulta la documentazione di Kubernetes.

NOTA: Apigee consiglia di garantire che i tuoi server siano sincronizzati.

Diverse funzionalità come la scadenza e la revoca del token si basano su tempi di sistema precisi. Se ospiti i componenti runtime in data center diversi, assicurati che gli orari del sistema siano sincronizzati.

Puoi utilizzare uno strumento come ntpdate per verificare che i tempi del server siano sincronizzati.

periodo

Prima di configurare la modalità ibrida per più aree geografiche, devi completare i seguenti prerequisiti:

• Prima di passare ai passaggi di configurazione del cluster, segui la guida all'installazione ibrida per eventuali prerequisiti, come GCP e la configurazione dell'organizzazione.
• Requisiti di Cassandra in più aree geografiche:
  • Se lo spazio dei nomi di rete dei pod non ha connettività tra cluster (i cluster sono in esecuzione in modalità di rete "island", il caso predefinito nelle installazioni EKS), abilita la funzionalità hostNetwork di Kubernetes impostando cassandra.hostNetwork: true nel file di override per tutte le aree geografiche nell'installazione di più aree geografiche ibride di Apigee.

    Per informazioni sulla funzionalità hostNetwork di Kubernetes, consulta gli spazi dei nomi host nella documentazione di Kubernetes.

  • Abilita hostNetwork sui cluster esistenti prima di espandere la configurazione di più aree geografiche in nuove aree geografiche.
  • Se è abilitato hostNetwork, assicurati che i nodi worker possano eseguire ricerche DNS inverse. Apigee cassandra utilizza la ricerca DNS sia anticipata che inversa per ottenere l'IP host durante l'avvio.
    Suggerimento: se la risoluzione DNS non funziona, prova questa soluzione alternativa.

    Aggiungi una voce host statica nel file /etc/hosts di ogni nodo worker cassandra, simile al seguente:

    echo -e "\\n127.0.1.1 ${HOSTNAME}" >> "/etc/hosts"

    o

    "\\nWORKER-NODE-IP ${HOSTNAME}" >> "/etc/hosts"

  • Apri le porte Cassandra 7000 e 7001 tra i cluster Kubernetes in tutte le aree geografiche per consentire ai nodi worker in tutte le aree geografiche e nei data center di comunicare. Vedi Configurare le porte.

Per informazioni dettagliate, consulta la documentazione di Kubernetes.

NOTA: Apigee consiglia di garantire che i tuoi server siano sincronizzati.

Diverse funzionalità come la scadenza e la revoca del token si basano su tempi di sistema precisi. Se ospiti i componenti runtime in data center diversi, assicurati che gli orari del sistema siano sincronizzati.

Puoi utilizzare uno strumento come ntpdate per verificare che i tempi del server siano sincronizzati.

Maiusc.

Prima di configurare la modalità ibrida per più aree geografiche, devi completare i seguenti prerequisiti:

• Prima di passare ai passaggi di configurazione del cluster, segui la guida all'installazione ibrida per eventuali prerequisiti, come GCP e la configurazione dell'organizzazione.
• Requisiti di Cassandra in più aree geografiche:
  • Se lo spazio dei nomi di rete del pod non ha connettività tra cluster (i cluster sono in esecuzione in modalità di rete "island", il caso predefinito nelle installazioni OpenShift), abilita la funzionalità hostNetwork di Kubernetes impostando cassandra.hostNetwork: true nel file di override per tutte le aree geografiche nell'installazione di più aree geografiche ibride di Apigee.

    Per informazioni sulla funzionalità hostNetwork di Kubernetes, consulta gli spazi dei nomi host nella documentazione di Kubernetes.

  • Abilita hostNetwork sui cluster esistenti prima di espandere la configurazione di più aree geografiche in nuove aree geografiche.
  • Se è abilitato hostNetwork, assicurati che i nodi worker possano eseguire ricerche DNS inverse. Apigee cassandra utilizza la ricerca DNS sia anticipata che inversa per ottenere l'IP host durante l'avvio.
    Suggerimento: se la risoluzione DNS non funziona, prova questa soluzione alternativa.

    Aggiungi una voce host statica nel file /etc/hosts di ogni nodo worker cassandra, simile al seguente:

    echo -e "\\n127.0.1.1 ${HOSTNAME}" >> "/etc/hosts"

    o

    "\\nWORKER-NODE-IP ${HOSTNAME}" >> "/etc/hosts"

  • Apri le porte Cassandra 7000 e 7001 tra i cluster Kubernetes in tutte le aree geografiche per consentire ai nodi worker in tutte le aree geografiche e nei data center di comunicare. Vedi Configurare le porte.

Per informazioni dettagliate, consulta la documentazione di Kubernetes.

NOTA: Apigee consiglia di garantire che i tuoi server siano sincronizzati.

Diverse funzionalità come la scadenza e la revoca del token si basano su tempi di sistema precisi. Se ospiti i componenti runtime in data center diversi, assicurati che gli orari del sistema siano sincronizzati.

Puoi utilizzare uno strumento come ntpdate per verificare che i tempi del server siano sincronizzati.

Configurare Apigee ibrido per più aree geografiche

GKE

Importante: quando espandi Apigee ibrido in un nuovo data center a livello di area geografica, assicurati di installare la stessa versione di un ibrido presente nel tuo data center esistente. Evita di eseguire versioni ibride diverse in più data center.

Configura l'host originale a più aree geografiche

Questa sezione descrive come espandere il cluster Cassandra esistente in una nuova area geografica. Questa configurazione consente alla nuova area geografica di eseguire il bootstrap del cluster e di unirsi al data center esistente. Senza questa configurazione, i cluster Kubernetes in più aree geografiche non si conoscerebbero a vicenda.

1. Imposta il contesto kubectl sul cluster originale prima di recuperare il nome originale:

   kubectl config use-context original-cluster-name

2. Esegui il comando kubectl seguente per identificare un indirizzo host originale per Cassandra nell'area geografica corrente.

   Un indirizzo host originale consente a una nuova istanza a livello di area geografica di trovare il cluster originale al primo avvio per apprendere la topologia del cluster. L'indirizzo host di origine è designato come punto di contatto nel cluster.

   kubectl get pods -o wide -n apigee

   NAME                      READY   STATUS      RESTARTS   AGE   IP          NODE                                          NOMINATED NODE
   apigee-cassandra-default-0        1/1     Running     0          5d    10.0.0.11   gke-k8s-dc-2-default-pool-a2206492-p55d
   apigee-cassandra-default-1        1/1     Running     0          5d    10.0.2.4    gke-k8s-dc-2-default-pool-e9daaab3-tjmz
   apigee-cassandra-default-2        1/1     Running     0          5d    10.0.3.5    gke-k8s-dc-2-default-pool-e589awq3-kjch

3. Decidi quali IP restituire dal comando precedente sarà l'host di origine con più aree geografiche.
4. Nel data center 2, configura cassandra.multiRegionSeedHost e cassandra.datacenter in Gestisci componenti del piano di runtime, dove multiRegionSeedHost è uno degli IP restituiti dal comando precedente:

   cassandra:
     multiRegionSeedHost: seed_host_IP
     datacenter: data_center_name
     rack: rack_name
     hostNetwork: false

   Ad esempio:

   cassandra:
     multiRegionSeedHost: 10.0.0.11
     datacenter: "dc-2"
     rack: "ra-1"
     hostNetwork: false

5. Nel nuovo data center/area geografica, prima di installare l'ibrido, imposta gli stessi certificati e le stesse credenziali TLS in overrides_your_cluster_name.yaml come hai impostato nella prima area geografica.
   NOTA: assicurati di utilizzare gli stessi certificati e le credenziali TLS di Cassandra nel secondo data center fornito nel data center originale. Le credenziali impostate nel file degli override nel primo data center devono corrispondere a quelle specificate nel file degli override nel secondo data center. Per maggiori dettagli, vedi Configurare TLS per Cassandra.

Configura la nuova area geografica

Dopo aver configurato l'host originale, puoi configurare la nuova area geografica.

Per configurare la nuova area geografica:

1. Copia il tuo certificato dal cluster esistente nel nuovo cluster. La nuova radice della CA viene utilizzata da Cassandra e altri componenti ibridi per mTLS. Pertanto, è essenziale disporre di certificati coerenti in tutto il cluster.
   1. Imposta il contesto sullo spazio dei nomi originale:

      kubectl config use-context original-cluster-name

   2. Esporta la configurazione dello spazio dei nomi corrente in un file:

      kubectl get namespace namespace -o yaml > apigee-namespace.yaml

   3. Esporta il secret apigee-ca in un file:

      kubectl -n cert-manager get secret apigee-ca -o yaml > apigee-ca.yaml

   4. Imposta il contesto del nuovo nome del cluster dell'area geografica:

      kubectl config use-context new-cluster-name

   5. Importa la configurazione dello spazio dei nomi nel nuovo cluster. Assicurati di aggiornare "&namet" nel file se utilizzi uno spazio dei nomi diverso nella nuova area geografica:

      kubectl apply -f apigee-namespace.yaml

   6. Importa il secret nel nuovo cluster:

      kubectl -n cert-manager apply -f apigee-ca.yaml

2. Installa ibrido nella nuova area geografica. Assicurati che il file overrides_your_cluster_name.yaml includa gli stessi certificati TLS configurati nella prima area geografica, come spiegato nella sezione precedente.

   Esegui i due comandi seguenti per installare il modello ibrido nella nuova area geografica:

   Importante: quando espandi Apigee ibrido in un nuovo data center a livello di area geografica, assicurati di installare la stessa versione di un ibrido presente nel tuo data center esistente. Evita di eseguire versioni ibride diverse in più data center.

   apigeectl init -f overrides_your_cluster_name.yaml

   apigeectl apply -f overrides_your_cluster_name.yaml

3. Configura Cassandra su tutti i pod dei nuovi data center.
   1. Recupera apigeeorg dal cluster con il seguente comando:

      kubectl get apigeeorg -n apigee -o json | jq .items[].metadata.name
      

      Ad esempio:

      Ex: kubectl get apigeeorg -n apigee -o json | jq .items[].metadata.name
      "rg-hybrid-b7d3b9c"
      

   2. Crea un file di risorse personalizzate (YAML) per la replica dei dati di cassandra. Il file può avere qualsiasi nome. Negli esempi seguenti il file avrà il nome datareplication.yaml.

      Il file deve contenere quanto segue:

      apiVersion: apigee.cloud.google.com/v1alpha1
      kind: CassandraDataReplication
      metadata:
        name: REGION_EXPANSION
        namespace: NAMESPACE
      spec:
        organizationRef: APIGEEORG_VALUE
        force: false
        source:
          region: SOURCE_REGION

      Dove:

      • REGION_EXPANSION è il nome che stai assegnando a questi metadati. Puoi utilizzare qualsiasi nome.
      • NAMESPACE è lo stesso spazio dei nomi fornito in overrides.yaml. Di solito è "apigee".
      • APIGEEORG_VALUE è l'output del valore dal comando kubectl get apigeeorg -n apigee -o json | jq .items[].metadata.name nel passaggio precedente. Ad esempio, rg-hybrid-b7d3b9c
      • SOURCE_REGIONè il nome del data center nell'area geografica di origine. Questo è il valore impostato per cassandra:datacenter: in overrides.yaml.

      Ad esempio:

      apiVersion: apigee.cloud.google.com/v1alpha1
      kind: CassandraDataReplication
      metadata:
        name: region-expansion
        namespace: apigee
      spec:
        organizationRef: rg-hybrid-b7d3b9c
        force: false
        source:
          region: "dc-1"

   3. Applica CassandraDataReplication con il seguente comando:

      kubectl apply -f datareplication.yaml

   4. Verifica lo stato di ricreazione utilizzando il seguente comando.
      Nota: l'operazione di ricostruzione può richiedere fino a diverse ore a seconda delle dimensioni dei dati.

      kubectl -n apigee get apigeeds -o json | jq .items[].status.cassandraDataReplication

      I risultati dovrebbero avere il seguente aspetto:

      {
        "rebuildDetails": {
          "apigee-cassandra-default-0": {
            "state": "complete",
            "updated": 1623105760
          },
          "apigee-cassandra-default-1": {
            "state": "complete",
            "updated": 1623105765
          },
          "apigee-cassandra-default-2": {
            "state": "complete",
            "updated": 1623105770
          }
        },
        "state": "complete",
        "updated": 1623105770
      }

4. Verifica i processi di ricostruzione dai log. Inoltre, verifica la dimensione dei dati utilizzando il comando nodetool status:

   kubectl logs apigee-cassandra-default-0 -f -n apigee

   kubectl exec apigee-cassandra-default-0 -n apigee  -- nodetool -u JMX_user -pw JMX_password status

   L'esempio seguente mostra voci di log di esempio:

   INFO  01:42:24 rebuild from dc: dc-1, (All keyspaces), (All tokens)
   INFO  01:42:24 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Executing streaming plan for Rebuild
   INFO  01:42:24 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.1.45
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.1.45
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.4.36
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 1 files(0.432KiB), sending 0 files(0.000KiB)
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.1.45 is complete
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.4.36
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.5.22
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 1 files(0.693KiB), sending 0 files(0.000KiB)
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.4.36 is complete
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.5.22
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 3 files(0.720KiB), sending 0 files(0.000KiB)
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.5.22 is complete
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] All sessions completed

5. Aggiorna gli host originali. Rimuovi multiRegionSeedHost: 10.0.0.11 da overrides-DC_name.yaml e presenta nuovamente la domanda.
   Gli host di origine sono membri del cluster locale. Per avviare una nuova area geografica è necessario un host originale esterno. Dopo l'avvio di un'area geografica, devi ripristinare gli host originali ai relativi cluster locali in overrides.yaml, quindi applicare nuovamente la configurazione.

   apigeectl apply -f overrides/overrides-DC_name.yaml

Verificare lo stato del cluster Cassandra

Il seguente comando è utile per vedere se la configurazione del cluster è riuscita in due data center. Il comando controlla lo stato dello strumento dei nodi per le due aree geografiche.

kubectl exec apigee-cassandra-default-0 -n apigee  -- nodetool -u JMX_user -pw JMX_password status

Datacenter: dc-1
================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address     Load       Tokens       Owns (effective)  Host ID                               Rack
UN  10.12.1.45  112.09 KiB  256          100.0%            3c98c816-3f4d-48f0-9717-03d0c998637f  ra-1
UN  10.12.4.36  95.27 KiB  256          100.0%            0a36383d-1d9e-41e2-924c-7b62be12d6cc  ra-1
UN  10.12.5.22  88.7 KiB   256          100.0%            3561f4fa-af3d-4ea4-93b2-79ac7e938201  ra-1
Datacenter: dc-2
================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address     Load       Tokens       Owns (effective)  Host ID                               Rack
UN  10.0.4.33   78.69 KiB  256          0.0%              a200217d-260b-45cd-b83c-182b27ff4c99  ra-1
UN  10.0.0.21   78.68 KiB  256          0.0%              9f3364b9-a7a1-409c-9356-b7d1d312e52b  ra-1
UN  10.0.1.26   15.46 KiB  256          0.0%              1666df0f-702e-4c5b-8b6e-086d0f2e47fa  ra-1

GKE On-Prem

Importante: quando espandi Apigee ibrido in un nuovo data center a livello di area geografica, assicurati di installare la stessa versione di un ibrido presente nel tuo data center esistente. Evita di eseguire versioni ibride diverse in più data center.

Configura l'host originale a più aree geografiche

Questa sezione descrive come espandere il cluster Cassandra esistente in una nuova area geografica. Questa configurazione consente alla nuova area geografica di eseguire il bootstrap del cluster e di unirsi al data center esistente. Senza questa configurazione, i cluster Kubernetes in più aree geografiche non si conoscerebbero a vicenda.

1. Nel file overrides.yaml per il cluster originale, assicurati che cassandra:hostNetwork sia impostato su true. Ad esempio:

   cassandra:
     hostNetwork: true

   Consulta la sezione Prerequisiti per maggiori informazioni su quando impostare hostNetwork: true.

2. Imposta il contesto kubectl sul cluster originale prima di recuperare il nome originale:

   kubectl config use-context original-cluster-name

3. Esegui il comando kubectl seguente per identificare un indirizzo host originale per Cassandra nell'area geografica corrente.

   Un indirizzo host originale consente a una nuova istanza a livello di area geografica di trovare il cluster originale al primo avvio per apprendere la topologia del cluster. L'indirizzo host di origine è designato come punto di contatto nel cluster.

   kubectl get pods -o wide -n apigee

   NAME                      READY   STATUS      RESTARTS   AGE   IP          NODE                                          NOMINATED NODE
   apigee-cassandra-default-0        1/1     Running     0          5d    10.0.0.11   gke-k8s-dc-2-default-pool-a2206492-p55d
   apigee-cassandra-default-1        1/1     Running     0          5d    10.0.2.4    gke-k8s-dc-2-default-pool-e9daaab3-tjmz
   apigee-cassandra-default-2        1/1     Running     0          5d    10.0.3.5    gke-k8s-dc-2-default-pool-e589awq3-kjch

4. Decidi quali IP restituire dal comando precedente sarà l'host di origine con più aree geografiche.
5. Nel data center 2, configura cassandra.multiRegionSeedHost nel file di override, dove multiRegionSeedHost è uno degli IP restituiti dal comando precedente:

   cassandra:
     hostNetwork: true
     multiRegionSeedHost: seed_host_IP
     datacenter: data_center_name

   Ad esempio:

   cassandra:
     hostNetwork: true
     multiRegionSeedHost: 10.0.0.11
     datacenter: "dc-2"

6. Nel nuovo data center/area geografica, prima di installare l'ibrido, imposta gli stessi certificati e le stesse credenziali TLS in overrides_your_cluster_name.yaml come hai impostato nella prima area geografica.
   NOTA: assicurati di utilizzare gli stessi certificati e le credenziali TLS di Cassandra nel secondo data center fornito nel data center originale. Le credenziali impostate nel file degli override nel primo data center devono corrispondere a quelle specificate nel file degli override nel secondo data center. Per maggiori dettagli, vedi Configurare TLS per Cassandra.

Configura la nuova area geografica

Dopo aver configurato l'host originale, puoi configurare la nuova area geografica.

Per configurare la nuova area geografica:

1. Copia il tuo certificato dal cluster esistente nel nuovo cluster. La nuova radice della CA viene utilizzata da Cassandra e altri componenti ibridi per mTLS. Pertanto, è essenziale disporre di certificati coerenti in tutto il cluster.
   1. Imposta il contesto sullo spazio dei nomi originale:

      kubectl config use-context original-cluster-name

   2. Esporta la configurazione dello spazio dei nomi corrente in un file:

      kubectl get namespace namespace -o yaml > apigee-namespace.yaml

   3. Esporta il secret apigee-ca in un file:

      kubectl -n cert-manager get secret apigee-ca -o yaml > apigee-ca.yaml

   4. Imposta il contesto del nuovo nome del cluster dell'area geografica:

      kubectl config use-context new-cluster-name

   5. Importa la configurazione dello spazio dei nomi nel nuovo cluster. Assicurati di aggiornare "&namet" nel file se utilizzi uno spazio dei nomi diverso nella nuova area geografica:

      kubectl apply -f apigee-namespace.yaml

   6. Importa il secret nel nuovo cluster:

      kubectl -n cert-manager apply -f apigee-ca.yaml

2. Installa ibrido nella nuova area geografica. Assicurati che il file overrides_your_cluster_name.yaml includa gli stessi certificati TLS configurati nella prima area geografica, come spiegato nella sezione precedente.

   Esegui i due comandi seguenti per installare il modello ibrido nella nuova area geografica:

   Importante: quando espandi Apigee ibrido in un nuovo data center a livello di area geografica, assicurati di installare la stessa versione di un ibrido presente nel tuo data center esistente. Evita di eseguire versioni ibride diverse in più data center.

   apigeectl init -f overrides_your_cluster_name.yaml

   apigeectl apply -f overrides_your_cluster_name.yaml

3. Configura Cassandra su tutti i pod dei nuovi data center.
   1. Recupera apigeeorg dal cluster con il seguente comando:

      kubectl get apigeeorg -n apigee -o json | jq .items[].metadata.name
      

      Ad esempio:

      Ex: kubectl get apigeeorg -n apigee -o json | jq .items[].metadata.name
      "rg-hybrid-b7d3b9c"
      

   2. Crea un file di risorse personalizzate (YAML) per la replica dei dati di cassandra. Il file può avere qualsiasi nome. Negli esempi seguenti il file avrà il nome datareplication.yaml.

      Il file deve contenere quanto segue:

      apiVersion: apigee.cloud.google.com/v1alpha1
      kind: CassandraDataReplication
      metadata:
        name: REGION_EXPANSION
        namespace: NAMESPACE
      spec:
        organizationRef: APIGEEORG_VALUE
        force: false
        source:
          region: SOURCE_REGION

      Dove:

      • REGION_EXPANSION è il nome che stai assegnando a questi metadati. Puoi utilizzare qualsiasi nome.
      • NAMESPACE è lo stesso spazio dei nomi fornito in overrides.yaml. Di solito è"apigee".
      • APIGEEORG_VALUE è l'output del valore dal comando kubectl get apigeeorg -n apigee -o json | jq .items[].metadata.name nel passaggio precedente. Ad esempio, rg-hybrid-b7d3b9c
      • SOURCE_REGIONè il nome del data center nell'area geografica di origine. Questo è il valore impostato per cassandra:datacenter: in overrides.yaml.

      Ad esempio:

      apiVersion: apigee.cloud.google.com/v1alpha1
      kind: CassandraDataReplication
      metadata:
        name: region-expansion
        namespace: apigee
      spec:
        organizationRef: rg-hybrid-b7d3b9c
        force: false
        source:
          region: "dc-1"

   3. Applica CassandraDataReplication con il seguente comando:

      kubectl apply -f datareplication.yaml

   4. Verifica lo stato di ricreazione utilizzando il seguente comando.
      Nota: l'operazione di ricostruzione può richiedere fino a diverse ore a seconda delle dimensioni dei dati.

      kubectl -n apigee get apigeeds -o json | jq .items[].status.cassandraDataReplication

      I risultati dovrebbero avere il seguente aspetto:

      {
        "rebuildDetails": {
          "apigee-cassandra-default-0": {
            "state": "complete",
            "updated": 1623105760
          },
          "apigee-cassandra-default-1": {
            "state": "complete",
            "updated": 1623105765
          },
          "apigee-cassandra-default-2": {
            "state": "complete",
            "updated": 1623105770
          }
        },
        "state": "complete",
        "updated": 1623105770
      }

4. Verifica i processi di ricostruzione dai log. Inoltre, verifica la dimensione dei dati utilizzando il comando nodetool status:

   kubectl logs apigee-cassandra-default-0 -f -n apigee

   kubectl exec apigee-cassandra-default-0 -n apigee  -- nodetool -u JMX_user -pw JMX_password status

   L'esempio seguente mostra voci di log di esempio:

   INFO  01:42:24 rebuild from dc: dc-1, (All keyspaces), (All tokens)
   INFO  01:42:24 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Executing streaming plan for Rebuild
   INFO  01:42:24 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.1.45
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.1.45
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.4.36
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 1 files(0.432KiB), sending 0 files(0.000KiB)
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.1.45 is complete
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.4.36
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.5.22
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 1 files(0.693KiB), sending 0 files(0.000KiB)
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.4.36 is complete
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.5.22
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 3 files(0.720KiB), sending 0 files(0.000KiB)
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.5.22 is complete
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] All sessions completed

5. Aggiorna gli host originali. Rimuovi multiRegionSeedHost: 10.0.0.11 da overrides-DC_name.yaml e presenta nuovamente la domanda.
   Gli host di origine sono membri del cluster locale. Per avviare una nuova area geografica è necessario un host originale esterno. Dopo l'avvio di un'area geografica, devi ripristinare gli host originali ai relativi cluster locali in overrides.yaml, quindi applicare nuovamente la configurazione.

   apigeectl apply -f overrides/overrides-DC_name.yaml

Verificare lo stato del cluster Cassandra

Il seguente comando è utile per vedere se la configurazione del cluster è riuscita in due data center. Il comando controlla lo stato dello strumento dei nodi per le due aree geografiche.

kubectl exec apigee-cassandra-default-0 -n apigee  -- nodetool -u JMX_user -pw JMX_password status

Datacenter: dc-1
================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address     Load       Tokens       Owns (effective)  Host ID                               Rack
UN  10.12.1.45  112.09 KiB  256          100.0%            3c98c816-3f4d-48f0-9717-03d0c998637f  ra-1
UN  10.12.4.36  95.27 KiB  256          100.0%            0a36383d-1d9e-41e2-924c-7b62be12d6cc  ra-1
UN  10.12.5.22  88.7 KiB   256          100.0%            3561f4fa-af3d-4ea4-93b2-79ac7e938201  ra-1
Datacenter: dc-2
================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address     Load       Tokens       Owns (effective)  Host ID                               Rack
UN  10.0.4.33   78.69 KiB  256          0.0%              a200217d-260b-45cd-b83c-182b27ff4c99  ra-1
UN  10.0.0.21   78.68 KiB  256          0.0%              9f3364b9-a7a1-409c-9356-b7d1d312e52b  ra-1
UN  10.0.1.26   15.46 KiB  256          0.0%              1666df0f-702e-4c5b-8b6e-086d0f2e47fa  ra-1

alias

Importante: quando espandi Apigee ibrido in un nuovo data center a livello di area geografica, assicurati di installare la stessa versione di un ibrido presente nel tuo data center esistente. Evita di eseguire versioni ibride diverse in più data center.

Crea una rete virtuale in ogni area geografica

Segui i consigli di Azure per stabilire la comunicazione tra aree geografiche qui: VNet-to-VNet: Connessione di reti virtuali in Azure in diverse aree geografiche.

Crea cluster su più aree geografiche

Configura i cluster Kubernetes in più aree geografiche con blocchi CIDR diversi. Vedi anche il Passaggio 1: crea un cluster. Utilizza i nomi delle località e delle reti virtuali che hai creato in precedenza.

Le porte 7000 e 7001 di Cassandra aperte tra i cluster Kubernetes in tutte le aree geografiche (7000 possono essere utilizzate come opzione di backup durante la risoluzione dei problemi)

Configura l'host originale a più aree geografiche

Questa sezione descrive come espandere il cluster Cassandra esistente in una nuova area geografica. Questa configurazione consente alla nuova area geografica di eseguire il bootstrap del cluster e di unirsi al data center esistente. Senza questa configurazione, i cluster Kubernetes in più aree geografiche non si conoscerebbero a vicenda.

1. Nel file overrides.yaml per il cluster originale, assicurati che cassandra:hostNetwork sia impostato su true. Ad esempio:

   cassandra:
     hostNetwork: true

   Consulta la sezione Prerequisiti per maggiori informazioni su quando impostare hostNetwork: true.

2. Imposta il contesto kubectl sul cluster originale prima di recuperare il nome originale:

   kubectl config use-context original-cluster-name

3. Esegui il comando kubectl seguente per identificare un indirizzo host originale per Cassandra nell'area geografica corrente.

   Un indirizzo host originale consente a una nuova istanza a livello di area geografica di trovare il cluster originale al primo avvio per apprendere la topologia del cluster. L'indirizzo host di origine è designato come punto di contatto nel cluster.

   kubectl get pods -o wide -n apigee | grep apigee-cassandra

   apigee-cassandra-default-0  1/1   Running   0   4d17h   120.38.1.9  aks-agentpool-21207753-vmss000000

4. Decidi quali IP restituire dal comando precedente sarà l'host di origine con più aree geografiche. In questo esempio, dove è in esecuzione un solo cluster cassandra, l'host originale è 120.38.1.9.
5. Nel data center 2, copia il file di override in un nuovo file il cui nome include il nome del cluster. Ad esempio, overrides_your_cluster_name.yaml.
6. Nel data center 2, configura cassandra.multiRegionSeedHost e cassandra.datacenter in overrides_your_cluster_name.yaml, dove multiRegionSeedHost è uno degli IP restituiti dal comando precedente:

   cassandra:
        multiRegionSeedHost: seed_host_IP
        datacenter: data_center_name
        rack: rack_name
        hostNetwork: true

   Ad esempio:

   cassandra:
     multiRegionSeedHost: 120.38.1.9
     datacenter: "dc-2"
     rack: "ra-1"
     hostNetwork: true

7. Nel nuovo data center/area geografica, prima di installare l'ibrido, imposta gli stessi certificati e le stesse credenziali TLS in overrides_your_cluster_name.yaml come hai impostato nella prima area geografica.
   NOTA: assicurati di utilizzare gli stessi certificati e le credenziali TLS di Cassandra nel secondo data center fornito nel data center originale. Le credenziali impostate nel file degli override nel primo data center devono corrispondere a quelle specificate nel file degli override nel secondo data center. Per maggiori dettagli, vedi Configurare TLS per Cassandra.

Configura la nuova area geografica

Dopo aver configurato l'host originale, puoi configurare la nuova area geografica.

Per configurare la nuova area geografica:

1. Copia il tuo certificato dal cluster esistente nel nuovo cluster. La nuova radice della CA viene utilizzata da Cassandra e altri componenti ibridi per mTLS. Pertanto, è essenziale disporre di certificati coerenti in tutto il cluster.
   1. Imposta il contesto sullo spazio dei nomi originale:

      kubectl config use-context original-cluster-name

   2. Esporta la configurazione dello spazio dei nomi corrente in un file:

      kubectl get namespace namespace -o yaml > apigee-namespace.yaml

   3. Esporta il secret apigee-ca in un file:

      kubectl -n cert-manager get secret apigee-ca -o yaml > apigee-ca.yaml

   4. Imposta il contesto del nuovo nome del cluster dell'area geografica:

      kubectl config use-context new-cluster-name

   5. Importa la configurazione dello spazio dei nomi nel nuovo cluster. Assicurati di aggiornare "&namet" nel file se utilizzi uno spazio dei nomi diverso nella nuova area geografica:

      kubectl apply -f apigee-namespace.yaml

   6. Importa il secret nel nuovo cluster:

      kubectl -n cert-manager apply -f apigee-ca.yaml

2. Installa ibrido nella nuova area geografica. Assicurati che il file overrides_your_cluster_name.yaml includa gli stessi certificati TLS configurati nella prima area geografica, come spiegato nella sezione precedente.

   Esegui i due comandi seguenti per installare il modello ibrido nella nuova area geografica:

   Importante: quando espandi Apigee ibrido in un nuovo data center a livello di area geografica, assicurati di installare la stessa versione di un ibrido presente nel tuo data center esistente. Evita di eseguire versioni ibride diverse in più data center.

   apigeectl init -f overrides_your_cluster_name.yaml

   apigeectl apply -f overrides_your_cluster_name.yaml

3. Configura Cassandra su tutti i pod dei nuovi data center.
   1. Recupera apigeeorg dal cluster con il seguente comando:

      kubectl get apigeeorg -n apigee -o json | jq .items[].metadata.name
      

      Ad esempio:

      Ex: kubectl get apigeeorg -n apigee -o json | jq .items[].metadata.name
      "rg-hybrid-b7d3b9c"
      

   2. Crea un file di risorse personalizzate (YAML) per la replica dei dati di cassandra. Il file può avere qualsiasi nome. Negli esempi seguenti il file avrà il nome datareplication.yaml.

      Il file deve contenere quanto segue:

      apiVersion: apigee.cloud.google.com/v1alpha1
      kind: CassandraDataReplication
      metadata:
        name: REGION_EXPANSION
        namespace: NAMESPACE
      spec:
        organizationRef: APIGEEORG_VALUE
        force: false
        source:
          region: SOURCE_REGION

      Dove:

      • REGION_EXPANSION è il nome che stai assegnando a questi metadati. Puoi utilizzare qualsiasi nome.
      • NAMESPACE è lo stesso spazio dei nomi fornito in overrides.yaml. Di solito è "apigee".
      • APIGEEORG_VALUE è l'output del valore dal comando kubectl get apigeeorg -n apigee -o json | jq .items[].metadata.name nel passaggio precedente. Ad esempio, rg-hybrid-b7d3b9c
      • SOURCE_REGIONè il nome del data center nell'area geografica di origine. Questo è il valore impostato per cassandra:datacenter: in overrides.yaml.

      Ad esempio:

      apiVersion: apigee.cloud.google.com/v1alpha1
      kind: CassandraDataReplication
      metadata:
        name: region-expansion
        namespace: apigee
      spec:
        organizationRef: rg-hybrid-b7d3b9c
        force: false
        source:
          region: "dc-1"

   3. Applica CassandraDataReplication con il seguente comando:

      kubectl apply -f datareplication.yaml

   4. Verifica lo stato di ricreazione utilizzando il seguente comando.
      Nota: l'operazione di ricostruzione può richiedere fino a diverse ore a seconda delle dimensioni dei dati.

      kubectl -n apigee get apigeeds -o json | jq .items[].status.cassandraDataReplication

      I risultati dovrebbero avere il seguente aspetto:

      {
        "rebuildDetails": {
          "apigee-cassandra-default-0": {
            "state": "complete",
            "updated": 1623105760
          },
          "apigee-cassandra-default-1": {
            "state": "complete",
            "updated": 1623105765
          },
          "apigee-cassandra-default-2": {
            "state": "complete",
            "updated": 1623105770
          }
        },
        "state": "complete",
        "updated": 1623105770
      }

4. Verifica i processi di ricostruzione dai log. Inoltre, verifica la dimensione dei dati utilizzando il comando nodetool status:

   kubectl logs apigee-cassandra-default-0 -f -n apigee

   kubectl exec apigee-cassandra-default-0 -n apigee  -- nodetool -u JMX_user -pw JMX_password status

   L'esempio seguente mostra voci di log di esempio:

   INFO  01:42:24 rebuild from dc: dc-1, (All keyspaces), (All tokens)
   INFO  01:42:24 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Executing streaming plan for Rebuild
   INFO  01:42:24 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.1.45
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.1.45
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.4.36
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 1 files(0.432KiB), sending 0 files(0.000KiB)
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.1.45 is complete
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.4.36
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.5.22
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 1 files(0.693KiB), sending 0 files(0.000KiB)
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.4.36 is complete
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.5.22
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 3 files(0.720KiB), sending 0 files(0.000KiB)
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.5.22 is complete
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] All sessions completed

5. Aggiorna gli host originali. Rimuovi multiRegionSeedHost: 10.0.0.11 da overrides-DC_name.yaml e presenta nuovamente la domanda.
   Gli host di origine sono membri del cluster locale. Per avviare una nuova area geografica è necessario un host originale esterno. Dopo l'avvio di un'area geografica, devi ripristinare gli host originali ai relativi cluster locali in overrides.yaml, quindi applicare nuovamente la configurazione.

   apigeectl apply -f overrides/overrides-DC_name.yaml

Verificare lo stato del cluster Cassandra

Il seguente comando è utile per vedere se la configurazione del cluster è riuscita in due data center. Il comando controlla lo stato dello strumento dei nodi per le due aree geografiche.

kubectl exec apigee-cassandra-default-0 -n apigee  -- nodetool -u JMX_user -pw JMX_password status

Datacenter: dc-1
================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address     Load       Tokens       Owns (effective)  Host ID                               Rack
UN  10.12.1.45  112.09 KiB  256          100.0%            3c98c816-3f4d-48f0-9717-03d0c998637f  ra-1
UN  10.12.4.36  95.27 KiB  256          100.0%            0a36383d-1d9e-41e2-924c-7b62be12d6cc  ra-1
UN  10.12.5.22  88.7 KiB   256          100.0%            3561f4fa-af3d-4ea4-93b2-79ac7e938201  ra-1
Datacenter: dc-2
================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address     Load       Tokens       Owns (effective)  Host ID                               Rack
UN  10.0.4.33   78.69 KiB  256          0.0%              a200217d-260b-45cd-b83c-182b27ff4c99  ra-1
UN  10.0.0.21   78.68 KiB  256          0.0%              9f3364b9-a7a1-409c-9356-b7d1d312e52b  ra-1
UN  10.0.1.26   15.46 KiB  256          0.0%              1666df0f-702e-4c5b-8b6e-086d0f2e47fa  ra-1

Maiusc.

Importante: quando espandi Apigee ibrido in un nuovo data center a livello di area geografica, assicurati di installare la stessa versione di un ibrido presente nel tuo data center esistente. Evita di eseguire versioni ibride diverse in più data center.

Configura l'host originale a più aree geografiche

Questa sezione descrive come espandere il cluster Cassandra esistente in una nuova area geografica. Questa configurazione consente alla nuova area geografica di eseguire il bootstrap del cluster e di unirsi al data center esistente. Senza questa configurazione, i cluster Kubernetes in più aree geografiche non si conoscerebbero a vicenda.

1. Nel file overrides.yaml per il cluster originale, assicurati che cassandra:hostNetwork sia impostato su true. Ad esempio:

   cassandra:
     hostNetwork: true

   Consulta la sezione Prerequisiti per maggiori informazioni su quando impostare hostNetwork: true.

2. Imposta il contesto kubectl sul cluster originale prima di recuperare il nome originale:

   kubectl config use-context original-cluster-name

3. Esegui il comando kubectl seguente per identificare un indirizzo host originale per Cassandra nell'area geografica corrente.

   Un indirizzo host originale consente a una nuova istanza a livello di area geografica di trovare il cluster originale al primo avvio per apprendere la topologia del cluster. L'indirizzo host di origine è designato come punto di contatto nel cluster.

   kubectl get pods -o wide -n apigee

   NAME                      READY   STATUS      RESTARTS   AGE   IP          NODE                                          NOMINATED NODE
   apigee-cassandra-default-0        1/1     Running     0          5d    10.0.0.11   gke-k8s-dc-2-default-pool-a2206492-p55d
   apigee-cassandra-default-1        1/1     Running     0          5d    10.0.2.4    gke-k8s-dc-2-default-pool-e9daaab3-tjmz
   apigee-cassandra-default-2        1/1     Running     0          5d    10.0.3.5    gke-k8s-dc-2-default-pool-e589awq3-kjch

4. Seleziona l'indirizzo IP dell'host Cassandra di origine da utilizzare come host originale per più aree geografiche. In questo esempio, si tratta del cluster apigee-cassandra-default-0 in esecuzione, l'host originale è 10.0.0.11.
5. Nel data center 2, copia il file di override in un nuovo file il cui nome include il nome del cluster. Ad esempio, overrides_your_cluster_name.yaml.
6. Nel data center 2, configura cassandra.multiRegionSeedHost e cassandra.datacenter in overrides_your_cluster_name.yaml, dove multiRegionSeedHost è uno degli IP restituiti dal comando precedente:

   cassandra:
        hostNetwork: true
        multiRegionSeedHost: seed_host_IP # Cassandra pod IP address from the source region.
        datacenter: data_center_name

   Ad esempio:

   cassandra:
     hostNetwork: true
     multiRegionSeedHost: 10.0.0.11
     datacenter: "dc-2"

7. Nel nuovo data center/area geografica, prima di installare l'ibrido, imposta gli stessi certificati e le stesse credenziali TLS in overrides_your_cluster_name.yaml come hai impostato nella prima area geografica.
   NOTA: assicurati di utilizzare gli stessi certificati e le credenziali TLS di Cassandra nel secondo data center fornito nel data center originale. Le credenziali impostate nel file degli override nel primo data center devono corrispondere a quelle specificate nel file degli override nel secondo data center. Per maggiori dettagli, vedi Configurare TLS per Cassandra.

Configura la nuova area geografica

Dopo aver configurato l'host originale, puoi configurare la nuova area geografica.

Per configurare la nuova area geografica:

1. Copia il tuo certificato dal cluster esistente nel nuovo cluster. La nuova radice della CA viene utilizzata da Cassandra e altri componenti ibridi per mTLS. Pertanto, è essenziale disporre di certificati coerenti in tutto il cluster.
   1. Imposta il contesto sullo spazio dei nomi originale:

      kubectl config use-context original-cluster-name

   2. Esporta la configurazione dello spazio dei nomi corrente in un file:

      kubectl get namespace namespace -o yaml > apigee-namespace.yaml

   3. Esporta il secret apigee-ca in un file:

      kubectl -n cert-manager get secret apigee-ca -o yaml > apigee-ca.yaml

   4. Imposta il contesto del nuovo nome del cluster dell'area geografica:

      kubectl config use-context new-cluster-name

   5. Importa la configurazione dello spazio dei nomi nel nuovo cluster. Assicurati di aggiornare "&namet" nel file se utilizzi uno spazio dei nomi diverso nella nuova area geografica:

      kubectl apply -f apigee-namespace.yaml

   6. Importa il secret nel nuovo cluster:

      kubectl -n cert-manager apply -f apigee-ca.yaml

2. Installa ibrido nella nuova area geografica. Assicurati che il file overrides_your_cluster_name.yaml includa gli stessi certificati TLS configurati nella prima area geografica, come spiegato nella sezione precedente.

   Esegui i due comandi seguenti per installare il modello ibrido nella nuova area geografica:

   Importante: quando espandi Apigee ibrido in un nuovo data center a livello di area geografica, assicurati di installare la stessa versione di un ibrido presente nel tuo data center esistente. Evita di eseguire versioni ibride diverse in più data center.

   apigeectl init -f overrides_your_cluster_name.yaml

   apigeectl apply -f overrides_your_cluster_name.yaml

3. Configura Cassandra su tutti i pod dei nuovi data center.
   1. Recupera apigeeorg dal cluster con il seguente comando:

      kubectl get apigeeorg -n apigee -o json | jq .items[].metadata.name
      

      Ad esempio:

      Ex: kubectl get apigeeorg -n apigee -o json | jq .items[].metadata.name
      "rg-hybrid-b7d3b9c"
      

   2. Crea un file di risorse personalizzate (YAML) per la replica dei dati di cassandra. Il file può avere qualsiasi nome. Negli esempi seguenti il file avrà il nome datareplication.yaml.

      Il file deve contenere quanto segue:

      apiVersion: apigee.cloud.google.com/v1alpha1
      kind: CassandraDataReplication
      metadata:
        name: REGION_EXPANSION
        namespace: NAMESPACE
      spec:
        organizationRef: APIGEEORG_VALUE
        force: false
        source:
          region: SOURCE_REGION

      Dove:

      • REGION_EXPANSION è il nome che stai assegnando a questi metadati. Puoi utilizzare qualsiasi nome.
      • NAMESPACE è lo stesso spazio dei nomi fornito in overrides.yaml. Di solito è"apigee".
      • APIGEEORG_VALUE è l'output del valore dal comando kubectl get apigeeorg -n apigee -o json | jq .items[].metadata.name nel passaggio precedente. Ad esempio, rg-hybrid-b7d3b9c
      • SOURCE_REGIONè il nome del data center nell'area geografica di origine. Questo è il valore impostato per cassandra:datacenter: in overrides.yaml.

      Ad esempio:

      apiVersion: apigee.cloud.google.com/v1alpha1
      kind: CassandraDataReplication
      metadata:
        name: region-expansion
        namespace: apigee
      spec:
        organizationRef: rg-hybrid-b7d3b9c
        force: false
        source:
          region: "dc-1"

   3. Applica CassandraDataReplication con il seguente comando:

      kubectl apply -f datareplication.yaml

   4. Verifica lo stato di ricreazione utilizzando il seguente comando.
      Nota: l'operazione di ricostruzione può richiedere fino a diverse ore a seconda delle dimensioni dei dati.

      kubectl -n apigee get apigeeds -o json | jq .items[].status.cassandraDataReplication

      I risultati dovrebbero avere il seguente aspetto:

      {
        "rebuildDetails": {
          "apigee-cassandra-default-0": {
            "state": "complete",
            "updated": 1623105760
          },
          "apigee-cassandra-default-1": {
            "state": "complete",
            "updated": 1623105765
          },
          "apigee-cassandra-default-2": {
            "state": "complete",
            "updated": 1623105770
          }
        },
        "state": "complete",
        "updated": 1623105770
      }

4. Verifica i processi di ricostruzione dai log. Inoltre, verifica la dimensione dei dati utilizzando il comando nodetool status:

   kubectl logs apigee-cassandra-default-0 -f -n apigee

   kubectl exec apigee-cassandra-default-0 -n apigee  -- nodetool -u JMX_user -pw JMX_password status

   L'esempio seguente mostra voci di log di esempio:

   INFO  01:42:24 rebuild from dc: dc-1, (All keyspaces), (All tokens)
   INFO  01:42:24 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Executing streaming plan for Rebuild
   INFO  01:42:24 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.1.45
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.1.45
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.4.36
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 1 files(0.432KiB), sending 0 files(0.000KiB)
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.1.45 is complete
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.4.36
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.5.22
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 1 files(0.693KiB), sending 0 files(0.000KiB)
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.4.36 is complete
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.5.22
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 3 files(0.720KiB), sending 0 files(0.000KiB)
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.5.22 is complete
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] All sessions completed

5. Aggiorna gli host originali. Rimuovi multiRegionSeedHost: 10.0.0.11 da overrides-DC_name.yaml e presenta nuovamente la domanda.
   Gli host di origine sono membri del cluster locale. Per avviare una nuova area geografica è necessario un host originale esterno. Dopo l'avvio di un'area geografica, devi ripristinare gli host originali ai relativi cluster locali in overrides.yaml, quindi applicare nuovamente la configurazione.

   apigeectl apply -f overrides/overrides-DC_name.yaml

Verificare lo stato del cluster Cassandra

Il seguente comando è utile per vedere se la configurazione del cluster è riuscita in due data center. Il comando controlla lo stato dello strumento dei nodi per le due aree geografiche.

kubectl exec apigee-cassandra-default-0 -n apigee  -- nodetool -u JMX_user -pw JMX_password status

Datacenter: dc-1
================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address     Load       Tokens       Owns (effective)  Host ID                               Rack
UN  10.12.1.45  112.09 KiB  256          100.0%            3c98c816-3f4d-48f0-9717-03d0c998637f  ra-1
UN  10.12.4.36  95.27 KiB  256          100.0%            0a36383d-1d9e-41e2-924c-7b62be12d6cc  ra-1
UN  10.12.5.22  88.7 KiB   256          100.0%            3561f4fa-af3d-4ea4-93b2-79ac7e938201  ra-1
Datacenter: dc-2
================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address     Load       Tokens       Owns (effective)  Host ID                               Rack
UN  10.0.4.33   78.69 KiB  256          0.0%              a200217d-260b-45cd-b83c-182b27ff4c99  ra-1
UN  10.0.0.21   78.68 KiB  256          0.0%              9f3364b9-a7a1-409c-9356-b7d1d312e52b  ra-1
UN  10.0.1.26   15.46 KiB  256          0.0%              1666df0f-702e-4c5b-8b6e-086d0f2e47fa  ra-1

Risolvere i problemi

Vedi Errore di replica dei dati di Casandra.