Concilia una organización

El proceso de conciliación te permite volver a sincronizar todos los metadatos de la API (proxies, entornos, etcétera) para una organización existente de Apigee Edge para la nube privada en el centro de API. Por lo general, usas este proceso si sospechas que hay inconsistencias en los datos o si necesitas volver a sincronizar por completo todas las definiciones de la API.

El proceso incluye dos acciones principales:

• Inhabilitar temporalmente la organización específica modificando la configuración del conector
• Volver a habilitarla de inmediato

Esta secuencia activa el conector para que realice una recuperación y carga completas de todos los metadatos de esa organización nuevamente.

Pasos de conciliación

Para conciliar una organización, debes modificar el archivo de configuración del conector dos veces y reiniciar el servicio del conector después de cada modificación.

1. Haz una copia de seguridad del archivo de configuración actual.
2. Quita solo runtimeDataPubsub y metadataPubsub de la organización que deseas inhabilitar.
3. Reinicia el servicio del conector uapim.
4. Habilita la organización actual restableciendo la configuración original del conector uapim a la copia de seguridad que se tomó en el paso 1.
5. Reinicia el servicio del conector uapim.

1. Inhabilita la organización (quita los temas de Pub/Sub)

   En este paso, quitarás la organización de los temas de Pub/Sub. Para indicarle temporalmente al conector que deje de sincronizar los metadatos de la organización de destino.

   • Edita la configuración del conector: Abre el archivo de configuración en la VM del conector: /opt/apigee/customer/application/uapim-connector.properties
   • Modifica conf_uapim_connector.uapim.settings.json: En la sección connectorConfig, para la organización que deseas conciliar (p.ej., organization1), quita los valores de runtimeDataPubsub y metadataPubsub. Asegúrate de dejar intactos serviceAccount y pluginInstanceId.
   • Antes de la modificación (ejemplo):

     {
       "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"
     }
     

   • Después de la modificación (inhabilitar 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"
     }
     

   • Reinicia el servicio del conector (inhabilitar):

     Para aplicar el cambio, reinicia el conector del centro de API de Apigee para la nube privada:

     apigee-service edge-uapim-connector restart
     

2. Habilita la organización (restablece los temas de Pub/Sub)

   En este paso, restablecerás la organización en los temas de Pub/Sub. Para indicarle al conector que comience una sincronización completa y nueva de los metadatos.

   • Edita la configuración del conector: Vuelve a abrir el archivo de configuración:/opt/apigee/customer/application/uapim-connector.properties
   • Modifica conf_uapim_connector.uapim.settings.json: En la sección connectorConfig, para la organización que deseas conciliar (p.ej., organization1), restablece los valores de runtimeDataPubsub y metadataPubsub.
   • Después de la modificación (habilitar 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. Configuración restablecida

   Reinicia el servicio del conector (habilitar):

   Vuelve a reiniciar el servicio del conector para activar la resincronización completa de los metadatos:

   apigee-service edge-uapim-connector restart
   

El conector ahora realiza una habilitación completa de todos los metadatos de la API para la organización de destino. Puedes supervisar el progreso con el extremo de estado: curl localhost:8080/v1/uapim/status.