Byggmiljön build-environment

Läs om den speciella byggmiljö som Cloud Manager-användare kan använda för att skapa och testa din kod.

Miljöinformation details

Cloud Manager byggmiljöer har följande attribut.

HTTPS Maven-databaser https-maven

Cloud Manager 2023.10.0 påbörjade en rullande uppdatering av byggmiljön (som slutfördes med version 2023.12.0), som innehöll en uppdatering till Maven 3.8.8. En betydande förändring som introducerades i Maven 3.8.1 var en säkerhetsförbättring som syftar till att minska potentiella sårbarheter. Maven inaktiverar nu alla osäkra http://*-speglar som standard, vilket beskrivs i versionsinformationen för Maven.

Som ett resultat av den här säkerhetsförbättringen kan vissa användare råka ut för problem under byggfasen, särskilt när artefakter hämtas från Maven-databaser som använder osäkra HTTP-anslutningar.

För att få en smidig upplevelse med den uppdaterade versionen rekommenderar Adobe att användare uppdaterar sina Maven-databaser till att använda HTTPS i stället för HTTP. Denna justering är anpassad efter branschens växande övergång till säkra kommunikationsprotokoll och hjälper till att upprätthålla en säker och tillförlitlig byggprocess.

Använda en specifik Java-version using-java-version

Som standard används JDK för projekt som byggts med Cloud Manager-byggprocessen. Kunder som vill använda en alternativ JDK har två alternativ.

Maven Toolchains maven-toolchains

Med plugin-programmet Maven Toolchains kan projekt välja en specifik JDK (eller verktygskedja) som ska användas i kontexten för verktygskedjemedvetna Maven-plugin. Den här processen görs i projektets pom.xml-fil genom att ange en leverantör och ett versionsvärde. Ett exempelavsnitt i filen pom.xml är följande:

        <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-toolchains-plugin</artifactId>
    <version>1.1</version>
    <executions>
        <execution>
            <goals>
                <goal>toolchain</goal>
            </goals>
        </execution>
    </executions>
    <configuration>
        <toolchains>
            <jdk>
                <version>11</version>
                <vendor>oracle</vendor>
            </jdk>
        </toolchains>
    </configuration>
</plugin>

Den här processen gör att alla verktygskedjedåliga Maven-plugin-program använder Oraclet JDK, version 11.

När du använder den här metoden körs Maven fortfarande med standard-JDK (Oracle 8) och miljövariabeln JAVA_HOME ändras inte. Kontroll eller genomförande av Java-versionen via plugin-program som Apache Maven Enforcerfungerar därför inte och sådana plugin-program får inte användas.

De aktuella kombinationerna av leverantör/version är:

JDK-version för körning av alternativ Maven alternate-maven

Du kan också välja Oracle 8 eller Oracle 11 som JDK för hela Maven-exekveringen. Till skillnad från alternativen för verktygskedjor ändras det JDK som används för alla plugin-program, såvida inte konfigurationen för verktygskedjor också är inställd. I så fall används fortfarande konfigurationen för verktygskedjor för Maven-plugin-program som är medvetna för verktygskedjor. Det innebär att kontroll och genomförande av Java-versionen med plugin-programmet Apache Maven Enforcer fungerar.

Om du vill göra det skapar du en fil med namnet .cloudmanager/java-version i Git-databasgrenen som används av pipeline. Den här filen kan ha antingen innehållet 11 eller 8. Alla andra värden ignoreras. Om 11 anges används Oracle 11 och miljövariabeln JAVA_HOME anges till /usr/lib/jvm/jdk-11.0.22. Om 8 anges används Oracle 8 och miljövariabeln JAVA_HOME anges till /usr/lib/jvm/jdk1.8.0_401.

Miljövariabler environment-variables

Standardmiljövariabler standard-environ-variables

I vissa fall kan det vara nödvändigt att variera byggprocessen baserat på information om programmet eller pipeline.

Om du till exempel använder ett verktyg som Glup för JavaScript-miniatyrbilder kan du föredra olika nivåer för utveckling jämfört med staging- och produktionsmiljöer.

Som stöd för detta lägger Cloud Manager till standardmiljövariabler i byggbehållaren för varje körning.

Variabel tillgänglighet för standardmiljö availability

Standardmiljövariabler kan användas på flera ställen.

Skapa, förhandsgranska och publicera miljöer author-preview-publish

Både vanliga miljövariabler och hemligheter kan användas i redigerings-, förhandsgransknings- och publiceringsmiljöer.

Dispatcher dispatcher

Endast reguljära miljövariabler kan användas med Dispatcher. Hemligheter kan inte användas.

Miljövariabler kan dock inte användas i IfDefine-direktiv.

OSGi-konfigurationer osgi

Både vanliga miljövariabler och hemligheter kan användas i OSGi-konfigurationer.

Pipeline-variabler pipeline-variables

I vissa fall kan din byggprocess vara beroende av specifika konfigurationsvariabler som skulle vara olämpliga att placera i Git-databasen eller som behöver variera mellan olika pipeline-körningar som använder samma gren.

Cloud Manager tillåter att dessa variabler konfigureras via Cloud Manager API eller Cloud Manager CLI per pipeline. Variabler kan lagras som antingen oformaterad text eller krypteras i vila. I båda fallen görs variabler tillgängliga i byggmiljön som en miljövariabel, som sedan kan refereras inifrån filen pom.xml eller andra byggskript.

Om du vill ange en variabel med hjälp av CLI kör du ett kommando som liknar följande.

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

Aktuella variabler kan listas med ett kommando som liknar följande.

$ aio cloudmanager:list-pipeline-variables PIPELINEID

Variabler måste följa vissa begränsningar.

När de används i en Maven pom.xml-fil är det vanligtvis praktiskt att mappa dessa variabler till Maven-egenskaper med en syntax som liknar den nedan.

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

Installera ytterligare systempaket installing-additional-system-packages

För att vissa byggen ska fungera fullt ut krävs att ytterligare systempaket installeras. Ett bygge kan till exempel anropa ett Python- eller Ruby-skript och därför måste ha en lämplig språktolk installerad. Det här scenariot kan utföras genom att anropa exec-maven-plugin för att anropa APT. Den här exekveringen bör normalt omslutas av en Cloud Manager-specifik Maven-profil. Om du till exempel vill installera Python kan du göra följande:

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

Den här tekniken kan även användas för att installera språkspecifika paket. Det innebär att gem används för RubyGems eller pip för Python-paket.