Réconcilier une organisation

Le processus de réconciliation vous permet de resynchroniser toutes les métadonnées d'API (proxys, environnements, etc.) d'une organisation Apigee Edge for Private Cloud existante dans le hub d'API. Vous utilisez généralement ce processus si vous suspectez des incohérences de données ou si vous avez besoin d'une resynchronisation complète de toutes les définitions d'API.

Ce processus comprend deux actions principales :

• Désactiver temporairement l'organisation spécifique en modifiant la configuration du connecteur
• en réactivant immédiatement la fonctionnalité.

Cette séquence déclenche à nouveau l'extraction et l'importation complètes de toutes les métadonnées pour cette organisation par le connecteur.

Étapes de rapprochement

Pour réconcilier 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. Sauvegardez le 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. 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)

   Dans 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 pour 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 réconcilier (par exemple, "organization1"), supprimez les valeurs de "runtimeDataPubsub" et "metadataPubsub". Assurez-vous de laisser intacts les champs "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 modification (désactivation de l'organisation 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"
     }
     

   • 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. Activer l'organisation (restaurer les sujets Pub/Sub)

   Au cours de cette étape, vous allez restaurer l'organisation dans les sujets Pub/Sub. Indique 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 réconcilier (par exemple, "organization1"), restaurez les valeurs de "runtimeDataPubsub" et "metadataPubsub".
   • Après modification (organisation 1 avec activation) :

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

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

   apigee-service edge-uapim-connector restart
   

Le connecteur active désormais 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.