Configuração rápida do AEM sem periféricos para AEM as a Cloud Service
A configuração rápida do AEM sem periféricos oferece uma abordagem prática do AEM sem periféricos usando conteúdo do projeto de amostra do WKND Site e uma amostra do aplicativo React (um SPA) que consome o conteúdo por meio das APIs do GraphQL do AEM sem periféricos.
Pré-requisitos
Para seguir esta configuração rápida, é necessário:
-
Ambiente de sandbox da AEM as a Cloud Service (preferencialmente desenvolvimento)
-
Acesso ao AEM as a Cloud Service e ao Cloud Manager
- Acesso de Administrador do AEM ao AEM as a Cloud Service
- Cloud Manager - Acesso do Gerente de implantação ao Cloud Manager
-
As seguintes ferramentas devem ser instaladas localmente:
- Node.js v18
- Git
- Um IDE (por exemplo, Microsoft® Visual Studio Code)
1. Criar um repositório Git do Cloud Manager
Primeiro, crie um repositório Git do Cloud Manager usado para implantar o Site WKND. O Site WKND é um projeto de exemplo de site AEM que contém conteúdo (fragmentos de conteúdo) e um endpoint do GraphQL AEM usado pelo aplicativo React da configuração rápida.
Screencast de etapas
-
Navegue até https://my.cloudmanager.adobe.com
-
Selecione o Programa do Cloud Manager que contém o ambiente AEM as a Cloud Service a ser usado para esta configuração rápida
-
Criar um repositório Git para o projeto do Site WKND
- Selecione Repositórios na navegação superior
- Selecione Adicionar repositório na barra de ações superior
- Nomeie o novo repositório Git:
aem-headless-quick-setup-wknd
- Os nomes dos repositórios Git devem ser exclusivos por organização Adobe,
- Selecione Salvar e aguarde a inicialização do repositório Git
2. Encaminhar amostra de projeto do site WKND para o repositório Git da Cloud Manager
Com o repositório Git do Cloud Manager criado, clone o código fonte do projeto do Site WKND do GitHub e envie-o para o repositório Git do Cloud Manager. Agora, o Cloud Manager acessa e implanta o projeto do Site WKND no ambiente do AEM as a Cloud Service.
Screencast de etapas
-
Na linha de comando, clone do GitHub o código-fonte do projeto do site WKND de amostra
code language-shell $ mkdir -p ~/Code $ cd ~/Code $ git clone git@github.com:adobe/aem-guides-wknd.git
-
Adicionar o repositório Git do Cloud Manager como remoto
-
Selecione Repositórios na navegação superior
-
Selecione Acessar informações do repositório na barra de ação superior
-
Executar comando encontrado em Adicionar um remoto ao repositório Git a partir da linha de comando
code language-shell $ cd aem-guides-wknd $ git remote add adobe https://git.cloudmanager.adobe.com/<YOUR ADOBE ORGANIZATION>/aem-headless-quick-setup-wknd/
-
-
Envie o código-fonte do projeto de amostra do seu repositório Git local para o repositório Git da Cloud Manager
code language-shell $ git push adobe main:main
Quando as credenciais forem solicitadas, forneça o Nome de usuário e a Senha do modal Informações do repositório da Cloud Manager.
3. Implantar o site WKND no AEM as a Cloud Service
Com o projeto do Site WKND enviado para o repositório Git do Cloud Manager, ele não pode ser implantado no AEM as a Cloud Service usando os pipelines do Cloud Manager.
Lembre-se, o projeto Site WKND fornece conteúdo de amostra que o aplicativo React consome por meio de APIs AEM Headless GraphQL.
Screencast de etapas
-
Anexe um pipeline de implantação de não produção ao novo repositório Git
-
Selecione Pipelines na navegação superior
-
Selecione Adicionar pipeline na barra de ação superior
-
Na guia Configuração
- Selecione a opção Pipeline de implantação
- Defina o Nome do Pipeline de Não Produção como
Dev Deployment pipeline
- Selecione Acionador Da Implantação > Sobre Alterações Do Git
- Selecionar Comportamento de Falhas de Métricas Importantes > Continuar Imediatamente
- Selecionar Continuar
-
Na guia Código Source
- Selecione a opção Código de pilha completa
- Selecione o ambiente de desenvolvimento do AEM as a Cloud Service na caixa de seleção Ambientes de implantação qualificados
- Selecione
aem-headless-quick-setup-wknd
na caixa de seleção Repositório - Selecione
main
na caixa de seleção Ramificação Git - Selecione Salvar
-
-
Executar o Pipeline de Implantação de Desenvolvimento
- Selecione Visão geral na navegação superior
- Localize o pipeline de Implantação de Desenvolvimento recém-criado na seção Pipelines
- Selecione o … à direita da entrada do pipeline
- Selecione Executar e confirme no modal
- Selecione o … à direita do pipeline em execução
- Selecione Exibir detalhes
-
Nos detalhes de execução do pipeline, monitore o progresso até que ele seja concluído com êxito. A execução do pipeline deve levar entre 30 e 40 minutos.
4. Baixe e execute o aplicativo WKND React
Com o AEM as a Cloud Service inicializado com o conteúdo do projeto do Site WKND, baixe e inicie o aplicativo WKND React de amostra que consome o conteúdo do Site WKND por meio das APIs do AEM Headless GraphQL.
Screencast de etapas
-
Na linha de comando, clone o código-fonte do aplicativo React do GitHub.
code language-shell $ cd ~/Code $ git clone git@github.com:adobe/aem-guides-wknd-graphql.git
-
Abra a pasta
~/Code/aem-guides-wknd-graphql/react-app
no IDE. -
No IDE, abra o arquivo
.env.development
. -
Aponte para o URI do host do serviço AEM as a Cloud Service Publish a partir da propriedade
REACT_APP_HOST_URI
.code language-plain REACT_APP_HOST_URI=https://publish-pXXXX-eYYYY.adobeaemcloud.com ...
Para encontrar o URI do host do serviço AEM as a Cloud Service Publish:
- No Cloud Manager, selecione Ambientes na navegação superior
- Selecionar ambiente de desenvolvimento
- Localize a tabela Serviço Publish (AEM e Dispatcher) no link Segmentos de ambiente
- Copie o endereço do link e use-o como o URI do serviço AEM as a Cloud Service Publish
-
No IDE, salve as alterações em
.env.development
-
Na linha de comando, execute o aplicativo React
code language-shell $ cd ~/Code/aem-guides-wknd-graphql/react-app $ npm install $ npm start
-
O aplicativo React, executado localmente, começa em http://localhost:3000 e exibe uma lista de aventuras, que são originadas no AEM as a Cloud Service usando as APIs GraphQL do AEM Headless.
5. Editar conteúdo no AEM
Com a amostra do aplicativo WKND React conectando-se e consumindo conteúdo das APIs AEM Headless do GraphQL, crie conteúdo no serviço de autor do AEM e veja como a experiência do aplicativo React é atualizada em conjunto.
Screencast de etapas
-
Fazer logon no serviço de Autor do AEM as a Cloud Service
-
Navegue até Assets > Arquivos > Compartilhado WKND > Inglês > Aventuras
-
Abra a Pasta Ciclismo Sul de Utah
-
Selecione o Fragmento de conteúdo Ciclo Sul de Utah e selecione Editar na barra de ação superior
-
Atualize alguns campos do Fragmento de conteúdo, por exemplo:
- Título:
Cycling Utah's National Parks
- Duração da Viagem:
6 Days
- Dificuldade:
Intermediate
- Preço:
3500
- Imagem Principal:
/content/dam/wknd-shared/en/activities/cycling/mountain-biking.jpg
- Título:
-
Selecione Salvar na barra de ações superior
-
Selecione Publish Rápido na barra de ações superior …
-
Atualize o Aplicativo React em execução em http://localhost:3000.
-
No aplicativo React, selecione a aventura Ciclismo atualizada e verifique as alterações de conteúdo feitas no fragmento de conteúdo.
-
Usando a mesma abordagem, no serviço de Autor de AEM:
- Desfaça a publicação de um fragmento de conteúdo Adventure existente e verifique se ele foi removido da experiência do aplicativo React
- Crie e publique um novo Fragmento de conteúdo de aventura e verifique se ele aparece na experiência do aplicativo React
note tip TIP Se você não estiver familiarizado com a criação e publicação de novos fragmentos de conteúdo ou com o cancelamento da publicação de fragmentos de conteúdo existentes, assista ao screencast acima.
Parabéns.
Parabéns! Você usou o AEM Headless com sucesso para alimentar um aplicativo React!
Para entender em detalhes como o aplicativo React consome conteúdo do AEM as a Cloud Service, confira o tutorial do AEM Headless. O tutorial explora como os fragmentos de conteúdo no AEM foram criados e como este aplicativo React consome o conteúdo como JSON.