فرایند تطبیق به شما امکان می‌دهد همه فراداده‌های میانای برنامه‌سازی کاربردی (پراکسی‌ها، محیط‌ها، و غیره) را برای سازمان Apigee Edge for Private Cloud موجود در API Hub دوباره همگام‌سازی کنید. معمولاً اگر به ناهماهنگی داده‌ها مشکوک باشید یا به همگام‌سازی مجدد کامل همه تعریف‌های API نیاز داشته باشید از این فرایند استفاده می‌کنید.
این فرایند شامل دو کنش اصلی است:
- انصراف موقت از سازمان خاص با اصلاح پیکربندی اتصال‌دهنده
- بلافاصله آن را دوباره فعال می‌کنیم
مراحل تطبیق
برای تطبیق دادن سازمان، فایل پیکربندی رابط را دوبار تغییر می‌دهید و سرویس رابط را پس‌از هر تغییر بازراه‌اندازی می‌کنید.
- از فایل پیکربندی کنونی نسخه پشتیبان تهیه کنید.
- فقط runtimeDataPubsub و metadataPubsub را از سازمانی که می‌خواهید انصراف دهید بردارید.
- سرویس رابط uapim را بازراه‌اندازی کنید.
- با بازیابی تنظیمات اصلی اتصال‌دهنده uapim به پشتیبان‌گیری انجام‌شده در «مرحله ۱»، سازمان کنونی را موافقت کنید.
- سرویس رابط uapim را بازراه‌اندازی کنید.
انصراف دادن از سازمان (برداشتن موضوعات 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" } پس‌از اصلاح (سازمان انصراف‌دهنده ۱):
{ "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" }بازراه‌اندازی سرویس رابط (انصراف):
با بازراه‌اندازی رابط «مرکز API Apigee برای ابر خصوصی»، تغییر را اعمال کنید:
apigee-service edge-uapim-connector restart
- ویرایش پیکربندی اتصال‌دهنده: فایل پیکربندی را در ماشین مجازی اتصال‌دهنده باز کنید:
موافقت با سازمان (بازیابی موضوعات Pub/Sub)
در این مرحله، سازمان را به موضوعات Pub/Sub بازگردانید. برای اینکه به اتصال‌دهنده علامت دهید همگام‌سازی کامل و جدیدی از فراداده را شروع کند.
- ویرایش پیکربندی رابط: فایل پیکربندی را دوباره باز کنید:
/opt/apigee/customer/application/uapim-connector.properties - تغییر conf_uapim_connector.uapim.settings.json: در بخش connectorConfig، برای سازمانی که قصد آشتی دادن آن را دارید (برای نمونه، organization1)، مقادیر runtimeDataPubsub و metadataPubsub را بازیابی کنید.
- پس‌از اصلاح (سازمان موافقت‌کننده ۱):
{ "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" }
- ویرایش پیکربندی رابط: فایل پیکربندی را دوباره باز کنید:
پیکربندی بازیابی‌شده
بازراه‌اندازی سرویس رابط (موافقت کردن):
برای راه‌اندازی مجدد همگام‌سازی مجدد فراداده کامل، سرویس رابط را دوباره بازراه‌اندازی کنید:
apigee-service edge-uapim-connector restart
اکنون اتصال‌دهنده برای سازمان هدف، موافقت کامل با همه فراداده‌های میانای برنامه‌سازی کاربردی را انجام می‌دهد. می‌توانید پیشرفت را بااستفاده از نقطه پایانی وضعیت نظارت کنید: curl localhost:8080/v1/uapim/status.