Environnement de création build-environment

Découvrez l’environnement de création spécialisé dans lequel les utilisateurs et utilisatrices de Cloud Manager peuvent créer et tester votre code.

Détails de l’environnement details

Les environnements de création de Cloud Manager possèdent les attributs suivants.

Référentiels Maven HTTPS https-maven

Cloud Manager version 2023.10.0 a commencé une mise à jour continue de l’environnement de création (achevée avec la version 2023.12.0), qui incluait une mise à jour vers Maven 3.8.8. L’amélioration de la sécurité visant à atténuer les vulnérabilités potentielles a constitué un changement significatif introduit dans Maven 3.8.1. Plus précisément, Maven désactive désormais par défaut tous les miroirs http://* non sécurisés, comme indiqué dans les Notes de mise à jour de Maven.

Suite à cette amélioration de la sécurité, certaines personnes peuvent rencontrer des problèmes lors de l’étape de création, en particulier lors du téléchargement d’artefacts à partir de référentiels Maven qui utilisent des connexions HTTP non sécurisées.

Pour garantir une expérience fluide avec la version mise à jour, Adobe recommande aux utilisateurs et utilisatrices de mettre à jour leurs référentiels Maven de sorte à utiliser HTTPS au lieu de HTTP. Cet ajustement s’aligne sur la transition croissante du secteur vers des protocoles de communication sécurisés et contribue à maintenir un processus de création sécurisé et fiable.

Utiliser une version de Java spécifique using-java-version

Par défaut, les projets créés par le processus de création Cloud Manager utilisent le JDK Oracle 8. Les clients qui souhaitent utiliser un autre JDK peuvent sélectionner une autre version de JDK pour l’ensemble du processus d’exécution Maven.

Autre version du JDK d’exécution Maven alternate-maven

Il est possible de sélectionner Oracle 8 ou Oracle 11 en tant que JDK pour l’ensemble de l’exécution de Maven. Cette approche modifie le JDK utilisé pour tous les plug-ins. Par conséquent, la vérification et l’application de la version Java à l’aide du plug-in Apache Maven Enforcer fonctionneront.

Pour ce faire, créez un fichier nommé .cloudmanager/java-version dans la branche de référentiel Git utilisée par le pipeline. Ce fichier peut avoir le contenu 11 ou 8. Toute autre valeur est ignorée. Si 11 est spécifié, le système utilise Oracle 11 et définit la variable d’environnement JAVA_HOME sur /usr/lib/jvm/jdk-11.0.22. Si 8 est spécifié, le système utilise Oracle 8 et définit la variable d’environnement JAVA_HOME sur /usr/lib/jvm/jdk1.8.0_401.

Variables d’environnement environment-variables

Variables d’environnement standard standard-environ-variables

Dans certains cas, vous jugerez peut-être nécessaire de modifier le processus de création en fonction des informations sur le programme ou le pipeline.

Par exemple, lorsque vous utilisez un outil tel que gulp pour la minimisation JavaScript, vous préférerez peut-être utiliser des niveaux de minimisation différents pour les environnements de développement par rapport aux environnements d’évaluation et de production.

Pour la prise en charge, Cloud Manager ajoute des variables d’environnement standard au conteneur de création pour chaque exécution.

Disponibilité des variables d’environnement standard availability

Les variables d’environnement standard peuvent être utilisées à plusieurs endroits.

Environnements de création, de prévisualisation et de publication author-preview-publish

Les variables d’environnement standard et les secrets peuvent être utilisés dans les environnements de création, de prévisualisation et de publication.

Dispatcher dispatcher

Seules les variables d’environnement normales peuvent être utilisées avec le Dispatcher. Les secrets ne peuvent pas être utilisés.

Toutefois, les variables d’environnement ne peuvent pas être utilisées dans les directives IfDefine.

Configurations OSGi osgi

Les variables d’environnement normales et les secrets peuvent être utilisés dans les configurations OSGi.

Variables de pipeline pipeline-variables

Dans certains cas, votre processus de création peut dépendre de variables de configuration spécifiques qui ne seraient pas appropriées pour le référentiel Git ou qui doivent varier entre les exécutions de pipeline utilisant la même branche.

Cloud Manager permet de configurer ces variables par le biais de l’API Cloud Manager ou de l’interface de ligne de commande de Cloud Manager pour chaque pipeline. Les variables peuvent être stockées en texte brut ou chiffrées au repos. Dans les deux cas, les variables sont disponibles dans l’environnement de création en tant que variable d’environnement qui peut ensuite être référencée depuis le fichier pom.xml ou d’autres scripts de création.

Pour définir une variable à l’aide de l’interface de ligne de commande, exécutez une commande similaire à la suivante.

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

Les variables actuelles peuvent être répertoriées à l’aide d’une commande similaire à la suivante.

$ aio cloudmanager:list-pipeline-variables PIPELINEID

Les variables doivent respecter certaines limites.

En cas d’utilisation dans un fichier pom.xml Maven, il est généralement recommandé de mapper ces variables aux propriétés Maven en utilisant une syntaxe similaire à la suivante.

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

Installer des packages système supplémentaires installing-additional-system-packages

Pour un fonctionnement optimal, certaines créations requièrent l’installation de packages système supplémentaires. Par exemple, une version peut appeler un script Python ou Ruby et, par conséquent, nécessiter l’installation d’un interprète de langue approprié. Ce scénario peut être réalisé en appelant le exec-maven-plugin pour invoquer APT. Cette exécution doit généralement être encapsulée dans un profil Maven spécifique à Cloud Manager. Par exemple, pour installer Python, vous pouvez effectuer les opérations suivantes :

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

Cette technique peut également être utilisée pour installer des packages spécifiques à la langue. Autrement dit, utilisez gem pour RubyGems ou pip pour les packages Python.