Concilia una organización

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

El proceso implica dos acciones principales:

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

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

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. Crea una copia de seguridad del archivo de configuración actual.
2. Quita solo runtimeDataPubsub y metadataPubsub de la organización de la que deseas inhabilitar la suscripción.
3. Reinicia el servicio del conector de uapim.
4. Habilita la organización actual restableciendo la configuración original del conector de uapim a la copia de seguridad que se creó en el paso 1.
5. Reinicia el servicio del conector de 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. Indica temporalmente al conector que detenga la sincronización de los metadatos de la organización objetivo.

   • 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 los campos 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 (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"
     }
     

   • Reinicia el servicio del conector (inhabilitación):

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

     apigee-service edge-uapim-connector restart
     

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

   En este paso, restablecerás la organización en los temas de Pub/Sub. Indica 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 (organización1 que acepta):

     {
       "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 (habilitación):

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

   apigee-service edge-uapim-connector restart
   

Ahora, el conector habilita por completo 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.