Criar ambiente do Cloud Manager build-environment

Saiba mais sobre o ambiente de compilação do Cloud Manager e como ele cria e testa seu código.

Detalhes do ambiente de compilação build-environment-details

O Cloud Manager compila e testa seu código usando um ambiente de compilação especializado.

Repositórios Maven HTTPS https-maven

O Cloud Manager versão 2023.10.0 iniciou uma atualização contínua do ambiente de compilação (que foi concluída com a versão 2023.12.0), que incluiu uma atualização para Maven 3.8.8. Uma mudança significativa introduzida no Maven 3.8.1 foi um aprimoramento de segurança destinado a atenuar possíveis vulnerabilidades. Mais especificamente, o Maven agora desabilita por padrão todos os espelhos inseguros de http://*, conforme descrito nas notas de versão do Maven.

Alguns usuários encontram problemas durante a etapa de criação ao baixar artefatos de repositórios Maven que usam conexões HTTP não seguras.

Para garantir uma experiência perfeita com a versão atualizada, a Adobe recomenda atualizar os repositórios Maven para usar HTTPS em vez de HTTP. Esse ajuste se alinha à mudança do setor para protocolos de comunicação seguros e ajuda a manter um processo de criação seguro e confiável.

Usar uma versão específica do Java using-java-support

O processo de compilação do Cloud Manager usa o Oracle 8 JDK para criar projetos por padrão, mas os clientes do AEM Cloud Service definem a versão do JDK de execução do Maven como 21 (preferencial), 17 ou 11.

Definir a versão do JDK Maven alternate-maven-jdk-version

Para definir o JDK de execução do Maven, crie um arquivo chamado .cloudmanager/java-version na ramificação do repositório Git usada pelo pipeline. Edite o arquivo de forma que ele contenha apenas o texto 21 ou 17. Embora a Cloud Manager também aceite o valor 8, essa versão não é mais compatível com os projetos do AEM Cloud Service. Qualquer outro valor será ignorado. Quando 21 ou 17 é especificado, o Oracle Java 21 ou o Oracle Java 17 é usado.

Pré-requisitos para migrar para a criação com Java 21 ou Java 17 prereq-for-building

Para construir com o Java 21 ou Java 17, o Cloud Manager agora usa o SonarQube 9.9, que é compatível com essas versões do Java. Essa alteração foi introduzida na versão 2025.1.0 do Cloud Manager. Nenhuma ação do cliente é necessária para atualizar o SonarQube. Para obter mais detalhes e entender a alteração, consulte as Notas de versão para Cloud Manager 2025.1.0.

Ao migrar seu aplicativo para uma nova versão de build e versão de tempo de execução do Java, teste completamente nos ambientes de desenvolvimento e preparo antes de implantar na produção.

A Adobe recomenda a seguinte estratégia de implantação:

Recursos de tradução translation-features

Os seguintes recursos não funcionam corretamente quando implantados no tempo de execução do Java 21, e a Adobe espera resolvê-los no início de 2025:

Requisitos de tempo de execução runtime-requirements

O tempo de execução do Java 21 foi aplicado a todos os ambientes elegíveis, que são ambientes no AEM versão 17098 ou posterior que atendem aos critérios abaixo. Se um ambiente não atender aos critérios, é importante fazer ajustes para garantir desempenho, disponibilidade e segurança.

O AEM Cloud Service SDK é compatível com o Java 21 e permite verificar a compatibilidade do seu projeto com o Java 21 antes de executar um pipeline da Cloud Manager.

Requisitos de tempo de criação build-time-reqs

Os ajustes a seguir são necessários para permitir a criação do projeto com Java 21 e Java 17. Eles podem ser atualizados mesmo antes de você executar o Java 21 e o Java 17, pois são compatíveis com versões Java mais antigas.

Recomenda-se que os clientes do AEM Cloud Service criem seus projetos com o Java 21 o mais rápido possível para aproveitar os novos recursos de linguagem.

<project>
  ...
  <build>
    ...
    <plugins>
      ...
      <plugin>
        <groupId>org.apache.felix</groupId>
        <artifactId>maven-scr-plugin</artifactId>
        <version>1.26.4</version>
        <executions>
          <execution>
            <id>generate-scr-scrdescriptor</id>
            <goals>
              <goal>scr</goal>
            </goals>
          </execution>
        </executions>
        <dependencies>
          <dependency>
            <groupId>org.ow2.asm</groupId>
            <artifactId>asm-analysis</artifactId>
            <version>9.7.1</version>
            <scope>compile</scope>
          </dependency>
        </dependencies>
      </plugin>
      ...
    </plugins>
    ...
  </build>
  ...
</project>

Variáveis de ambiente - padrão environment-variables

Configure o processo de criação com base nas informações sobre o programa ou pipeline.

Por exemplo, se a minificação do JavaScript ocorrer no momento da criação usando uma ferramenta como o gulp, diferentes níveis de minificação serão preferidos para vários ambientes. Uma build de desenvolvimento usa um nível de minificação mais leve em comparação ao preparo e à produção.

Para permitir isso, o Cloud Manager adiciona essas variáveis de ambiente padrão ao contêiner de compilação para cada execução.

Variáveis de ambiente - pipeline pipeline-variables

O processo de compilação exige variáveis de configuração específicas que não são armazenadas no repositório Git. Além disso, é necessário ajustar essas variáveis entre execuções de pipeline usando a mesma ramificação.

Consulte também Configurar variáveis de pipeline para obter mais informações.

Instalar pacotes de sistema adicionais installing-additional-system-packages

Algumas compilações exigem pacotes de sistema adicionais para funcionarem plenamente. Por exemplo, uma compilação chama um script Python ou Ruby e deve ter um interpretador de linguagem apropriado instalado. Este processo de instalação pode ser gerenciado chamando o exec-maven-plugin em seu pom.xml para invocar o APT. Essa execução é encapsulada em um perfil Maven específico do Cloud Manager. Este exemplo instala o Python.

        <profile>
            <id>install-python</id>
            <activation>
                <property>
                        <name>env.CM_BUILD</name>
                </property>
            </activation>
            <build>
                <plugins>
                    <plugin>
                        <groupId>org.codehaus.mojo</groupId>
                        <artifactId>exec-maven-plugin</artifactId>
                        <version>1.6.0</version>
                        <executions>
                            <execution>
                                <id>apt-get-update</id>
                                <phase>validate</phase>
                                <goals>
                                    <goal>exec</goal>
                                </goals>
                                <configuration>
                                    <executable>apt-get</executable>
                                    <arguments>
                                        <argument>update</argument>
                                    </arguments>
                                </configuration>
                            </execution>
                            <execution>
                                <id>install-python</id>
                                <phase>validate</phase>
                                <goals>
                                    <goal>exec</goal>
                                </goals>
                                <configuration>
                                    <executable>apt-get</executable>
                                    <arguments>
                                        <argument>install</argument>
                                        <argument>-y</argument>
                                        <argument>--no-install-recommends</argument>
                                        <argument>python</argument>
                                    </arguments>
                                </configuration>
                            </execution>
                        </executions>
                    </plugin>
                </plugins>
            </build>
        </profile>

Essa mesma técnica pode ser usada para instalar pacotes de linguagem específicos, por exemplo, usando gempara RubyGems ou pip para Pacotes Python.