Die Build-Umgebung build-environment

Erfahren Sie mehr über die spezielle Build-Umgebung, die Cloud Manager zum Erstellen und Testen Ihres Codes verwendet.

Umgebungsdetails details

Die Build-Umgebungen von Cloud Manager weisen folgende Eigenschaften auf.

HTTPS-Maven-Repositorys https-maven

Cloud Manager 2023.10.0 begann mit einem rollierenden Update der Build-Umgebung (abgeschlossen mit Version 2023.12.0), das ein Update auf Maven 3.8.8 enthielt. Eine in Maven 3.8.1 eingeführte Änderung war eine Sicherheitsverbesserung, um potenzielle Schwachstellen zu beheben. Insbesondere deaktiviert Maven nun alle unsicheren http://*-Spiegelungen standardmäßig, wie in den Maven-Versionshinweisen beschrieben.

Einige Benutzende stoßen während des Build-Schritts auf Probleme beim Herunterladen von Artefakten aus Maven-Repositorys, die unsichere HTTP-Verbindungen verwenden.

Um ein reibungsloses Erlebnis mit der aktualisierten Version zu gewährleisten, empfiehlt Adobe, dass Benutzende ihre Maven-Repositorys so aktualisieren, dass sie HTTPS anstelle von HTTP verwenden. Diese Anpassung unterstützt die Umstellung der Branche auf sichere Kommunikationsprotokolle und sorgt für einen sicheren und zuverlässigen Build-Prozess.

Verwenden einer bestimmten Java-Version using-java-version

Standardmäßig werden Projekte vom Cloud Manager-Build-Prozess mit dem Oracle 8 JDK erstellt. Kunden, die ein alternatives JDK verwenden möchten, können eine alternative JDK-Version für den gesamten Maven-Ausführungsprozess auswählen.

Alternative JDK-Version für die Maven-Ausführung alternate-maven

Sie können Oracle 8 oder Oracle 11 als JDK für die gesamte Maven-Ausführung auswählen. Dieser Ansatz ändert das für alle Plug-ins verwendete JDK. Daher wird das Überprüfen und Erzwingen der Java-Version mit dem Apache Maven Enforcer-Plug-) unterstützt.

Erstellen Sie dazu eine Datei mit dem Namen .cloudmanager/java-version in der von der Pipeline verwendeten Git-Repository-Verzweigung. Diese Datei kann entweder den Inhalt 11 oder 8 enthalten. Alle anderen Werte werden ignoriert. Wenn 11 angegeben ist, verwendet das System Oracle 11 und setzt die JAVA_HOME Umgebungsvariable auf /usr/lib/jvm/jdk-11.0.22. Wenn 8 angegeben ist, verwendet das System Oracle 8 und setzt die JAVA_HOME Umgebungsvariable auf /usr/lib/jvm/jdk1.8.0_401.

Umgebungsvariablen environment-variables

Standard-Umgebungsvariablen standard-environ-variables

In einigen Fällen ist es erforderlich, den Build-Prozess basierend auf Informationen über das Programm oder die Pipeline zu variieren.

Wenn Sie beispielsweise ein Tool wie gulp für die JavaScript-Minimierung verwenden, sollten Sie im Vergleich zu Staging- und Produktionsumgebungen unterschiedliche Minimierungsstufen für die Entwicklung verwenden.

Um dies zu unterstützen, fügt Cloud Manager diese Standard-Umgebungsvariablen bei jeder Ausführung dem Build-Container hinzu.

Verfügbarkeit von Standard-Umgebungsvariablen availability

Standard-Umgebungsvariablen können an verschiedenen Stellen verwendet werden.

Authoring-, Vorschau- und Veröffentlichungsumgebungen author-preview-publish

In der Authoring-, Vorschau- und Veröffentlichungsumgebung können sowohl reguläre Umgebungsvariablen als auch Geheimnisse verwendet werden.

Dispatcher dispatcher

Im Dispatcher können nur reguläre Umgebungsvariablen verwendet werden. Geheimnisse können nicht verwendet werden.

Allerdings können Umgebungsvariablen nicht in IfDefine-Richtlinien verwendet werden.

OSGi-Konfigurationen osgi

In den OSGi-Konfigurationen können sowohl reguläre Umgebungsvariablen als auch Geheimnisse verwendet werden.

Pipeline-Variablen pipeline-variables

In einigen Fällen hängt der Build-Prozess von bestimmten Konfigurationsvariablen ab. Diese Variablen können nicht im Git-Repository platziert werden oder müssen zwischen Pipeline-Ausführungen mit derselben Verzweigung variieren.

Cloud Manager ermöglicht die Konfiguration dieser Variablen über die Cloud Manager-API oder die Cloud Manager-CLI individuell für die Pipelines. Variablen werden entweder als reiner Text oder im Ruhezustand verschlüsselt gespeichert. In beiden Fällen werden Variablen innerhalb der Build-Umgebung als Umgebungsvariable bereitgestellt, die dann in der Datei pom.xml oder anderen Build-Skripten referenziert werden kann.

Um eine Variable mithilfe der CLI festzulegen, führen Sie einen Befehl ähnlich dem folgenden aus.

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

Aktuelle Variablen können mit einem Befehl ähnlich dem folgenden aufgelistet werden.

$ aio cloudmanager:list-pipeline-variables PIPELINEID

Variablen müssen bestimmte Einschränkungen einhalten.

Bei Verwendung in einer Maven-Datei pom.xml ist es in der Regel hilfreich, diese Variablen Maven-Eigenschaften mithilfe einer ähnlichen Syntax wie der folgenden zuzuordnen.

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

Installieren zusätzlicher Systempakete installing-additional-system-packages

Um ordnungsgemäß zu funktionieren, müssen einige Builds zusätzliche Systempakete installieren. Ein Build ruft beispielsweise ein Python- oder Ruby-Skript auf und benötigt einen entsprechenden Sprach-Interpreter. Dieses Szenario kann durch Aufrufen des -exec-maven-plugin zum Aufrufen von APT gehandhabt werden. Diese Ausführung ist in einem Cloud Manager-spezifischen Maven-Profil eingeschlossen. Um beispielsweise Python zu installieren, können Sie wie folgt vorgehen:

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

Mit dieser Methode können Sie auch sprachspezifische Pakete installieren. Das heißt, Sie verwenden gem für RubyGems oder pip für Python-Pakete.