DocumentatieAEM GuidesDocumentatie voor AEM Guides

Op microservice gebaseerde publicaties configureren met OAuth-verificatie

Last update: Tue Jul 09 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Beheerder

Met de publicatiemicroservice kunt u grote publicatiewerklasten tegelijkertijd uitvoeren op Experience Manager Guides as a Cloud Service en profiteren van het toonaangevende Adobe I/O Runtime-serverloze platform.

Voor elke publicatieaanvraag voert Experience Manager Guides as a Cloud Service een aparte container uit die horizontaal wordt geschaald op basis van de gebruikersaanvragen. Dit biedt de mogelijkheid om meerdere publicatieverzoeken uit te voeren en betere prestaties te krijgen dan hun grote On-premise Adobe Experience Manager-servers.

NOTE
Op microservices gebaseerde publicaties in Experience Manager Guides ondersteunen de typen uitvoervoorinstellingen PDF (zowel op basis van Native als DITA-OT), HTML5, JSON en CUSTOM.

Aangezien de service voor publicatie in de cloud wordt beveiligd door verificatie op basis van OAuth van Adobe IMS, voert u de volgende stappen uit om hun omgevingen te integreren met beveiligde tokengebaseerde verificatieworkflows van de Adobe en de op de cloud gebaseerde schaalbare publicatieoplossing te gaan gebruiken.

IMS-configuraties maken in Adobe Developer Console

Rol die wordt vereist om de configuraties tot stand te brengen: Systeembeheerder

Voer de volgende stappen uit om IMS-configuraties te maken in Adobe Developer Console:

NOTE
Als u reeds een project OAuth hebt gecreeerd om de op AI-Gebaseerde slimme suggesties voor creatie te vormen, kunt u de volgende stappen overslaan om het project tot stand te brengen.

  1. Openen Developer Console: https://developer.adobe.com/console.

  2. Schakel over naar de Projecten van boven.

    tabblad Projecten {width="500"}

    Selecteer de Projecten ​op het tabblad Adobe Developer Console

  3. Als u een nieuw, leeg project wilt maken, selecteert u Leeg project van de Nieuw project maken vervolgkeuzelijst.

    nieuw project maken {width="500"}

    Maak een nieuw, leeg project.

  4. Selecteren API van de Toevoegen aan project vervolgkeuzelijst om de API voor IO-beheer aan uw project toe te voegen.

    project toevoegen {width="300"}

    Selecteer een API-project in de vervolgkeuzelijst.

    io-beheer {width="500"}

    Voeg API voor I/O-beheer toe aan uw project.

  5. Maak een nieuwe OAuth-referentie en sla deze op.

    sleutelpaar genereren {width="500"}

    Configureer de OAuth-referentie voor uw API.

  6. Terugkeren naar de Projecten en selecteert u Overzicht van project links.

    projectoverzicht {width="500"}

    Ga aan de slag met het nieuwe project.

  7. Klik op de knop Downloaden bovenaan om de service JSON te downloaden.

    download json {width="500"}

    Download de JSON-servicegegevens.

U hebt de OAuth-verificatiedetails geconfigureerd en de JSON-servicedetails gedownload. Houd dit bestand bij de hand zoals in de volgende sectie wordt vereist.

IMS-configuratie toevoegen aan de omgeving

NOTE
Als u reeds een project OAuth voor slimme suggesties hebt gecreeerd, dan kunt u het zelfde project voor microservices opnieuw gebruiken en de volgende stappen overslaan om configuratie IMS aan het milieu toe te voegen.

Bestaande configuratie bijwerken (JWT naar OAuth shift)

Als u al een microservice gebruikt voor publicatie met behulp van JWT (afgekeurd), voert u de volgende stappen uit om de configuraties bij te werken:

  1. Openen Experience Manager en selecteer het programma dat het milieu bevat dat u wilt vormen.

  2. Schakel over naar de Omgevingen tab.

  3. Selecteer de naam van het milieu dat u wilt vormen. Ga dan naar de Omgevingsinformatie pagina.

  4. Schakel over naar de Configuratie tab.

  5. Werk het JSON-veld SERVICE_ACCOUNT_DETAILS bij met het nieuwe OAuth JSON-bestand dat u hebt gedownload.

  6. Verwijder het veld PRIVATE_KEY.

    ims-serviceconfiguratie {width="500"}

    Werk de bestaande JWT-omgevingsconfiguraties bij.

Eerste configuratie

Als u een publicatiemicroservice voor het eerst wilt gebruiken, werkt u de configuraties bij volgens de volgende stappen:

  1. Openen Experience Manager en selecteer het programma dat het milieu bevat u wilt vormen.

  2. Schakel over naar de Omgevingen tab.

  3. Selecteer de naam van het milieu dat u wilt vormen. Ga dan naar de Omgevingsinformatie pagina.

  4. Schakel over naar de Configuratie tab.

  5. Creeer een nieuwe configuratie genoemd als SERVICE_ACCOUNT_DETAILS. Voeg als waarde de inhoud van het OAuth JSON-bestand toe die u hebt gedownload van de ontwikkelaarsconsole.

ims-serviceconfiguratie

Configureer de omgeving voor het eerst.

De eerste keer codeveranderingen voor op microservice-gebaseerde het publiceren enablement

NOTE
Sla de volgende stappen over als u al op microservice gebaseerde publicaties gebruikt:

Zodra u de configuratie IMS aan het milieu hebt toegevoegd, voer de volgende stappen uit om deze eigenschappen met Experience Manager Guides te verbinden gebruikend OSGi:

  1. Voeg de volgende twee bestanden toe aan uw Git-projectcode voor cloudbeheer /apps/fmditaCustom/config (voor bestandsinhoud, weergave Bijlage).

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

  2. Zorg ervoor dat de toegevoegde bestanden worden gedekt door uw filter.xml.

  3. Leg de Git-wijzigingen vast en duw erop.

  4. Voer de pijpleiding in werking om de veranderingen op het milieu toe te passen.

Zodra dit wordt gedaan, kunt u de op microservice-gebaseerde wolkenpublicatie gebruiken.

Veelgestelde vragen

  1. Als de configuraties OSGi om microservice te gebruiken worden toegelaten, zal het het publiceren proces op de lokale server van de Experience Manager met de zelfde codebase werken?
    • Neen, indien de markering dxml.use.publish.microservice is ingesteld op true, zoekt het altijd microservice configuraties. Set dxml.use.publish.microservice tot false voor het publiceren om op uw lokale server te werken.
  2. Hoeveel geheugen wordt toegewezen aan het proces DITA wanneer het gebruiken van op microservice-gebaseerde het publiceren? Wordt dit aangestuurd via het DITA-profiel en de parameters?
    • Bij publicatie op basis van microservices wordt geheugentoewijzing niet door het DITA-profiel en de DITA-parameters gestuurd. Het totale beschikbare geheugen op de de dienstcontainer is 8 GB, waarvan 6 GB aan het DITA-OT proces wordt toegewezen.

Bijlage appendix

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

Inhoud:

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

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

Inhoud:

  • dxml.use.publish.microservice: Schakel over om op microservice gebaseerde publicatie met DITA-OT in te schakelen
  • dxml.use.publish.microservice.native.pdf: Schakel over om op microservice gebaseerde Native PDF-publicatie in te schakelen
<?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