Uzgodnij organizację

Proces uzgadniania umożliwia ponowną synchronizację wszystkich metadanych interfejsów API (serwerów proxy, środowisk itp.) z istniejącej organizacji Apigee Edge dla chmury prywatnej z centrum interfejsów API. Zwykle używasz tego procesu, jeśli podejrzewasz niespójności danych lub potrzebujesz pełnej ponownej synchronizacji wszystkich definicji interfejsu API.

Proces ten obejmuje 2 główne działania:

  • tymczasowe wyłączenie konkretnej organizacji przez zmianę konfiguracji łącznika;
  • natychmiastowe ponowne włączenie.
Ta sekwencja powoduje, że łącznik ponownie pobiera i przesyła wszystkie metadane tej organizacji.

Etapy uzgodnienia

Aby uzgodnić organizację, dwukrotnie zmodyfikuj plik konfiguracji oprogramowania sprzęgającego i po każdej modyfikacji ponownie uruchom usługę oprogramowania sprzęgającego.

  1. Utwórz kopię zapasową bieżącego pliku konfiguracji.
  2. Usuń z organizacji, z której chcesz zrezygnować, tylko runtimeDataPubsub i metadataPubsub.
  3. Ponownie uruchom usługę oprogramowania sprzęgającego uapim.
  4. Zgłoś bieżącą organizację, przywracając oryginalne ustawienia łącznika uapim do kopii zapasowej utworzonej w kroku 1.
  5. Ponownie uruchom usługę oprogramowania sprzęgającego uapim.

  1. Rezygnacja z udziału organizacji (usuwanie tematów Pub/Sub)

    W tym kroku usuniesz organizację z tematów Pub/Sub. Aby tymczasowo wysłać do łącznika sygnał zatrzymania synchronizacji metadanych dla organizacji docelowej.

    • Edytuj konfigurację łącznika: otwórz plik konfiguracji na maszynie wirtualnej łącznika: /opt/apigee/customer/application/uapim-connector.properties
    • Zmodyfikuj plik conf_uapim_connector.uapim.settings.json: w sekcji connectorConfig dla organizacji, którą chcesz uzgodnić (np. organization1), usuń wartości runtimeDataPubsub i metadataPubsub. Nie zmieniaj wartości serviceAccount i pluginInstanceId.
    • Przed modyfikacją (przykład):
      {
  "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"
}

    • Po modyfikacji (rezygnacja z organizacji1):

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

    • Uruchom ponownie usługę łącznika (rezygnacja):

      Zastosuj zmianę, ponownie uruchamiając oprogramowanie sprzęgające centrum interfejsów API w Apigee dla chmury prywatnej:

      apigee-service edge-uapim-connector restart

  2. Włączenie organizacji (przywracanie tematów Pub/Sub)

    W tym kroku przywrócisz organizację do tematów Pub/Sub. Sygnalizuje oprogramowaniu sprzęgającemu rozpoczęcie nowej, pełnej synchronizacji metadanych.

    • Edytowanie konfiguracji łącznika: ponownie otwórz plik konfiguracji:/opt/apigee/customer/application/uapim-connector.properties
    • Zmodyfikuj plik conf_uapim_connector.uapim.settings.json: w sekcji connectorConfig przywróć wartości runtimeDataPubsub i metadataPubsub dla organizacji, którą chcesz uzgodnić (np. organization1).
    • Po modyfikacji (organizacja 1, która wyraziła zgodę): 
      {
  "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. Przywrócona konfiguracja

    Uruchom ponownie usługę łącznika (opcjonalnie):

    Ponownie uruchom usługę oprogramowania sprzęgającego, aby wywołać pełną ponowną synchronizację metadanych:

    apigee-service edge-uapim-connector restart

Oprogramowanie sprzęgające włącza teraz wszystkie metadane interfejsu API w organizacji docelowej. Postęp możesz śledzić za pomocą punktu końcowego stanu: curl localhost:8080/v1/uapim/status.