Menyesuaikan organisasi

Proses rekonsiliasi memungkinkan Anda menyinkronkan ulang semua metadata API (proxy, lingkungan, dll.) untuk organisasi Apigee Edge untuk Private Cloud yang ada ke API Hub. Anda biasanya menggunakan proses ini jika menduga adanya inkonsistensi data atau memerlukan sinkronisasi ulang penuh semua definisi API.

Proses ini melibatkan dua tindakan utama:

• Menonaktifkan organisasi tertentu untuk sementara dengan mengubah konfigurasi konektor
• Segera mengaktifkannya kembali

Urutan ini memicu konektor untuk melakukan pengambilan dan upload penuh semua metadata untuk organisasi tersebut lagi.

Langkah-langkah rekonsiliasi

Untuk menyelaraskan organisasi, Anda mengubah file konfigurasi konektor dua kali dan memulai ulang layanan konektor setelah setiap perubahan.

1. Buat cadangan file konfigurasi saat ini.
2. Hanya hapus runtimeDataPubsub dan metadataPubsub dari organisasi yang ingin Anda batalkan keikutsertaannya.
3. Mulai ulang layanan konektor uapim.
4. Aktifkan organisasi saat ini dengan memulihkan setelan konektor uapim asli ke cadangan yang diambil di Langkah 1.
5. Mulai ulang layanan konektor uapim.

1. Menonaktifkan organisasi (Menghapus topik Pub/Sub)

   Pada langkah ini, Anda akan menghapus organisasi dari topik Pub/Sub. Untuk memberi sinyal sementara kepada konektor agar berhenti menyinkronkan metadata untuk organisasi target.

   • Edit konfigurasi konektor: Buka file konfigurasi di VM konektor: /opt/apigee/customer/application/uapim-connector.properties
   • Ubah conf_uapim_connector.uapim.settings.json: Di bagian connectorConfig, untuk organisasi yang ingin Anda rekonsiliasi (misalnya, organization1), hapus nilai untuk runtimeDataPubsub dan metadataPubsub. Pastikan Anda tidak mengubah serviceAccount dan pluginInstanceId.
   • Sebelum modifikasi (contoh):

     {
       "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"
     }
     

   • Setelah modifikasi (Opt-out organization1):

     {
       "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"
     }
     

   • Mulai ulang layanan konektor (memilih tidak ikut):

     Terapkan perubahan dengan memulai ulang konektor Apigee API Hub untuk Cloud Pribadi:

     apigee-service edge-uapim-connector restart
     

2. Mengizinkan organisasi (Memulihkan topik Pub/Sub)

   Pada langkah ini, Anda akan memulihkan organisasi ke topik Pub/Sub. Untuk memberi sinyal kepada konektor agar memulai sinkronisasi metadata yang baru dan lengkap.

   • Edit konfigurasi konektor: Buka kembali file konfigurasi:/opt/apigee/customer/application/uapim-connector.properties
   • Ubah conf_uapim_connector.uapim.settings.json: Di bagian connectorConfig, untuk organisasi yang ingin Anda rekonsiliasi (misalnya, organization1), pulihkan nilai untuk runtimeDataPubsub dan metadataPubsub.
   • Setelah modifikasi (Organisasi1 yang memilih untuk mengaktifkan):

     {
       "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. Konfigurasi yang dipulihkan

   Mulai ulang layanan konektor (Ikut serta):

   Mulai ulang layanan konektor lagi untuk memicu sinkronisasi ulang metadata lengkap:

   apigee-service edge-uapim-connector restart
   

Konektor kini melakukan keikutsertaan penuh semua metadata API untuk organisasi target. Anda dapat memantau progres menggunakan endpoint status: curl localhost:8080/v1/uapim/status.