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 release 2023.10.0 påbörjade en rullande uppdatering av byggmiljön (som i 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 byggs projekt av Cloud Manager byggprocess med Oracle 8 JDK. 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 viss JDK (eller verktygskedja) som ska användas i kontexten för verktygsmaskmedvetna Maven-plugin-program. Detta görs i projektets pom.xml-fil genom att ange en leverantör och ett versionsvärde. Ett exempelavsnitt i filen pom.xml är:

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

Detta 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 inte och sådana plugin-program får inte användas.

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

Alternate Maven Execution JDK Version 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å anges. I så fall tillämpas fortfarande konfigurationen för verktygskedjor för Maven-plugin-program som är medvetna om verktygskedjor. Det innebär att kontroll och genomförande av Java-versionen med Apache Maven Enforcer-pluginen fungerar.

Det gör du genom att skapa 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 t.ex. JavaScript-minifiering under byggfasen utförs med ett verktyg som Glup, kan det finnas en önskan om att använda en annan miniminivå när du skapar för en utvecklingsmiljö i stället för att bygga för staging och produktion.

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.

Författare, Förhandsgranska och Publish 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 dispatchern. 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.

Rörledningsvariabler 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. Detta kan gö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. Så här installerar du 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>

Samma teknik kan användas för att installera språkspecifika paket, dvs. med gem för RubyGems eller pip för Python-paket.