Organisation abstimmen

Mit dem Abgleichsprozess können Sie alle API-Metadaten (Proxys, Umgebungen usw.) für eine vorhandene Apigee Edge for Private Cloud-Organisation in API Hub neu synchronisieren. Sie verwenden diesen Prozess in der Regel, wenn Sie Dateninkonsistenzen vermuten oder eine vollständige Neusynchronisierung aller API-Definitionen erforderlich ist.

Der Prozess umfasst zwei Hauptaktionen:

Vorübergehendes Deaktivieren der jeweiligen Organisation durch Ändern der Konfiguration des Connectors
Sofortiges Reaktivieren

Diese Sequenz löst aus, dass der Connector alle Metadaten für diese Organisation noch einmal vollständig abruft und hochlädt.

Abgleichsschritte

Um eine Organisation abzugleichen, ändern Sie die Konfigurationsdatei des Connectors zweimal und starten den Connector-Dienst nach jeder Änderung neu.

Erstellen Sie eine Sicherung der aktuellen Konfigurationsdatei.
Entfernen Sie nur runtimeDataPubsub und metadataPubsub aus der Organisation, die Sie deaktivieren möchten.
Starten Sie den uapim-Connector-Dienst neu.
Aktivieren Sie die aktuelle Organisation wieder, indem Sie die ursprünglichen uapim-Connector-Einstellungen aus der in Schritt 1 erstellten Sicherung wiederherstellen.
Starten Sie den uapim-Connector-Dienst neu.

Organisation deaktivieren (Pub/Sub-Themen entfernen)

In diesem Schritt entfernen Sie die Organisation aus den Pub/Sub-Themen. Dadurch wird dem Connector vorübergehend signalisiert, die Synchronisierung von Metadaten für die Zielorganisation zu beenden.

Connector-Konfiguration bearbeiten:Öffnen Sie die Konfigurationsdatei auf der Connector-VM: /opt/apigee/customer/application/uapim-connector.properties
conf_uapim_connector.uapim.settings.json ändern: Entfernen Sie im Abschnitt „connectorConfig“ für die Organisation, die Sie abgleichen möchten (z.B. „organization1“), die Werte für „runtimeDataPubsub“ und „metadataPubsub“. Lassen Sie „serviceAccount“ und „pluginInstanceId“ unverändert.

Vor der Änderung (Beispiel)

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

Nach der Änderung (Deaktivierung von „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"
}

Connector-Dienst neu starten (Deaktivierung) :

Übernehmen Sie die Änderung, indem Sie den Apigee API Hub for Private Cloud-Connector neu starten:
```
apigee-service edge-uapim-connector restart
```

Organisation aktivieren (Pub/Sub-Themen wiederherstellen)

In diesem Schritt stellen Sie die Organisation in den Pub/Sub-Themen wieder her. Dadurch wird dem Connector signalisiert, eine neue vollständige Synchronisierung der Metadaten zu starten.
- Connector-Konfiguration bearbeiten:Öffnen Sie die Konfigurationsdatei noch einmal:/opt/apigee/customer/application/uapim-connector.properties
- conf_uapim_connector.uapim.settings.json ändern:Stellen Sie im Abschnitt „connectorConfig“ für die Organisation, die Sie abgleichen möchten (z.B. „organization1“), die Werte für „runtimeDataPubsub“ und „metadataPubsub“ wieder her.
- Nach der Änderung (Aktivierung von „organization1“):
```
{
  "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"
}
```
Wiederhergestellte Konfiguration

Connector-Dienst neu starten (Aktivierung)

Starten Sie den Connector-Dienst noch einmal neu, um die vollständige Neusynchronisierung der Metadaten auszulösen:
```
apigee-service edge-uapim-connector restart
```

Der Connector führt jetzt eine vollständige Aktivierung aller API-Metadaten für die Zielorganisation durch. Sie können den Fortschritt über den Status-Endpunkt verfolgen: curl localhost:8080/v1/uapim/status.

Organisation abstimmen

Abgleichsschritte

Organisation deaktivieren (Pub/Sub-Themen entfernen)

Organisation aktivieren (Pub/Sub-Themen wiederherstellen)

Wiederhergestellte Konfiguration