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:

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

  1. Navegue até https://my.cloudmanager.adobe.com

  2. 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

  3. Criar um repositório Git para o projeto do Site WKND

    1. Selecione Repositórios na navegação superior
    2. Selecione Adicionar repositório na barra de ações superior
    3. Nomeie o novo repositório Git: aem-headless-quick-setup-wknd
      • Os nomes dos repositórios Git devem ser exclusivos por organização Adobe,
    4. 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

  1. 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
    
  2. Adicionar o repositório Git do Cloud Manager como remoto

    1. Selecione Repositórios na navegação superior

    2. Selecione Acessar informações do repositório na barra de ação superior

    3. 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/
      
  3. 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

  1. Anexe um pipeline de implantação de não produção ao novo repositório Git

    1. Selecione Pipelines na navegação superior

    2. Selecione Adicionar pipeline na barra de ação superior

    3. Na guia Configuração

      1. Selecione a opção Pipeline de implantação
      2. Defina o Nome do Pipeline de Não Produção como Dev Deployment pipeline
      3. Selecione Acionador Da Implantação > Sobre Alterações Do Git
      4. Selecionar Comportamento de Falhas de Métricas Importantes > Continuar Imediatamente
      5. Selecionar Continuar
    4. Na guia Código Source

      1. Selecione a opção Código de pilha completa
      2. Selecione o ambiente de desenvolvimento do AEM as a Cloud Service na caixa de seleção Ambientes de implantação qualificados
      3. Selecione aem-headless-quick-setup-wknd na caixa de seleção Repositório
      4. Selecione main na caixa de seleção Ramificação Git
      5. Selecione Salvar
  2. Executar o Pipeline de Implantação de Desenvolvimento

    1. Selecione Visão geral na navegação superior
    2. Localize o pipeline de Implantação de Desenvolvimento recém-criado na seção Pipelines
    3. Selecione o à direita da entrada do pipeline
    4. Selecione Executar e confirme no modal
    5. Selecione o à direita do pipeline em execução
    6. Selecione Exibir detalhes
  3. 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

  1. 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
    
  2. Abra a pasta ~/Code/aem-guides-wknd-graphql/react-app no IDE.

  3. No IDE, abra o arquivo .env.development.

  4. 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:

    1. No Cloud Manager, selecione Ambientes na navegação superior
    2. Selecionar ambiente de desenvolvimento
    3. Localize a tabela Serviço Publish (AEM e Dispatcher) no link Segmentos de ambiente
    4. Copie o endereço do link e use-o como o URI do serviço AEM as a Cloud Service Publish
  5. No IDE, salve as alterações em .env.development

  6. Na linha de comando, execute o aplicativo React

    code language-shell
    $ cd ~/Code/aem-guides-wknd-graphql/react-app
    $ npm install
    $ npm start
    
  7. 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

  1. Fazer logon no serviço de Autor do AEM as a Cloud Service

  2. Navegue até Assets > Arquivos > Compartilhado WKND > Inglês > Aventuras

  3. Abra a Pasta Ciclismo Sul de Utah

  4. Selecione o Fragmento de conteúdo Ciclo Sul de Utah e selecione Editar na barra de ação superior

  5. 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
  6. Selecione Salvar na barra de ações superior

  7. Selecione Publish Rápido na barra de ações superior

  8. Atualize o Aplicativo React em execução em http://localhost:3000.

  9. No aplicativo React, selecione a aventura Ciclismo atualizada e verifique as alterações de conteúdo feitas no fragmento de conteúdo.

  10. Usando a mesma abordagem, no serviço de Autor de AEM:

    1. 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
    2. 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.

Próximas etapas

recommendation-more-help
e25b6834-e87f-4ff3-ba56-4cd16cdfdec4