Réconcilier une organisation

Le processus de rapprochement vous permet de synchroniser à nouveau toutes les métadonnées d'API (proxys, environnements, etc.) d'une organisation Apigee Edge pour Private Cloud existante dans le hub d'API. Vous utilisez généralement ce processus si vous pensez que les données sont incohérentes ou si vous avez besoin d'une nouvelle synchronisation complète de toutes les définitions d'API.

Le processus implique deux actions principales :

• Désactiver temporairement l'organisation spécifique en modifiant la configuration du connecteur
• La réactiver immédiatement

Cette séquence déclenche une nouvelle récupération et un nouvel import complets de toutes les métadonnées de cette organisation par le connecteur.

Étapes de rapprochement

Pour rapprocher une organisation, vous devez modifier deux fois le fichier de configuration du connecteur et redémarrer le service de connecteur après chaque modification.

1. Créez une sauvegarde du fichier de configuration actuel.
2. Supprimez uniquement runtimeDataPubsub et metadataPubsub de l'organisation que vous souhaitez désactiver.
3. Redémarrez le service de connecteur uapim.
4. Réactivez l'organisation actuelle en restaurant les paramètres d'origine du connecteur uapim à partir de la sauvegarde effectuée à l'étape 1.
5. Redémarrez le service de connecteur uapim.

1. Désactiver l'organisation (supprimer les sujets Pub/Sub)

   Au cours de cette étape, vous allez supprimer l'organisation des sujets Pub/Sub. Pour signaler temporairement au connecteur d'arrêter la synchronisation des métadonnées de l'organisation cible.

   • Modifiez la configuration du connecteur : ouvrez le fichier de configuration sur la VM du connecteur : /opt/apigee/customer/application/uapim-connector.properties.
   • Modifiez conf_uapim_connector.uapim.settings.json : dans la section connectorConfig, pour l'organisation que vous souhaitez rapprocher (par exemple, organization1), supprimez les valeurs de runtimeDataPubsub et metadataPubsub. Assurez-vous de laisser intacts serviceAccount et pluginInstanceId.
   • Avant la modification (exemple) :

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

   • Après la modification (désactivation de l'organisation1) :

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

   • Redémarrez le service de connecteur (désactivation) :

     Appliquez la modification en redémarrant le connecteur Apigee API Hub pour Private Cloud :

     apigee-service edge-uapim-connector restart
     

2. Réactiver l'organisation (restaurer les sujets Pub/Sub)

   Au cours de cette étape, vous allez restaurer l'organisation dans les sujets Pub/Sub. Pour signaler au connecteur de lancer une nouvelle synchronisation complète des métadonnées.

   • Modifiez la configuration du connecteur : ouvrez à nouveau le fichier de configuration :/opt/apigee/customer/application/uapim-connector.properties
   • Modifiez conf_uapim_connector.uapim.settings.json : dans la section connectorConfig, pour l'organisation que vous souhaitez rapprocher (par exemple, organization1), restaurez les valeurs de runtimeDataPubsub et metadataPubsub.
   • Après la modification (réactivation de l'organisation1) :

     {
       "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. Configuration restaurée

   Redémarrez le service de connecteur (réactivation) :

   Redémarrez à nouveau le service de connecteur pour déclencher la nouvelle synchronisation complète des métadonnées :

   apigee-service edge-uapim-connector restart
   

Le connecteur effectue désormais une réactivation complète de toutes les métadonnées d'API pour l'organisation cible. Vous pouvez surveiller la progression à l'aide du point de terminaison d'état : curl localhost:8080/v1/uapim/status.