DokumentationAEM GuidesDokumentation zu AEM Guides

Konfigurieren von auf Microservices basierender Veröffentlichung mit OAuth-Authentifizierung

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Admin

Mit dem Publishing-Microservice können Sie große Publishing-Arbeitslasten gleichzeitig auf Experience Manager Guides as a Cloud Service ausführen und die branchenführende Adobe I/O Runtime-Server-lose Plattform nutzen.

Für jede Veröffentlichungsanfrage führt Experience Manager Guides as a Cloud Service einen separaten Container aus, der entsprechend den Benutzeranfragen horizontal skaliert werden kann. Dies bietet die Möglichkeit, mehrere Veröffentlichungsanfragen auszuführen und eine bessere Leistung zu erzielen als ihre großen On-Premise-Adobe Experience Manager-Server.

NOTE
Die auf Microservices basierende Veröffentlichung in Experience Manager Guides unterstützt PDF (sowohl nativ als auch DITA-OT-basiert), HTML5, JSON und BENUTZERDEFINIERTE Typen von Ausgabevorgaben.

Adobe Da der Cloud-Publishing-Service durch Adobe IMS OAuth-basierte Authentifizierung gesichert ist, führen Sie die folgenden Schritte aus, um ihre Umgebungen mit sicheren Token-basierten Authentifizierungs-Workflows zu integrieren, und beginnen Sie mit der Verwendung der Cloud-basierten skalierbaren Publishing-Lösung.

Erstellen von IMS-Konfigurationen in Adobe Developer Console

Zum Erstellen der Konfigurationen erforderliche Rolle: Systemadministrator

Führen Sie die folgenden Schritte aus, um IMS-Konfigurationen in Adobe Developer Console zu erstellen:

NOTE
Wenn Sie bereits ein OAuth-Projekt erstellt haben, um die KI-gestützten intelligenten Vorschläge für das Authoring zu konfigurieren, können Sie die folgenden Schritte überspringen, um das Projekt zu erstellen.

  1. Öffnen Sie Developer Console: https://developer.adobe.com/console.

  2. Wechseln Sie von oben zur Projekte-Registerkarte.

    Registerkarte Projekte {width="500"}

    Wählen Sie die Registerkarte Projekte ​in der Adobe Developer Console aus

  3. Um ein neues leeres Projekt zu erstellen, wählen Sie Leeres Projekt aus der Dropdown-Liste Neues Projekt erstellen aus.

    Neues Projekt erstellen {width="500"}

    Ein neues leeres Projekt erstellen.

  4. Wählen Sie API aus der Dropdown Liste Zum Projekt hinzufügen, um Ihrem Projekt die IO-Management-API hinzuzufügen.

    Projekt hinzufügen {width="300"}

    Wählen Sie im Dropdown-Menü ein API-Projekt aus.

    IO-Management {width="500"}

    Fügen Sie Ihrem Projekt die I/O-Management-API hinzu.

  5. Erstellen Sie neue OAuth-Anmeldeinformationen und speichern Sie sie.

    Schlüsselpaar generieren {width="500"}

    Konfigurieren von OAuth-Anmeldeinformationen für Ihre API.

  6. Kehren Sie zur Registerkarte Projekte zurück und wählen Sie Projektübersicht auf der linken Seite aus.

    Projektübersicht {width="500"}

    Erste Schritte mit dem neuen Projekt.

  7. Klicken Sie oben auf Schaltfläche Herunterladen“, um die JSON-Datei des Services herunterzuladen.

    JSON herunterladen {width="500"}

    JSON-Service-Details herunterladen.

Sie haben die OAuth-Authentifizierungsdetails konfiguriert und die JSON-Service-Details heruntergeladen. Halten Sie diese Datei bereit, da sie im nächsten Abschnitt benötigt wird.

Hinzufügen der IMS-Konfiguration zur Umgebung

NOTE
Wenn Sie bereits ein OAuth-Projekt für intelligente Vorschläge erstellt haben, können Sie dasselbe Projekt für Microservices wiederverwenden und die folgenden Schritte überspringen, um die IMS-Konfiguration zur Umgebung hinzuzufügen.

Aktualisieren der vorhandenen Konfiguration (JWT) zur OAuth-Umschaltung )

Wenn Sie bereits einen Microservice für die Veröffentlichung mit JWT (veraltet) verwenden, führen Sie die folgenden Schritte aus, um die Konfigurationen zu aktualisieren:

  1. Öffnen Sie Experience Manager und wählen Sie das Programm aus, das die zu konfigurierende Umgebung enthält.

  2. Wechseln Sie zur Registerkarte Umgebungen.

  3. Wählen Sie den Namen der Umgebung aus, die Sie konfigurieren möchten. Dadurch sollten Sie zur Seite Umgebungsinformationen gelangen.

  4. Wechseln Sie zur Registerkarte Konfiguration .

  5. Aktualisieren Sie das JSON-Feld SERVICE_ACCOUNT_DETAILS mit der neuen JSON-OAuth-Datei, die Sie heruntergeladen haben.

  6. Löschen Sie das Feld PRIVATE_KEY .

    Konfiguration des IMS-Dienstkontos {width="500"}

    Aktualisieren der vorhandenen JWT-Umgebungskonfigurationen.

Erstmalige Konfiguration

Um einen Veröffentlichungs-Microservice zum ersten Mal zu verwenden, aktualisieren Sie die Konfigurationen gemäß den folgenden Schritten:

  1. Öffnen Sie Experience Manager und wählen Sie das Programm aus, das die zu konfigurierende Umgebung enthält.

  2. Wechseln Sie zur Registerkarte Umgebungen.

  3. Wählen Sie den Namen der Umgebung aus, die Sie konfigurieren möchten. Dadurch sollten Sie zur Seite Umgebungsinformationen gelangen.

  4. Wechseln Sie zur Registerkarte Konfiguration .

  5. Erstellen Sie eine neue Konfiguration mit dem Namen SERVICE_ACCOUNT_DETAILS. Fügen Sie im Wert den Inhalt der OAuth-JSON-Datei hinzu, den Sie von der Entwicklerkonsole heruntergeladen haben.

Konfiguration des IMS-Dienstkontos {width="500"}

Konfigurieren Sie die Umgebung zum ersten Mal.

Erstmalige Code-Änderungen für die Aktivierung der auf Microservices basierenden Veröffentlichung

NOTE
Überspringen Sie die folgenden Schritte, wenn Sie bereits eine auf Microservices basierende Veröffentlichung verwenden:

Nachdem Sie die IMS-Konfiguration zur Umgebung hinzugefügt haben, führen Sie die folgenden Schritte aus, um diese Eigenschaften mithilfe von OSGi mit Experience Manager Guides zu verknüpfen:

  1. Fügen Sie in Ihrem Cloud Manager-Git-Projekt-Code die folgenden beiden Dateien zu /apps/fmditaCustom/config hinzu (für Dateiinhalte Anhang).

    • com.adobe.aem.guides.eventing.ImsConfiguratorService.cfg.json
    • com.adobe.fmdita.publishworkflow.PublishWorkflowConfigurationService.xml

  2. Stellen Sie sicher, dass die neu hinzugefügten Dateien von Ihrem filter.xml abgedeckt werden.

  3. Übertragen Sie Ihre Git-Änderungen und übertragen Sie sie.

  4. Führen Sie die Pipeline aus, um die Änderungen auf die Umgebung anzuwenden.

Sobald dies geschehen ist, können Sie die auf Microservices basierende Cloud-Veröffentlichung verwenden.

Häufig gestellte Fragen

  1. Wenn die OSGi-Konfigurationen für die Verwendung des Microservices aktiviert sind, funktioniert der Veröffentlichungsprozess auf dem lokalen Experience Manager-Server mit derselben Codebasis?
    • Nein, wenn das Flag dxml.use.publish.microservice auf true gesetzt ist, wird immer nach Microservice-Konfigurationen gesucht. Legen Sie dxml.use.publish.microservice auf false fest, damit die Veröffentlichung auf Ihrem lokalen Server funktioniert.
  2. Wie viel Speicher wird dem DITA-Prozess bei der Verwendung von Veröffentlichungen auf Microservice-Basis zugewiesen? Wird dies über das DITA-Profil und Parameter gesteuert?
    • Bei der auf Microservices basierenden Veröffentlichung wird die Speicherzuweisung nicht durch das DITA-Profil und die -Parameter gesteuert. Der gesamte verfügbare Speicher im Service-Container beträgt 8 GB, wovon 6 GB dem DITA-OT-Prozess zugeordnet sind.

Anhang appendix

Datei:
com.adobe.aem.guides.eventing.ImsConfiguratorService.cfg.json

Inhalt:

{
"service.account.details": "$[secret:SERVICE_ACCOUNT_DETAILS]",
}

Datei: com.adobe.fmdita.publishworkflow.PublishWorkflowConfigurationService.xml

Inhalt:

  • dxml.use.publish.microservice: Wechseln Sie zur Aktivierung der Microservice-basierten Veröffentlichung mithilfe von DITA-OT
  • dxml.use.publish.microservice.native.pdf: Umschalten zur Aktivierung der Microservice-basierten nativen PDF-Veröffentlichung
<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:jcr="http://www.jcp.org/jcr/1.0" xmlns:sling="http://sling.apache.org/jcr/sling/1.0"
          jcr:primaryType="sling:OsgiConfig"
          dxml.publish.microservice.url="https://adobeioruntime.net/api/v1/web/543112-guidespublisher/default/publishercaller.json"
          dxml.use.publish.microservice="{Boolean}true"
          dxml.use.publish.microservice.native.pdf="{Boolean}true"
/>
recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178