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