DocumentaçãoAEM as a Cloud ServiceGuia do usuário

Canal de pré-lançamento do Adobe Experience Manager as a Cloud Service prerelease-channel

Last update: Wed Jun 05 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • Administrador

Saiba como usar o canal de pré-lançamento para visualizar os recursos futuros do AEM as a Cloud Service.

Introdução introduction

O Adobe Experience Manager as a Cloud Service fornece novos recursos regularmente, de acordo com o Roteiro de versões do Experience Manager.

Para se familiarizar com os recursos que estão programados para entrar em operação na versão seguinte, você pode se inscrever no canal de pré-lançamento, que pode ser acessado pela configuração de seus ambientes de desenvolvimento ou de qualquer ambiente de sandbox. Você pode visualizar as alterações acessíveis por meio da interface do AEM e desenvolver o código com base nas novas APIs de pré-lançamento.

A lista de recursos de pré-lançamento de um determinado recurso é publicada nas notas de versão.

Versões do AEM as a Cloud Service releases

O AEM as a Cloud Service tem dois tipos de versões.

  • Os lançamentos de recursos adicionam recursos e funcionalidades ao AEM as a Cloud Service após a ativação
  • Versões de manutenção adicionam atualizações de segurança, aprimoramentos de desempenho e correções de erros, e são aplicadas com frequência.

Esse padrão garante uma atualização contínua de versões sem interrupção do serviço.

O canal de pré-lançamento permite visualizar os recursos programados para a próxima versão de recursos, a fim de avaliar a funcionalidade futura e planejar sua possível implementação em projetos. Ele permite que você planeje com antecedência a próxima versão do recurso.

Por exemplo, se for o mês de maio e você estiver inscrito no canal de pré-lançamento, será possível avaliar os recursos da próxima versão de junho.

Gráfico de cronograma de pré-lançamento

O pré-lançamento oferece uma visão antecipada do próximo mês de lançamento de recursos do AEMaaCS, permitindo avaliar o impacto dos novos recursos em seus projetos e personalizações e planejar a implementação de tais recursos, testes e treinamento de usuários.

Aproveitar de forma eficaz o canal de pré-lançamento é um processo de quatro etapas.

  1. Marcar o seu calendário
  2. Revisar as notas de versão
  3. Acessar e experimentar os novos recursos
  4. Treinar seus usuários

Marcar o seu calendário mark-calendars

As versões de recursos são programadas com bastante antecedência e as datas de ativação são publicadas na Adobe Experience League.

Anote as datas de lançamento para que você possa reservar um tempo para revisar e testar os recursos futuros.

Revisar as notas de versão release-notes

Depois de marcar as datas de lançamento no seu calendário, verifique o site da Adobe Experience League no dia do lançamento para obter as notas de versão mais recentes.

Cada versão é acompanhada de notas de versão que documentam não apenas as novidades dessa versão, mas também os recursos disponíveis na avaliação de pré-lançamento. Conheça as novidades com antecedência e planeje a adoção dos recursos mais recentes do AEMaaCS.

Você também pode verificar os problemas conhecidos que são publicados em todas as versões para estar ciente de quaisquer problemas técnicos que possam representar um desafio para a avaliação ou possível adoção de novos recursos.

Ative o canal de pré-lançamento para acessar e experimentar novos recursos new-features

O canal de pré-lançamento pode ser ativado em qualquer ambiente de desenvolvimento ou sandbox. O pré-lançamento não pode ser habilitado em ambientes de preparo ou produção.

Os recursos de pré-lançamento podem ser vistos de diferentes maneiras:

Ambientes em nuvem cloud-environments

Para atualizar um ambiente de nuvem para usar o pré-lançamento, você deve adicionar uma nova variável de ambiente. Você pode fazer isso usando a interface do Cloud Manager ou através da CLI.

Adicionar variável de ambiente usando a interface add-with-ui

  1. Faça logon no Cloud Manager, em my.cloudmanager.adobe.com, e selecione a organização apropriada.

  2. Navegue até o programa em que deseja ativar o pré-lançamento.

  3. Selecione o ambiente em que deseja ativar o pré-lançamento e acesse suas configurações em Programa > Ambiente > Configuração do ambiente.

  4. Adicione uma nova variável de ambiente:

    table 0-row-4 1-row-4
    Nome Valor Serviço aplicado Tipo
    AEM_RELEASE_CHANNEL prerelease Todos Variável

  5. Salve as alterações e o ambiente será atualizado com as opções do recurso de pré-lançamento ativadas.

    Nova variável de ambiente

Adicionar variável de ambiente usando a CLI add-with-cli

Você também pode usar a API e a CLI do Cloud Manager para atualizar as variáveis de ambiente.

  • Usando o ponto de acesso das variáveis de ambiente da API do Cloud Manager, configure a variável de ambiente AEM_RELEASE_CHANNEL com o valor prerelease.

    code language-text 
    PATCH /program/{programId}/environment/{environmentId}/variables
[
        {
                "name" : "AEM_RELEASE_CHANNEL",
                "value" : "prerelease",
                "type" : "string"
        }
]

  • A CLI do Cloud Manager também pode ser usada

    code language-shell 
    aio cloudmanager:environment:set-variables <ENVIRONMENT_ID> --programId=<PROGRAM_ID> --variable AEM_RELEASE_CHANNEL "prerelease

A variável pode ser excluída ou retornada a um valor diferente se você desejar que o ambiente seja restaurado ao comportamento do canal padrão (que não seja o de pré-lançamento)

SDK local local-sdk

Você pode ver novos recursos no console Sites no Quickstart do SDK local e programar usando as novas APIs de pré-lançamento, configurando o seu projeto Maven para fazer referência à API Jar de pré-lançamento localizada na Maven Central. Você também pode ver esses recursos de pré-lançamento no seu ambiente de desenvolvimento local, iniciando o Quickstart do SDK tradicional no modo de pré-lançamento.

Iniciar o Quickstart do SDK no modo de pré-lançamento prerelease-mode

  1. Baixe o SDK no portal de distribuição de softwares e instale como descrito em Acesso ao SDK do AEM as a Cloud Service.
  2. Ao iniciar o Quickstart do SDK, inclua o argumento -r prerelease.

O valor é aderente, assim, ele só pode ser selecionado na primeira inicialização. Reinstale o SDK para alterar a opção de linha de comando.

Como pode haver várias versões de manutenção do AEM entre as versões de recursos mensais, você pode baixar esses novos SDKs e fazer referência às novas versões do Jar da API do SDK em projetos maven. As versões de manutenção não incluirão recursos adicionais de pré-lançamento, mas poderão incluir outras alterações menores, como correções de erros, correções de segurança e aprimoramentos de desempenho.
Javadocs são publicados no Maven Central.

Criar usando o SDK de pré-lançamento build-sdk

  1. Modifique o pom.xml do seu projeto Maven para fazer referência a um API.jar do SDK de pré-lançamento distinto, que será publicado na Maven Central. Ele contém qualquer nova API Java para recursos de pré-lançamento e é dependente do API.jar do SDK. Ele usa a mesma versão.

    Como exemplo, veja um trecho da seção de gerenciamento de dependência do POM principal que faz referência ao API.jar padrão:

    code language-none 
    <dependencyManagement>
 <dependencies>
     <dependency>
         <groupId>com.adobe.aem</groupId>
         <artifactId>aem-sdk-api</artifactId>
         <version>${aem.sdk.api}</version>
         <scope>provided</scope>
     </dependency>

    E o uso em um módulo:

    code language-none 
     <dependencies>
  <dependency>
      <groupId>com.adobe.aem</groupId>
      <artifactId>aem-sdk-api</artifactId>
  </dependency>

    Para alterar para o SDK de pré-lançamento, basta alterar a dependência de com.adobe.aem:aem-sdk-api para com.adobe.aem:aem-prerelease-sdk-api, conforme observado abaixo:

    code language-none 
    <dependencyManagement>
 <dependencies>
   <dependency>
         <groupId>com.adobe.aem</groupId>
         <artifactId>aem-prerelease-sdk-api</artifactId>
         <version>${aem.sdk.api}</version>
         <scope>provided</scope>
   </dependency>
<dependencies>
   <dependency>
      <groupId>com.adobe.aem</groupId>
      <artifactId>aem-prerelease-sdk-api</artifactId>
   </dependency>

    Como de costume, projetos individuais podem usar a dependência.

  2. Implante no servidor local.

  3. Se ele funcionar conforme esperado localmente, confirme o código em uma ramificação de desenvolvimento e use um pipeline de não produção do Cloud Manager para implantar em um ambiente que assine o canal de pré-lançamento.

CAUTION
O artifactId aem-prerelease-sdk-api nunca deve ser usado ao implantar no ambiente de preparo ou produção. Sempre use aem-sdk-api ao implantar pelo pipeline de produção. Da mesma forma, o código que faz referência às APIs de pré-lançamento não deve ser implantado por meio do pipeline de produção.

O plug-in Maven Build Analyzer do SDK do AEM CS v1.0 e superior detectará se a API de pré-lançamento é usada em um projeto inspecionando as dependências. Se o analisador a encontrar, ele usará a API de pré-lançamento do SDK para analisar o projeto.

Treinar seus usuários train-users

Após testar os novos recursos no canal de pré-lançamento e decidir usá-los em seus projetos, é necessário treinar os usuários.

A Adobe Experience League oferece muitos recursos de aprendizado para o AEMaaCS.

Considerações considerations

Há alguns detalhes que devem ser observados ao usar o canal de pré-lançamento.

  • O canal de pré-lançamento não contém necessariamente todos os novos recursos a serem implementados na próxima versão.
  • Os recursos no pré-lançamento são submetidos a uma garantia de qualidade rigorosa e se destinam a ser completos em recursos, e não de qualidade beta. Caso detecte problemas, reporte-os, como faria se suspeitasse de erros em recursos em uma versão comum do AEM.
  • Para determinar se um ambiente está configurado para o canal de pré-lançamento, vá até a página Sobre do console do AEM e verifique se o número da versão do AEM inclui um sufixo de pré-lançamento, como Adobe Experience Manager 2021.4.5226.20210427T070726Z-210429-PRERELEASE.

Sobre

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab