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 dieses Verfahren in der Regel, wenn Sie Dateninkonsistenzen vermuten oder eine vollständige Resynchronisierung aller API-Definitionen erforderlich ist.

Der Prozess umfasst zwei Hauptaktionen:

Die spezifische Organisation vorübergehend deaktivieren, indem Sie die Konfiguration des Connectors ändern
Sie aktivieren sie sofort wieder.

Durch diese Sequenz wird der Connector ausgelöst, um alle Metadaten für diese Organisation noch einmal vollständig abzurufen und hochzuladen.

Abgleichsschritte

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

Erstellen Sie eine Sicherung der aktuellen Konfigurationsdatei.
Entfernen Sie nur „runtimeDataPubsub“ und „metadataPubsub“ aus der Organisation, für die Sie die Einwilligung widerrufen möchten.
Starten Sie den UAPIM-Connector-Dienst neu.
Aktivieren Sie die aktuelle Organisation, indem Sie die ursprünglichen UAPIM-Connector-Einstellungen aus der Sicherung wiederherstellen, die in Schritt 1 erstellt wurde.
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. Damit der Connector die Synchronisierung von Metadaten für die Zielorganisation vorübergehend beendet.

Connectorkonfiguration 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 die 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 (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"
}

Connector-Dienst neu starten (Opt-out):

Wenden Sie die Änderung an, 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 für die Pub/Sub-Themen wieder her. Damit wird dem Connector signalisiert, dass eine neue, vollständige Synchronisierung der Metadaten gestartet werden soll.
- 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 (Opt-in-Organisation 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"
}
```
Wiederhergestellte Konfiguration

Connector-Dienst neu starten (Opt-in):

Starten Sie den Connector-Dienst noch einmal neu, um die vollständige Metadaten-Resynchronisierung 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 Statusendpunkt curl localhost:8080/v1/uapim/status verfolgen.

Organisation abstimmen

Abgleichsschritte

Organisation deaktivieren (Pub/Sub-Themen entfernen)

Organisation aktivieren (Pub/Sub-Themen wiederherstellen)

Wiederhergestellte Konfiguration