O SDK do AEM as a Cloud Service aem-as-a-cloud-service-sdk
O SDK do AEM as a Cloud Service é composto pelos seguintes artefatos:
- Quickstart Jar - O tempo de execução do AEM usado para o desenvolvimento local
- Jar da API Java™ - A dependência Java™ Jar/Maven que expõe todas as APIs Java™ permitidas que podem ser usadas para desenvolvimento em relação ao AEM as a Cloud Service. Anteriormente conhecido como Uberjar
- Jar do Javadoc - Os javadocs do Jar da API Java™
- Ferramentas do Dispatcher - O conjunto de ferramentas usadas para desenvolver localmente em relação ao Dispatcher. Artefatos separados para UNIX® e Windows
Além disso, alguns clientes que foram implantados anteriormente com AEM 6.5 ou versões anteriores usam os artefatos abaixo. Se a compilação local não estiver funcionando com o Quickstart jar e você suspeitar que isso ocorre devido à remoção de interfaces do AEM implantado no as a Cloud Service, entre em contato com o Suporte ao cliente. Eles podem determinar se você precisa de acesso. Requer alterações no back-end.
- 6.5 Jar da API Java™ obsoleta - um conjunto extra de interfaces que foram removidas desde o AEM 6.5
- 6.5 Jar Javadoc obsoleto - os Javadocs do conjunto adicional de interfaces
Criação para o SDK building-for-the-sdk
O SDK do AEM as a Cloud Service é usado para criar e implantar código personalizado. Consulte a documentação do Arquétipo de projeto do AEM. Em um nível superior, as seguintes etapas são executadas:
- Código de compilação. Conforme esperado, o código-fonte é compilado, gerando os pacotes de conteúdo resultantes
- Criar artefatos. Os artefatos são criados durante esse processo
- Analisar pacotes. Os pacotes são analisados usando o plug-in Maven Analyzer, que procura problemas no projeto Maven, como dependências ausentes
- Implantar artefatos. Os artefatos são implantados no servidor local.
As mesmas etapas são executadas pela Cloud Manager ao implantar em ambientes de nuvem. A execução de builds localmente permite o desenvolvimento e o teste locais. Os desenvolvedores podem descobrir problemas de código ou estruturais com eficiência antes de confirmar o controle de origem e acionar as implantações do Cloud Manager, que podem levar mais tempo.
Acesso ao SDK do AEM as a Cloud Service accessing-the-aem-as-a-cloud-service-sdk
- Você pode verificar o ícone AEM Admin Console Sobre o Adobe Experience Manager AEM para descobrir a versão do que você está executando na produção.
- O jar de início rápido e as Ferramentas do Dispatcher podem ser baixadas como um arquivo zip no Portal de distribuição de software. O acesso às listagens do SDK é limitado a pessoas que têm ambientes no AEM Managed Services ou AEM as a Cloud Service.
- O Jar da API Java™ e o Jar do Javadoc podem ser baixados por meio das ferramentas maven, seja pela linha de comando ou com o IDE de sua preferência.
- Os poms de projeto maven devem fazer referência ao seguinte pacote Jar de API. A dependência de poms de qualquer subpacote também deve ser referenciada.
<dependency>
<groupId>com.adobe.aem</groupId>
<artifactId>aem-sdk-api</artifactId>
<version>2019.11.3006.20191108T223635Z-191201</version>
<scope>provided</scope>
</dependency>
Atualizar um projeto local com uma nova versão do SDK refreshing-a-local-project-with-a-new-skd-version
Quando é recomendado atualizar o projeto local com um novo SDK?
O Adobe recomenda atualizá-lo após uma versão de manutenção mensal.
É opcional atualizá-lo após qualquer versão de manutenção diária. Os clientes são informados quando sua instância de produção é atualizada com êxito para uma nova versão do AEM. Para as versões de manutenção diárias, não é esperado que o novo SDK tenha mudado significativamente, se é que mudou. Ainda assim, é recomendável atualizar ocasionalmente o ambiente de desenvolvedor do AEM local com o SDK mais recente e, em seguida, recriar e testar o aplicativo personalizado. A versão de manutenção mensal geralmente inclui alterações mais impactantes e, portanto, os desenvolvedores devem atualizar, reconstruir e testar imediatamente.
Abaixo está o procedimento recomendado para atualizar um ambiente local:
- Verifique se qualquer conteúdo útil está comprometido com o projeto no controle do código-fonte ou disponível em um pacote de conteúdo mutável para importação posterior.
- O conteúdo do teste de desenvolvimento local deve ser armazenado separadamente para que não seja implantado como parte da build do pipeline do Cloud Manager. O motivo é que ele é usado apenas para desenvolvimento local.
- Interrompe a inicialização rápida em execução no momento.
- Mova a pasta
crx-quickstart
para uma pasta diferente para manter a pasta segura. - Observe a nova versão do AEM, que é anotada no Cloud Manager (ela é usada para identificar a nova versão do QuickStart Jar para baixar mais).
- Baixe o QuickStart JAR cuja versão corresponda à versão do AEM de produção no Portal de distribuição de software.
- Crie uma pasta totalmente nova e coloque o novo QuickStart Jar dentro dela.
- Inicie o novo QuickStart com os modos de execução desejados (renomeando o arquivo ou transmitindo os modos de execução por meio do
-r
).- Verifique se não há vestígios do início rápido antigo na pasta.
- Crie seu aplicativo AEM.
- Implante o aplicativo AEM no AEM local por meio do Gerenciador de pacotes.
- Instale todos os pacotes de conteúdo mutável necessários para o teste do ambiente local por meio do Gerenciador de pacotes.
- Prossiga com o desenvolvimento e implante as alterações conforme necessário.
Se houver conteúdo que deva ser instalado a cada nova versão de início rápido do AEM, inclua-o em um pacote de conteúdo e no controle de origem do projeto. Em seguida, instale-o sempre.
A recomendação é atualizar o SDK com frequência (por exemplo, duas vezes por semana) e descartar o estado local completo diariamente para não depender acidentalmente de dados com estado no aplicativo.
Se você depender do CryptoSupport (configurando as credenciais dos serviços na nuvem ou o serviço de email SMTP no AEM ou usando a API CryptoSupport no aplicativo), as propriedades criptografadas serão criptografadas por uma chave. Essa chave é gerada automaticamente no primeiro início de um ambiente AEM. Embora a configuração da nuvem trate da reutilização automática da CryptoKey específica do ambiente, é necessário injetar a cryptokey no ambiente de desenvolvimento local.
Por padrão, o AEM é configurado para armazenar os dados principais na pasta de dados de uma pasta, mas, para facilitar a reutilização no desenvolvimento, o processo AEM pode ser inicializado na primeira inicialização com "-Dcom.adobe.granite.crypto.file.disable=true
". Este processo gera os dados de criptografia em "/etc/key
".
Para poder reutilizar pacotes de conteúdo que contenham os valores criptografados, siga estas etapas:
- Ao iniciar inicialmente o quickstart.jar local, adicione o parâmetro abaixo: "
-Dcom.adobe.granite.crypto.file.disable=true
". É recomendável, mas opcional, sempre adicioná-lo. - Na primeira vez que você iniciou uma instância, crie um pacote que contenha um filtro para a raiz "
/etc/key
". Esse pacote contém o segredo a ser reutilizado em todos os ambientes para os quais você deseja que eles sejam reutilizados. - Exporte qualquer conteúdo mutável que contenha segredos ou procure os valores criptografados por meio do
/crx/de
para poder adicioná-lo ao pacote que é reutilizado nas instalações. - Sempre que você gerar uma nova instância (para substituir por uma nova versão ou como vários ambientes de desenvolvimento devem compartilhar as credenciais para teste), instale o pacote produzido nas etapas 2 e 3. Isso permite reutilizar o conteúdo sem a necessidade de reconfigurar manualmente. O motivo é porque agora a chave de criptografia está sincronizada.