تسوية حساب مؤسسة

تتيح لك عملية المطابقة إعادة مزامنة جميع البيانات الوصفية لواجهة برمجة التطبيقات (الخوادم الوكيلة والبيئات وما إلى ذلك) لمؤسسة حالية في Apigee Edge للسحابة الإلكترونية الخاصة إلى API Hub. تستخدم هذه العملية عادةً إذا كنت تشك في عدم اتساق البيانات أو كنت بحاجة إلى إعادة مزامنة كاملة لجميع تعريفات واجهة برمجة التطبيقات.

تتضمّن العملية إجراءَين رئيسيَّين:

• إيقاف المؤسسة المحدّدة مؤقتًا من خلال تعديل إعدادات الموصّل
• تفعيلها مرة أخرى على الفور

يؤدي هذا التسلسل إلى أن يجلب الموصل جميع البيانات الوصفية الخاصة بهذه المؤسسة ويحمّلها بالكامل مرة أخرى.

خطوات التسوية

لربط مؤسسة، عليك تعديل ملف إعداد الموصل مرتين وإعادة تشغيل خدمة الموصل بعد كل تعديل.

1. احتفِظ بنسخة احتياطية من ملف الإعداد الحالي.
2. أزِل فقط runtimeDataPubsub وmetadataPubsub من المؤسسة التي تريد إيقاف المشاركة فيها.
3. أعِد تشغيل خدمة موصّل uapim.
4. وافِق على استخدام المؤسسة الحالية من خلال استعادة إعدادات موصّل uapim الأصلية إلى النسخة الاحتياطية التي تم إنشاؤها في الخطوة 1.
5. أعِد تشغيل خدمة موصّل uapim.

1. إيقاف المؤسسة (إزالة مواضيع Pub/Sub)

   في هذه الخطوة، ستزيل المؤسسة من مواضيع Pub/Sub. لإيقاف مزامنة بيانات التعريف الخاصة بالمؤسسة المستهدَفة مؤقتًا.

   • تعديل إعدادات الموصل: افتح ملف الإعداد على الجهاز الافتراضي للموصل: /opt/apigee/customer/application/uapim-connector.properties
   • تعديل ملف conf_uapim_connector.uapim.settings.json: في قسم connectorConfig، بالنسبة إلى المؤسسة التي تريد تسوية بياناتها (مثل organization1)، أزِل قيم runtimeDataPubsub وmetadataPubsub. تأكَّد من عدم تغيير serviceAccount وpluginInstanceId.
   • قبل التعديل (مثال):

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

   • بعد التعديل (إيقاف الاشتراك في المؤسسة 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"
     }
     

   • أعِد تشغيل خدمة الموصل (إيقاف):

     طبِّق التغيير من خلال إعادة تشغيل موصِّل Apigee API Hub for Private Cloud:

     apigee-service edge-uapim-connector restart
     

2. الموافقة على مشاركة المؤسسة (استعادة مواضيع Pub/Sub)

   في هذه الخطوة، عليك استعادة المؤسسة إلى مواضيع Pub/Sub. لإرسال إشارة إلى أداة الربط لبدء مزامنة كاملة وجديدة للبيانات الوصفية

   • تعديل إعدادات الموصل: افتح ملف الإعداد مرة أخرى:/opt/apigee/customer/application/uapim-connector.properties
   • تعديل ملف conf_uapim_connector.uapim.settings.json: في قسم connectorConfig، بالنسبة إلى المؤسسة التي تريد تسوية بياناتها (مثل organization1)، استعِد قيم runtimeDataPubsub وmetadataPubsub.
   • بعد التعديل (المؤسسة 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. الإعدادات التي تمّت استعادتها

   أعِد تشغيل خدمة الموصل (يجب الموافقة على تفعيل الميزة):

   أعِد تشغيل خدمة الموصل مرة أخرى لتفعيل إعادة المزامنة الكاملة للبيانات الوصفية:

   apigee-service edge-uapim-connector restart
   

يُجري الموصّل الآن عملية تفعيل كاملة لجميع البيانات الوصفية لواجهة برمجة التطبيقات للمؤسسة المستهدَفة. يمكنك مراقبة مستوى التقدّم باستخدام نقطة النهاية الخاصة بالحالة: curl localhost:8080/v1/uapim/status.