התאמה של ארגון

תהליך ההתאמה מאפשר לכם לסנכרן מחדש את כל המטא-נתונים של ה-API (פרוקסי, סביבות וכו') של ארגון קיים ב-Apigee Edge for Private Cloud אל API Hub. בדרך כלל משתמשים בתהליך הזה אם יש חשד לחוסר עקביות בנתונים או אם נדרס סנכרון מחדש מלא של כל הגדרות ה-API.

התהליך כולל שתי פעולות עיקריות:

• ביטול ההצטרפות הזמני של הארגון הספציפי על ידי שינוי ההגדרה של המחבר
• הצטרפות מחדש באופן מיידי

הרצף הזה מפעיל את המחבר כדי לבצע אחזור מלא והעלאה של כל המטא-נתונים של הארגון הזה שוב.

שלבי ההתאמה

כדי לבצע התאמה של ארגון, צריך לשנות את קובץ התצורה של המחבר פעמיים ולהפעיל מחדש את שירות המחבר אחרי כל שינוי.

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
   

המחבר מבצע עכשיו הסכמה מלאה לכל המטא-נתונים של ה-API בארגון היעד. אפשר לעקוב אחר ההתקדמות באמצעות נקודת הקצה של הסטטוס: curl localhost:8080/v1/uapim/status.