Fazer conciliação de uma organização

O processo de reconciliação permite resincronizar todos os metadados da API (proxies, ambientes etc.) de uma organização do Apigee Edge para nuvem privada no hub de APIs. Normalmente, você usa esse processo se suspeitar de inconsistências de dados ou precisar de uma resincronização completa de todas as definições de API.

O processo envolve duas ações principais:

• Desativar temporariamente a organização específica modificando a configuração do conector
• Ativar novamente imediatamente

Essa sequência aciona o conector para realizar uma busca e upload completos de todos os metadados dessa organização novamente.

Etapas de reconciliação

Para reconciliar uma organização, modifique o arquivo de configuração do conector duas vezes e reinicie o serviço do conector após cada modificação.

1. Faça um backup do arquivo de configuração atual.
2. Remova apenas runtimeDataPubsub e metadataPubsub da organização que você quer desativar.
3. Reinicie o serviço do conector uapim.
4. Ative a organização atual restaurando as configurações originais do conector uapim para o backup feito na etapa 1.
5. Reinicie o serviço do conector uapim.

1. Desativar a organização (remover tópicos do Pub/Sub)

   Nesta etapa, você vai remover a organização dos tópicos do Pub/Sub. Para sinalizar temporariamente o conector para interromper a sincronização de metadados da organização de destino.

   • Edite a configuração do conector:abra o arquivo de configuração na VM do conector: /opt/apigee/customer/application/uapim-connector.properties
   • Modifique conf_uapim_connector.uapim.settings.json:na seção connectorConfig, para a organização que você pretende reconciliar (por exemplo, organization1), remova os valores de runtimeDataPubsub e metadataPubsub. Deixe serviceAccount e pluginInstanceId intactos.
   • Antes da modificação (exemplo):

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

   • Após a modificação (desativar 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"
     }
     

   • Reinicie o serviço do conector (desativar):

     Aplique a mudança reiniciando o conector do hub de APIs da Apigee para nuvem privada:

     apigee-service edge-uapim-connector restart
     

2. Ativar a organização (restaurar tópicos do Pub/Sub)

   Nesta etapa, você restaura a organização para os tópicos do Pub/Sub. Para sinalizar o conector para iniciar uma sincronização completa e nova de metadados.

   • Edite a configuração do conector:abra o arquivo de configuração novamente:/opt/apigee/customer/application/uapim-connector.properties
   • Modifique conf_uapim_connector.uapim.settings.json: na seção connectorConfig, para a organização que você pretende reconciliar (por exemplo, organization1), restaure os valores de runtimeDataPubsub e metadataPubsub.
   • Após a modificação (ativar 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. Configuração restaurada

   Reinicie o serviço do conector (ativar):

   Reinicie o serviço do conector novamente para acionar a resincronização completa de metadados:

   apigee-service edge-uapim-connector restart
   

O conector agora realiza uma ativação completa de todos os metadados da API para a organização de destino. É possível monitorar o progresso usando o endpoint de status: curl localhost:8080/v1/uapim/status.