Riconciliare un'organizzazione

La procedura di riconciliazione consente di sincronizzare nuovamente tutti i metadati API (proxy, ambienti e così via) di un'organizzazione Apigee Edge per il cloud privato esistente nell'hub API. In genere, questa procedura viene utilizzata se sospetti incoerenze nei dati o se è necessaria una risincronizzazione completa di tutte le definizioni API.

La procedura prevede due azioni principali:

• Disattivazione temporanea dell'organizzazione specifica modificando la configurazione del connettore
• Riattivazione immediata

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

Passaggi di riconciliazione

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

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

1. Disattiva l'organizzazione (rimuovi 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 nella 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 di 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"
     }
     

   • Dopo la modifica (disattivazione di 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 del connettore (disattivazione):

     Applica la modifica riavviando il connettore Apigee API Hub per il cloud privato:

     apigee-service edge-uapim-connector restart
     

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

   In questo passaggio, ripristinerai l'organizzazione negli argomenti Pub/Sub. Per segnalare al connettore di avviare una sincronizzazione completa e nuova 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 di runtimeDataPubsub e metadataPubsub.
   • Dopo la modifica (attivazione di organization1):

     {
       "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 esegue ora un'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.