Configuração rápida do AEM Headless usando o AEM SDK local setup

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. Este guia usa o AEM as a Cloud Service SDK.

Pré-requisitos prerequisites

As seguintes ferramentas devem ser instaladas localmente:

1. Instalar o SDK do AEM aem-sdk

Esta instalação usa o AEM as a Cloud Service SDK para explorar APIs do GraphQL AEM. Esta seção fornece um guia rápido para instalar o SDK do AEM e executá-lo no modo Autor. Um guia mais detalhado para configurar um ambiente de desenvolvimento local pode ser encontrado aqui.

NOTE
Também é possível seguir o tutorial com um ambiente AEM as a Cloud Service. Observações adicionais para usar um ambiente de nuvem são incluídas no tutorial.
  1. Navegue até o Portal de Distribuição de Software > AEM as a Cloud Service e baixe a versão mais recente do AEM SDK.

    Portal de Distribuição de Software

  2. Descompacte o download e copie o Quickstart jar (aem-sdk-quickstart-XXX.jar) em uma pasta dedicada, ou seja, ~/aem-sdk/author.

  3. Renomeie o arquivo jar como aem-author-p4502.jar.

    O nome author especifica que o Quickstart jar inicia no modo Autor. O p4502 especifica que o Quickstart é executado na porta 4502.

  4. Para instalar e iniciar a instância do AEM, abra um prompt de comando na pasta que contém o arquivo jar e execute o seguinte comando:

    code language-shell
    $ cd ~/aem-sdk/author
    $ java -jar aem-author-p4502.jar
    
  5. Forneça uma senha de administrador como admin. Qualquer senha de administrador é aceitável, no entanto, é recomendável usar admin para desenvolvimento local para reduzir a necessidade de reconfigurar.

  6. Quando o serviço AEM terminar de ser instalado, uma nova janela do navegador deverá ser aberta em http://localhost:4502.

  7. Faça logon com o nome de usuário admin e a senha selecionada durante a primeira inicialização do AEM (geralmente admin).

2. Instalar conteúdo de amostra install-sample-content

O conteúdo de amostra do site de Referência WKND é usado para acelerar o tutorial. A WKND é uma marca fictícia de estilo de vida, geralmente usada com treinamento em AEM.

O site WKND inclui configurações necessárias para expor um ponto de extremidade do GraphQL. Em uma implementação real, siga as etapas documentadas para incluir os pontos de extremidade do GraphQL no projeto do cliente. Um CORS também foi empacotado como parte do Site WKND. Uma configuração do CORS é necessária para conceder acesso a um aplicativo externo. Mais informações sobre o CORS podem ser encontradas abaixo.

  1. Baixe o pacote AEM compilado mais recente para o Site WKND: aem-guides-wknd.all-x.x.x.zip.

    note note
    NOTE
    Baixe a versão padrão compatível com o AEM as a Cloud Service e não a versão classic.
  2. No menu Iniciar do AEM, navegue até Ferramentas > Implantação > Pacotes.

    Navegar até Pacotes

  3. Clique em Carregar Pacote e escolha o pacote WKND baixado na etapa anterior. Clique em Instalar para instalar o pacote.

  4. No menu Início do AEM, navegue até Assets > Arquivos > WKND Compartilhado > Inglês > Aventuras.

    Exibição de pasta de aventuras

    Esta é uma pasta de todos os ativos que compõem as várias Aventuras promovidas pela marca WKND. Isso inclui tipos de mídia tradicionais, como imagens e vídeo, e mídia específica para AEM, como Fragmentos de conteúdo.

  5. Clique na pasta Downhill Skiing Wyoming e clique no cartão Downhill Skiing Wyoming Content Fragment:

    Cartão do Fragmento do conteúdo

  6. O editor de Fragmento de conteúdo abre para a aventura Downhill Skiing Wyoming.

    Editor de fragmento de conteúdo

    Observe que vários campos como Título, Descrição e Atividade definem o fragmento.

    Fragmentos de conteúdo são uma das maneiras pelas quais o conteúdo pode ser gerenciado no AEM. Fragmento de conteúdo são conteúdos reutilizáveis e de apresentação independente, compostos de elementos de dados estruturados, como texto, rich text, datas ou referências a outros Fragmentos de conteúdo. Os fragmentos de conteúdo são explorados com mais detalhes posteriormente na configuração rápida.

  7. Clique em Cancelar para fechar o fragmento. Sinta-se à vontade para navegar em algumas das outras pastas e explorar o outro conteúdo de aventura.

NOTE
Se estiver usando um ambiente Cloud Service, consulte a documentação para saber como implantar uma base de código como o site de referência WKND em um ambiente Cloud Service.

3. Baixe e execute o aplicativo WKND React sample-app

Um dos objetivos deste tutorial é mostrar como consumir conteúdo AEM de um aplicativo externo usando as APIs do GraphQL. Este tutorial usa um aplicativo React de exemplo. O aplicativo React é intencionalmente simples, para se concentrar na integração com as APIs GraphQL do AEM.

  1. Abra um novo prompt de comando e clone o aplicativo React de amostra do GitHub:

    code language-shell
    $ git clone git@github.com:adobe/aem-guides-wknd-graphql.git
    $ cd aem-guides-wknd-graphql/react-app
    
  2. Abra o aplicativo React no aem-guides-wknd-graphql/react-app no IDE de sua escolha.

  3. No IDE, abra o arquivo .env.development em /.env.development. Verifique se a linha REACT_APP_AUTHORIZATION não está comentada e se o arquivo declara as seguintes variáveis:

    code language-plain
    REACT_APP_HOST_URI=http://localhost:4502
    REACT_APP_GRAPHQL_ENDPOINT=/content/graphql/global/endpoint.json
    # Use Authorization when connecting to an AEM Author environment
    REACT_APP_AUTHORIZATION=admin:admin
    

    Verifique se REACT_APP_HOST_URI aponta para o SDK AEM local. Para maior comodidade, este início rápido conecta o aplicativo React ao AEM Author. Os serviços do Author exigem autenticação, portanto, o aplicativo usa o usuário admin para estabelecer sua conexão. Conectar um aplicativo ao AEM Author é uma prática comum durante o desenvolvimento, pois facilita a iteração rápida no conteúdo, sem a necessidade de publicar as alterações.

    note note
    NOTE
    Em um cenário de produção, o Aplicativo se conectará a um ambiente AEM Publish. Isso é abordado com mais detalhes na seção Implantação de produção.
  4. Instale e inicie o aplicativo React:

    code language-shell
    $ cd aem-guides-wknd-graphql/react-app
    $ npm install
    $ npm start
    
  5. Uma nova janela do navegador abre automaticamente o aplicativo em http://localhost:3000.

    Aplicativo inicial do React

    Uma lista do conteúdo de aventura do AEM é exibida.

  6. Clique em uma das imagens da aventura para exibir os detalhes da aventura. Um pedido é feito ao AEM para retornar os detalhes de uma aventura.

    exibição de Detalhes da Aventura

  7. Use as ferramentas de desenvolvedor do navegador para inspecionar as solicitações de Rede. Exiba as solicitações de XHR e observe várias solicitações do GET para /graphql/execute.json/.... Esse prefixo de caminho invoca o endpoint de consulta persistente do AEM, selecionando a consulta persistente a ser executada usando o nome e os parâmetros codificados após o prefixo.

    Solicitação XHR do Ponto de Extremidade do GraphQL

4. Editar conteúdo no AEM

Com o aplicativo React em execução, faça uma atualização do conteúdo no AEM e veja se a alteração se reflete no aplicativo.

  1. Navegue até AEM http://localhost:4502.

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

    Pasta do Acampamento de Surf de Bali

  3. Clique no fragmento de conteúdo do Bali Surf Camp para abrir o editor de fragmentos de conteúdo.

  4. Modifique o Título e a Descrição da aventura.

    Modificar fragmento de conteúdo

  5. Clique em Salvar para salvar as alterações.

  6. Atualize o aplicativo React em http://localhost:3000 para ver suas alterações:

    Aventura sobre o Acampamento de Surf de Bali atualizada

5. Explorar GraphiQL graphiql

  1. Abra o GraphiQL navegando até Ferramentas > Geral > Editor de consultas do GraphQL

  2. Selecione as consultas persistentes existentes à esquerda e execute-as para ver os resultados.

    note note
    NOTE
    A ferramenta GraphiQL e a API do GraphQL são exploradas com mais detalhes posteriormente no tutorial.

Parabéns. congratulations

Parabéns, agora você tem um aplicativo externo que consome conteúdo AEM com o GraphQL. Fique à vontade para inspecionar o código no aplicativo React e continuar a experimentar a modificação de fragmentos de conteúdo existentes.

Próximas etapas

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