El entorno de compilación build-environment

Obtenga información sobre el entorno de compilación especializado que utiliza Cloud Manager para generar y probar su código.

Detalles del entorno details

Los entornos de compilación de Cloud Manager tienen los atributos siguientes.

Repositorios de Maven HTTPS https-maven

Cloud Manager 2023.10.0 inició una actualización gradual del entorno de compilación (que se completó con la versión 2023.12.0), que incluyó una actualización de Maven 3.8.8. Un cambio introducido en Maven 3.8.1 fue una mejora de seguridad para abordar posibles vulnerabilidades. En concreto, Maven ahora deshabilita de forma predeterminada todas las duplicaciones de http://* inseguras, tal como se describe en las Notas de la versión de Maven.

Algunos usuarios encuentran problemas durante el paso de generación al descargar artefactos de repositorios Maven que utilizan conexiones HTTP no seguras.

Para garantizar una experiencia sin problemas con la versión actualizada, Adobe recomienda actualizar los repositorios de Maven para que utilicen HTTPS en lugar de HTTP. Este ajuste respalda la transición del sector hacia protocolos de comunicación seguros y mantiene un proceso de fabricación seguro y fiable.

Uso de una versión de Java específica using-java-version

De forma predeterminada, los proyectos se crean mediante el proceso de compilación de Cloud Manager con el JDK de Oracle 8. Los clientes que deseen utilizar un JDK alternativo pueden seleccionar una versión JDK alternativa para todo el proceso de ejecución de Maven.

Versión alternativa del JDK de ejecución de Maven alternate-maven

Es posible seleccionar Oracle 8 o Oracle 11 como JDK para toda la ejecución de Maven. Este método cambia el JDK utilizado para todos los complementos. Como resultado, es compatible comprobar y aplicar la versión de Java mediante el complemento Apache Maven Enforcer.

Para realizar este proceso, cree un archivo con el nombre .cloudmanager/java-version en la rama del repositorio Git utilizada por la canalización. Este archivo puede tener el contenido 11 o 8. Se omite cualquier otro valor. Si se especifica 11, el sistema usa Oracle 11 y establece la variable de entorno JAVA_HOME en /usr/lib/jvm/jdk-11.0.22. Si se especifica 8, el sistema usa Oracle 8 y establece la variable de entorno JAVA_HOME en /usr/lib/jvm/jdk1.8.0_401.

Variables del entorno environment-variables

Variables de entorno estándar standard-environ-variables

En algunos casos, es necesario variar el proceso de compilación en función de la información sobre el programa o la canalización.

Por ejemplo, cuando utilice una herramienta como gulp para la minificación de JavaScript, utilice diferentes niveles de minificación para los entornos de desarrollo frente a los de ensayo y producción.

Para ello, Cloud Manager añade variables de entorno estándar al contenedor de compilación para cada ejecución.

Disponibilidad de variables de entorno estándar availability

Las variables de entorno estándar se pueden usar en varios lugares.

Creación, previsualización y publicación de entornos author-preview-publish

Tanto las variables de entorno normales como los secretos se pueden usar en los entornos de creación, previsualización y publicación.

Dispatcher dispatcher

Con Dispatcher solo se pueden usar variables de entorno normales. Los secretos no se pueden usar.

Sin embargo, las variables de entorno no se pueden usar en directivas IfDefine.

Configuraciones de OSGi osgi

Tanto las variables de entorno normales como los secretos se pueden utilizar en las configuraciones OSGi.

Variables de canalización pipeline-variables

En algunos casos, el proceso de generación depende de variables de configuración específicas. Estas variables no son adecuadas para colocarse en el repositorio Git o deben variar entre ejecuciones de canalización que utilicen la misma rama.

Cloud Manager permite que estas variables se configuren mediante la API de Cloud Manager o la CLI de Cloud Manager por canalización. Las variables se almacenan como texto sin formato o se cifran en reposo. En cualquier caso, las variables están disponibles en el entorno de compilación como una variable de entorno a la que se puede hacer referencia desde dentro del archivo pom.xml u otros scripts de compilación.

Para establecer una variable mediante la CLI, ejecute un comando similar al siguiente.

$ aio cloudmanager:set-pipeline-variables PIPELINEID --variable MY_CUSTOM_VARIABLE test

Las variables actuales se pueden enumerar mediante un comando similar al siguiente.

$ aio cloudmanager:list-pipeline-variables PIPELINEID

Las variables deben cumplir ciertas limitaciones.

Cuando se utiliza dentro de un archivo pom.xml de Maven, suele resultar útil asignar estas variables a las propiedades de Maven mediante una sintaxis similar a la siguiente.

        <profile>
            <id>cmBuild</id>
            <activation>
                <property>
                    <name>env.CM_BUILD</name>
                </property>
            </activation>
            <properties>
                <my.custom.property>${env.MY_CUSTOM_VARIABLE}</my.custom.property>
            </properties>
        </profile>

Instalación de paquetes de sistema adicionales installing-additional-system-packages

Para funcionar correctamente, algunas compilaciones requieren que se instalen paquetes de sistema adicionales. Por ejemplo, una compilación invoca un script de Python o Ruby y necesita instalar un intérprete de idioma adecuado. Este escenario se puede controlar llamando a exec-maven-plugin para invocar APT. Esta ejecución está envuelta en un perfil Maven específico de Cloud Manager. Por ejemplo, para instalar Python puede hacer lo siguiente:

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

Este método también se puede utilizar para instalar paquetes específicos del idioma. Es decir, usar gem para RubyGems o pip para paquetes de Python.