Ambiente di build build-environment
Scopri l’ambiente di build specializzato che Cloud Manager usa per creare e testare il codice.
Dettagli dell’ambiente details
Gli ambienti di build di Cloud Manager hanno i seguenti attributi.
-
L’ambiente di build è basato su Linux, derivato da Ubuntu 22.04.
-
Apache Maven 3.9.4 è installato.
- Adobe consiglia agli utenti di aggiornare i loro archivi Maven per utilizzare HTTPS invece di HTTP.
-
Le versioni Java installate sono Oracle JDK 8u371 e Oracle JDK 11.0.22.
/usr/lib/jvm/jdk1.8.0_401
/usr/lib/jvm/jdk-11.0.22
-
Per impostazione predefinita, la variabile dell’ambiente
JAVA_HOME
è impostata su/usr/lib/jvm/jdk1.8.0_401
, che contiene Oracle JDK 8u401. Per ulteriori dettagli, vedi la sezione Versione JDK di esecuzione Maven alternativa. -
Sono installati anche alcuni altri pacchetti di sistema necessari.
bzip2
unzip
libpng
imagemagick
graphicsmagick
-
Altri pacchetti possono essere installati in fase di build come descritto nella sezione Installazione di pacchetti di sistema aggiuntivi.
-
Ogni build viene realizzata in un ambiente incontaminato. Il contenitore di build non mantiene alcuno stato da un’esecuzione all’altra.
-
Maven viene sempre eseguito con questi tre comandi:
mvn --batch-mode org.apache.maven.plugins:maven-dependency-plugin:3.1.2:resolve-plugins
mvn --batch-mode org.apache.maven.plugins:maven-clean-plugin:3.1.0:clean -Dmaven.clean.failOnError=false
mvn --batch-mode org.jacoco:jacoco-maven-plugin:prepare-agent package
-
Maven è configurato a livello di sistema con un file
settings.xml
che include automaticamente l’archivio degli artefatti Adobe pubblico utilizzando un profilo denominatoadobe-public
.- Per ulteriori dettagli, consulta l’archivio Maven pubblico di Adobe.
-
Node.js 18 è disponibile per pipeline front-end.
jacoco-maven-plugin
, la versione utilizzata deve essere almeno 0.7.5.201505241946
.Archivi Maven HTTPS https-maven
Cloud Manager versione 2023.10.0 ha iniziato un aggiornamento continuo dell’ambiente di build (completandolo con la versione 2023.12.0), che includeva un aggiornamento a Maven 3.8.8. Come modifica significativa introdotta in Maven 3.8.1 è stato apportato un miglioramento della sicurezza volto a mitigare potenziali vulnerabilità. In particolare, Maven ora disabilita tutti le corrispondenze http://*
non sicure per impostazione predefinita, come descritto nelle note sulla versione di Maven.
Come risultato di questo miglioramento sulla sicurezza, alcuni utenti potrebbero riscontrare problemi durante la fase di build, in particolare durante il download di artefatti dagli archivi Maven che utilizzano connessioni HTTP non sicure.
Per garantire un’esperienza fluida con la versione aggiornata, Adobe consiglia agli utenti di aggiornare gli archivi Maven per utilizzare HTTPS invece di HTTP. Questo adeguamento è in linea con la crescente tendenza del settore verso protocolli di comunicazione sicuri e contribuisce a mantenere un processo di creazione sicuro e affidabile.
Utilizzo di una versione Java specifica using-java-version
Per impostazione predefinita, i progetti sono generati dal processo di build di Cloud Manager utilizzando il JDK di Oracle 8. I clienti che desiderano utilizzare un JDK alternativo hanno due opzioni.
Toolchain Maven maven-toolchains
Il plug-in Toolchains di Maven consente ai progetti di selezionare un JDK specifico (o toolchain) da utilizzare nel contesto di plug-in Maven che tengono conto delle toolchain. Ciò viene effettuato nel file pom.xml
del progetto specificando un valore di fornitore e di versione. Esempio di sezione nel file pom.xml
:
<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>
In questo esempio, tutti i plug-in Maven che tengono conto delle toolchain utilizzeranno Oracle JDK versione 11.
Quando si utilizza questo metodo, Maven stesso viene comunque eseguito utilizzando il JDK predefinito (Oracle 8) e la variabile di ambiente JAVA_HOME
non viene modificata. Pertanto, non è possibile controllare o applicare la versione Java tramite plug-in come Apache Maven Enforcer e tali plug-in non devono essere utilizzati.
Le combinazioni fornitore/versione attualmente disponibili sono:
Versione JDK alternativa per l’esecuzione di Maven alternate-maven
È inoltre possibile selezionare Oracle 8 o Oracle 11 come JDK per l’intera esecuzione di Maven. A differenza delle opzioni toolchain, questo cambia il JDK utilizzato per tutti i plug-in a meno che non sia impostata anche la configurazione di toolchain, nel qual caso la configurazione di toolchain viene ancora applicata per i plug-in Maven che tengono conto delle toolchain. Di conseguenza, controllare e applicare la versione Java con il plug-in Apache Maven Enforcer funzionerà.
A questo scopo, crea un file denominato .cloudmanager/java-version
nel ramo dell’archivio Git utilizzato dalla pipeline. Questo file può avere come contenuto 11
o 8
. Qualsiasi altro valore viene ignorato. Se 11
è specificato, viene utilizzato Oracle 11 e la variabile di ambiente JAVA_HOME
è impostata su /usr/lib/jvm/jdk-11.0.22
. Se è specificato 8
, viene utilizzato Oracle 8 e la variabile di ambiente JAVA_HOME
è impostata su /usr/lib/jvm/jdk1.8.0_401
.
Variabili di ambiente environment-variables
Variabili di ambiente standard standard-environ-variables
In alcuni casi, potrebbe essere necessario variare il processo di creazione in base alle informazioni relative al programma o alla pipeline.
Per esempio, se la minimizzazione di JavaScript nel tempo di creazione viene eseguita tramite uno strumento come “gulp”, potrebbe essere auspicabile utilizzare un livello di minimizzazione diverso durante la creazione di un ambiente di sviluppo rispetto alla creazione di staging e produzione.
Per supportare questa funzione, Cloud Manager aggiunge al contenitore di creazione le variabili di ambiente standard per ogni esecuzione.
CM_BUILD
true
BRANCH
CM_PIPELINE_ID
CM_PIPELINE_NAME
CM_PROGRAM_ID
CM_PROGRAM_NAME
ARTIFACTS_VERSION
Disponibilità di variabili di ambiente standard availability
Le variabili di ambiente standard possono essere utilizzate in diverse posizioni.
Authoring, Anteprima e Pubblicazione author-preview-publish
Negli ambienti di authoring, anteprima e pubblicazione è possibile utilizzare sia le normali variabili di ambiente che i segreti.
Dispatcher dispatcher
Solo le variabili di ambiente normali possono essere utilizzate dal Dispatcher. I segreti non possono essere utilizzati.
Tuttavia, le variabili di ambiente non possono essere utilizzate nelle direttive IfDefine
.
Configurazioni OSGi osgi
Le normali variabili di ambiente e i segreti possono essere utilizzati nelle configurazioni OSGi.
Variabili delle pipeline pipeline-variables
In alcuni casi, il processo di creazione può dipendere da specifiche variabili di configurazione che non sarebbero appropriate per l’inserimento nell’archivio Git o dovrebbero variare tra le esecuzioni della pipeline che utilizzano lo stesso ramo.
Cloud Manager consente di configurare queste variabili tramite l’API o il CLI di Cloud Manager in base alla pipeline. Le variabili possono essere archiviate come testo normale o crittografate quando inattive. In entrambi i casi, le variabili sono rese disponibili all’interno dell’ambiente di build come variabile di ambiente a cui è possibile fare riferimento dall’interno del file pom.xml
o altri script di build.
Per impostare una variabile utilizzando CLI, eseguire un comando simile al seguente.
$ aio cloudmanager:set-pipeline-variables PIPELINEID --variable MY_CUSTOM_VARIABLE test
Le variabili attuali possono essere elencate utilizzando un comando simile al seguente.
$ aio cloudmanager:list-pipeline-variables PIPELINEID
Le variabili devono rispettare determinate limitazioni.
- I nomi delle variabili possono contenere solo caratteri alfanumerici e il carattere di sottolineatura (
_
).- Per convenzione, i nomi devono essere tutti maiuscoli.
- Esiste un limite di 200 variabili per pipeline.
- Ogni nome deve contenere meno di 100 caratteri.
- Ogni valore di stringa deve contenere meno di 2048 caratteri.
- Ogni valore secretString deve contenere meno di 500 caratteri.
Quando viene utilizzato all’interno di un file Maven pom.xml
, generalmente è utile mappare queste variabili alle proprietà Maven utilizzando una sintassi simile alla seguente.
<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>
Installazione di pacchetti di sistema aggiuntivi installing-additional-system-packages
Per funzionare completamente, alcune build richiedono l'installazione di pacchetti di sistema aggiuntivi. Ad esempio, una build può richiamare uno script Python o Ruby e, di conseguenza, deve disporre di un interprete del linguaggio appropriato installato. Questa operazione può essere eseguita chiamando exec-maven-plugin
per richiamare l’APT. Generalmente questa esecuzione deve essere racchiusa in un profilo Maven specifico per Cloud Manager. Per esempio, per installare 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>
Questa stessa tecnica può essere utilizzata per installare pacchetti specifici per linguaggio, ovvero utilizzando gem
per pacchetti RubyGems o pip
per pacchetti Python.