Riconciliare un'organizzazione

Il processo di riconciliazione consente di sincronizzare nuovamente tutti i metadati API (proxy, ambienti e così via) per un'organizzazione Apigee Edge for Private Cloud esistente nell'hub API. In genere, utilizzi questa procedura se sospetti incoerenze nei dati o se è necessaria una risincronizzazione completa di tutte le definizioni API.

La procedura prevede due azioni principali:

• Disattivare temporaneamente l'organizzazione specifica modificando la configurazione del connettore
• Riattivandolo immediatamente

Questa sequenza attiva il connettore per eseguire nuovamente un recupero e un caricamento completi di tutti i metadati per l'organizzazione.

Passaggi per la riconciliazione

Per riconciliare un'organizzazione, modifica due volte il file di configurazione del connettore e riavvia il servizio del connettore dopo ogni modifica.

1. Esegui un backup del file di configurazione corrente.
2. Rimuovi solo runtimeDataPubsub e metadataPubsub dall'organizzazione per cui vuoi disattivare la funzionalità.
3. Riavvia il servizio del connettore uapim.
4. Attiva l'organizzazione corrente ripristinando le impostazioni originali del connettore uapim nel backup eseguito nel passaggio 1.
5. Riavvia il servizio del connettore uapim.

1. Disattivare l'organizzazione (rimuovere gli argomenti Pub/Sub)

   In questo passaggio, rimuoverai l'organizzazione dagli argomenti Pub/Sub. Per segnalare temporaneamente al connettore di interrompere la sincronizzazione dei metadati per l'organizzazione di destinazione.

   • Modifica la configurazione del connettore:apri il file di configurazione sulla VM del connettore: /opt/apigee/customer/application/uapim-connector.properties
   • Modifica conf_uapim_connector.uapim.settings.json: nella sezione connectorConfig, per l'organizzazione che intendi riconciliare (ad es. organization1), rimuovi i valori per runtimeDataPubsub e metadataPubsub. Assicurati di lasciare intatti serviceAccount e pluginInstanceId.
   • Prima della modifica (esempio):

     {
       "connectorConfig" : { 
         "organization1" : { 
           "runtimeDataPubsub" : "projects/p1/topics/rt-topic-org1", 
           "metadataPubsub":"projects/p1/topics/md-topic-org1",
           "serviceAccount": "mysa1@in.myfirstProject",
           "pluginInstanceId":"aaaa"
         }, 
         "organization2" : { 
           "runtimeDataPubsub" : "projects/p2/topics/rt-topic-org2", 
           "metadataPubsub":"projects/p2/topics/md-topic-org2",
           "serviceAccount": "mysa2@in.mySecondProject",
           "pluginInstanceId":"bbbbb"
         }
       },
       "runtimeDataPath":"/the/nfs/mounted/path",
       "managementServer": "hostname"
     }
     

   • After modification (Opt-out organization1):

     {
       "connectorConfig" : { 
         "organization1" : { 
           "runtimeDataPubsub" : "", 
           "metadataPubsub":"",
           "serviceAccount": "mysa1@in.myfirstProject",
           "pluginInstanceId":"aaaa"
         }, 
         "organization2" : { 
           "runtimeDataPubsub" : "projects/p2/topics/rt-topic-org2", 
           "metadataPubsub":"projects/p2/topics/md-topic-org2",
           "serviceAccount": "mysa2@in.mySecondProject",
           "pluginInstanceId":"bbbbb"
         }
       },
       "runtimeDataPath":"/the/nfs/mounted/path",
       "managementServer": "hostname"
     }
     

   • Riavvia il servizio connettore (disattivazione):

     Applica la modifica riavviando il connettore dell'hub delle API Apigee per Private Cloud:

     apigee-service edge-uapim-connector restart
     

2. Attivare l'organizzazione (ripristina gli argomenti Pub/Sub)

   In questo passaggio, ripristini l'organizzazione negli argomenti Pub/Sub. Per segnalare al connettore di avviare una sincronizzazione completa e aggiornata dei metadati.

   • Modifica la configurazione del connettore:apri di nuovo il file di configurazione:/opt/apigee/customer/application/uapim-connector.properties
   • Modifica conf_uapim_connector.uapim.settings.json: nella sezione connectorConfig, per l'organizzazione che intendi riconciliare (ad es. organization1), ripristina i valori per runtimeDataPubsub e metadataPubsub.
   • Dopo la modifica (organizzazione1 con attivazione):

     {
       "connectorConfig" : { 
         "organization1" : { 
           "runtimeDataPubsub" : "projects/p1/topics/rt-topic-org1", 
           "metadataPubsub":"projects/p1/topics/md-topic-org1",
           "serviceAccount": "mysa1@in.myfirstProject",
           "pluginInstanceId":"aaaa"
         }, 
         "organization2" : { 
           "runtimeDataPubsub" : "projects/p2/topics/rt-topic-org2", 
           "metadataPubsub":"projects/p2/topics/md-topic-org2",
           "serviceAccount": "mysa2@in.mySecondProject",
           "pluginInstanceId":"bbbbb"
         }
       },
       "runtimeDataPath":"/the/nfs/mounted/path",
       "managementServer": "hostname"
     }
     

3. Configurazione ripristinata

   Riavvia il servizio del connettore (attivazione):

   Riavvia di nuovo il servizio del connettore per attivare la risincronizzazione completa dei metadati:

   apigee-service edge-uapim-connector restart
   

Il connettore ora esegue l'attivazione completa di tutti i metadati API per l'organizzazione di destinazione. Puoi monitorare l'avanzamento utilizzando l'endpoint di stato: curl localhost:8080/v1/uapim/status.