Fazer conciliação de uma organização

O processo de reconciliação permite resincronizar todos os metadados de 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 nos dados ou precisar de uma nova sincronizaçã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
• ativando imediatamente

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

Etapas de reconciliação

Para conciliar 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 ao conector que ele pare de sincronizar 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ê quer reconciliar (por exemplo, "organization1"), remova os valores de "runtimeDataPubsub" e "metadataPubsub". Deixe os campos 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 (desativação da organização 1):

     {
       "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 (recusa):

     Para aplicar a mudança, reinicie 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 ao conector que ele precisa iniciar uma sincronização completa e atualizada 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ê quer conciliar (por exemplo, "organization1"), restaure os valores de "runtimeDataPubsub" e "metadataPubsub".
   • Após a modificação (ativação da organização 1):

     {
       "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 (ativação):

   Reinicie o serviço do conector novamente para acionar a ressincronização completa dos metadados:

   apigee-service edge-uapim-connector restart
   

O conector agora faz 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.