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 SDK AS A CLOUD SERVICE AEM.

Pré-requisitos prerequisites

As seguintes ferramentas devem ser instaladas localmente:

1. Instalar o SDK do AEM aem-sdk

Esta configuração usa o SDK AS A CLOUD SERVICE AEM para explorar APIs AEM GraphQL. 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 do local pode ser encontrado aqui.

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

    Portal de distribuição de software

  2. Descompacte o download e copie o jar de Início rápido (aem-sdk-quickstart-XXX.jar) para uma pasta dedicada, ou seja, ~/aem-sdk/author.

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

    A variável author O nome especifica que o Quickstart jar inicia no modo Autor. A variável 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 que o desenvolvimento local reduza a necessidade de reconfiguração.

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

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

Exemplo de conteúdo do Site de referência da WKND é usado para acelerar o tutorial. A WKND é uma marca fictícia de estilo de vida, geralmente usada com treinamento em AEM.

O site da WKND inclui as configurações necessárias para expor uma endpoint do GraphQL. Em uma implementação real, siga as etapas documentadas para incluir os endpoints do GraphQL no projeto do cliente. A CORS O 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 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
    Certifique-se de baixar a versão padrão compatível com o AEM as a Cloud Service e não o classic versão.
  2. No Início do AEM , navegue até Ferramentas > Implantação > Pacotes.

    Navegar até Pacotes

  3. Clique em Fazer upload do pacote e escolha o pacote WKND baixado na etapa anterior. Clique em Instalar para instalar o pacote.

  4. No 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ídeos, e mídias específicas para AEM, como Fragmentos de conteúdo.

  5. Clique em na Downhill Skiing Wyoming e clique no link Fragmento de conteúdo de esqui downhill em Wyoming cartão:

    Cartão Fragmento de 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 defina 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 de 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 APIs AEM GraphQL.

  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 REACT_APP_AUTHORIZATION A linha não está comentada e 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
    

    Assegurar REACT_APP_HOST_URI aponta para o seu SDK AEM local. Para maior comodidade, este início rápido conecta o aplicativo React ao Autor do AEM. Autor os serviços exigem autenticação, portanto, o aplicativo usa o 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 será conectado a um AEM Publish ambiente. Este aspecto é abordado em mais pormenor no Implantação de produção seçã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.

    Visualização Detalhes da aventura

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

    Solicitação XHR do GraphQL Endpoint

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. Navegar até o AEM http://localhost:4502.

  2. Navegue até Assets > Arquivos > WKND compartilhado > Inglês > Aventuras > Campo de Surf de Bali.

    Pasta Campo de Surf de Bali

  3. Clique em na Campo de Surf de Bali fragmento de conteúdo para abrir o editor de Fragmento de conteúdo.

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

    Modificar fragmento de conteúdo

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

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

    Atualização de Bali Surf Camp Adventure

5. Explorar GraphiQL graphiql

  1. Abertura GraphiQL navegando até Ferramentas > Geral > Editor de consultas 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 explorado 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