Configurar a publicação baseada em microsserviço com autenticação OAuth
O microsserviço de publicação permite executar grandes cargas de trabalho de publicação simultaneamente no Experience Manager Guides as a Cloud Service e aproveitar a plataforma Adobe I/O Runtime sem servidor, líder do setor.
Para cada solicitação de publicação, o Experience Manager Guides as a Cloud Service um contêiner separado que é dimensionado horizontalmente de acordo com as solicitações do usuário. Dessa forma, você pode executar várias solicitações de publicação e obter um desempenho melhor do que seus grandes servidores locais do Adobe Experience Manager.
Como o serviço de publicação na nuvem é protegido pela autenticação baseada em OAuth do Adobe IMS, execute as seguintes etapas para integrar seus ambientes com fluxos de trabalho de autenticação baseados em token seguro do Adobe e comece a usar a solução de publicação escalável baseada em nuvem.
Criar configurações do IMS no Adobe Developer Console
Função necessária para criar as configurações: Administrador do Sistema
Execute as seguintes etapas para criar configurações de IMS no Adobe Developer Console:
-
Abrir Developer Console:
https://developer.adobe.com/console
. -
Alterne para a guia Projetos a partir da parte superior.
Selecione a guia Projetos no Adobe Developer Console
-
Para criar um novo projeto vazio, selecione Projeto vazio na lista suspensa Criar novo projeto.
Criar um novo projeto vazio.
-
Selecione API na lista suspensa Adicionar ao Projeto para adicionar a API de Gerenciamento de E/S ao seu projeto.
Selecione um projeto de API na lista suspensa.
Adicionar a API de Gerenciamento de E/S ao seu projeto.
-
Crie uma nova credencial OAuth e salve-a.
Configure a credencial OAuth para sua API.
-
Retorne à guia Projetos e selecione Visão geral do projeto à esquerda.
Introdução ao novo projeto.
-
Clique no botão Baixar na parte superior para baixar o serviço JSON.
Baixar detalhes do serviço JSON.
Você configurou os detalhes de autenticação do OAuth e baixou os detalhes do serviço JSON. Mantenha esse arquivo em mãos conforme necessário na próxima seção.
Adicionar a configuração IMS ao ambiente
Atualizar configuração existente (JWT) para OAuth shift )
Se você já estiver usando um microsserviço para publicar usando o JWT (obsoleto), execute as seguintes etapas para atualizar as configurações:
-
Abra Experience Manager e selecione o programa que contém o ambiente que você deseja configurar.
-
Alterne para a guia Ambientes.
-
Selecione o nome do ambiente que deseja configurar. Você deve ir para a página Informações sobre o ambiente.
-
Alterne para a guia Configuração.
-
Atualize o campo JSON SERVICE_ACCOUNT_DETAILS com o novo arquivo JSON do OAuth baixado.
-
Exclua o campo PRIVATE_KEY.
Atualizar as configurações existentes do ambiente JWT.
Primeira configuração
Para usar um microsserviço de publicação pela primeira vez, atualize as configurações de acordo com as seguintes etapas:
-
Abra Experience Manager e selecione o programa que contém o ambiente que você deseja configurar.
-
Alterne para a guia Ambientes.
-
Selecione o nome do ambiente que deseja configurar. Você deve ir para a página Informações sobre o ambiente.
-
Alterne para a guia Configuração.
-
Crie uma nova configuração chamada como SERVICE_ACCOUNT_DETAILS. Em valor, adicione o conteúdo do arquivo JSON OAuth que você baixou do console do desenvolvedor .
Configurar o ambiente pela primeira vez.
Alterações no código pela primeira vez para habilitação de publicação baseada em microsserviços
Depois de adicionar a configuração IMS ao ambiente, execute as seguintes etapas para vincular essas propriedades ao Experience Manager Guides usando OSGi:
-
Em seu código de projeto Git do Cloud Manager, adicione os dois arquivos a seguir em
/apps/fmditaCustom/config
(para conteúdo de arquivo, exiba Apêndice).com.adobe.aem.guides.eventing.ImsConfiguratorService.cfg.json
com.adobe.fmdita.publishworkflow.PublishWorkflowConfigurationService.xml
-
Certifique-se de que os arquivos recém-adicionados estejam sendo cobertos pelo seu
filter.xml
. -
Confirme e envie suas alterações do Git.
-
Execute o pipeline para aplicar as alterações ao ambiente.
Depois disso, você poderá usar a publicação na nuvem com base em microsserviços.
Perguntas frequentes
- Se as configurações de OSGi para usar o microsserviço estiverem ativadas, o processo de publicação funcionará no servidor de Experience Manager local com a mesma base de código?
- Não, se o sinalizador
dxml.use.publish.microservice
estiver definido comotrue
, ele sempre procurará configurações de microsserviço. Definadxml.use.publish.microservice
comofalse
para que a publicação funcione em seu servidor local.
- Não, se o sinalizador
- Quanta memória é alocada para o processo DITA ao usar a publicação baseada em microsserviços? Isso é orientado pelo perfil e pelos parâmetros DITA?
- Com a publicação baseada em microsserviços, a alocação de memória não é orientada pelo perfil e pelos parâmetros DITA. A memória total disponível no container de serviço é de 8 GB, dos quais 6 GB são alocados para o processo DITA-OT.
Apêndice appendix
Arquivo:com.adobe.aem.guides.eventing.ImsConfiguratorService.cfg.json
Conteúdo:
{
"service.account.details": "$[secret:SERVICE_ACCOUNT_DETAILS]",
}
Arquivo: com.adobe.fmdita.publishworkflow.PublishWorkflowConfigurationService.xml
Conteúdo:
dxml.use.publish.microservice
: Alternar para habilitar a publicação baseada em microsserviço usando DITA-OTdxml.use.publish.microservice.native.pdf
: Alternar para habilitar a publicação de PDF nativo baseado em microsserviços
<?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"
/>