Примирить организацию

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

Этот процесс включает в себя два основных действия:

• Временно отказаться от участия в программе конкретной организации можно, изменив конфигурацию коннектора.
• Немедленно снова включив его.

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

Этапы примирения

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

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

1. Отказаться от участия в организации (удалить темы публикаций/подразделов)

   На этом шаге вы удалите организацию из тем 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 .