Как сопоставить организацию

Процесс сверки позволяет повторно синхронизировать все метаданные API (прокси, среды и т. д.) для существующей организации Apigee Edge для частного облака с API Hub. Обычно этот процесс используется, если вы подозреваете несоответствие данных или вам требуется полная повторная синхронизация всех определений API.

Процесс состоит из двух основных действий:

• Временно отключить определенную организацию, изменив конфигурацию коннектора.
• немедленно включить его обратно;

Эта последовательность действий заставляет коннектор выполнить полную выборку и загрузку всех метаданных для организации.

Как выполнить сверку

Чтобы согласовать организацию, дважды измените файл конфигурации коннектора и перезапустите сервис коннектора после каждого изменения.

1. Создайте резервную копию текущего файла конфигурации.
2. Удалите из организации, которую хотите исключить, только runtimeDataPubsub и metadataPubsub.
3. Перезапустите сервис коннектора uapim.
4. Включите текущую организацию, восстановив исходные настройки коннектора uapim из резервной копии, созданной на шаге 1.
5. Перезапустите сервис коннектора uapim.

1. Отключить организацию (удалить темы издатель-подписчик)

   На этом шаге вы удалите организацию из тем издатель-подписчик. Временно запретить коннектору синхронизировать метаданные для целевой организации.

   • Измените конфигурацию коннектора. Откройте файл конфигурации на виртуальной машине коннектора: /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 для частного облака:

     apigee-service edge-uapim-connector restart
     

2. Включите организацию (восстановите темы издателя-подписчика)

   На этом шаге вы восстанавливаете организацию в темах издатель-подписчик. Чтобы дать коннектору сигнал начать полную синхронизацию метаданных.

   • Измените конфигурацию коннектора. Снова откройте файл конфигурации:/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.