O ambiente de criação build-environment

Saiba mais sobre o ambiente de criação especializado no qual os usuários do Cloud Manager criam e testam seus códigos.

Detalhes do ambiente details

Os ambientes de criação do Cloud Manager têm os seguintes atributos.

Repositórios Maven HTTPS https-maven

O Cloud Manager 2023.10.0 iniciou uma atualização contínua do ambiente de compilação (concluindo com a versão 2023.12.0), que incluiu uma atualização para Maven 3.8.8. Uma mudança significativa introduzida no Maven 3.8.1 foi um aprimoramento de segurança destinado a atenuar possíveis vulnerabilidades. Especificamente, o Maven agora desativa todos os http://* espelhos inseguros por padrão, conforme descrito nas notas de versão do Maven.

Como resultado desse aprimoramento de segurança, algumas pessoas podem enfrentar problemas durante a etapa de compilação, especialmente ao baixar artefatos de repositórios Maven que usam conexões HTTP inseguras.

Para garantir uma experiência perfeita com a versão atualizada, a Adobe recomenda atualizar os repositórios Maven para usar HTTPS em vez de HTTP. Esse ajuste se alinha à evolução contínua do setor em direção a protocolos de comunicação seguros e ajuda a manter um processo de compilação seguro e confiável.

Uso de uma versão específica do Java using-java-version

Por padrão, os projetos criados pelo processo de criação do Cloud Manager usam o JDK do Oracle 8. Os clientes que desejam usar um JDK alternativo têm duas opções.

Maven Toolchains maven-toolchains

O plug-in de cadeias de ferramentas Maven permite que os projetos selecionem um JDK específico (ou cadeia de ferramentas) para usar no contexto de plug-ins Maven com reconhecimento de cadeias de ferramentas. Esse processo é feito no arquivo pom.xml do projeto especificando um fornecedor e o valor da versão. Um exemplo de seção no arquivo pom.xml é o seguinte:

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

Esse processo faz com que todos os plug-ins Maven com reconhecimento de cadeias de ferramentas usem o JDK do Oracle, versão 11.

Ao usar esse método, o próprio Maven ainda é executado usando o JDK padrão (Oracle 8) e a variável de ambiente JAVA_HOME não é alterada. Portanto, a verificação ou a aplicação da versão do Java por meio de plug-ins como o Plug-in Enforcer do Apache Maven não funcionarão e esses plug-ins não deverão ser usados.

As combinações de fornecedor/versão disponíveis no momento são:

Versão alternativa do JDK de execução do Maven alternate-maven

Também é possível selecionar o Oracle 8 ou Oracle 11 como o JDK para toda a execução do Maven. Diferentemente das opções de cadeias de ferramentas, isso altera o JDK usado para todos os plug-ins, a menos que a configuração de cadeias de ferramentas também esteja definida, caso em que a configuração de cadeias de ferramentas ainda será aplicada para plug-ins Maven com reconhecimento de cadeias de ferramentas. Como resultado, verificar e impor a versão do Java usando o Plug-in executor Apache Maven funciona.

Para fazer isso, crie um arquivo chamado .cloudmanager/java-version na ramificação do repositório Git usada pelo pipeline. Esse arquivo pode ter o conteúdo 11 ou 8. Qualquer outro valor é ignorado. Se 11 for especificado, o Oracle 11 será usado e a variável de ambiente JAVA_HOME será definida como /usr/lib/jvm/jdk-11.0.22. Se 8 for especificado, o Oracle 8 será usado e a variável de ambiente JAVA_HOME será definida como /usr/lib/jvm/jdk1.8.0_401.

Variáveis de ambiente environment-variables

Variáveis de ambiente padrão standard-environ-variables

Em alguns casos, pode ser necessário variar o processo de criação com base nas informações sobre o programa ou pipeline.

Por exemplo, ao usar uma ferramenta como o gulp para minificação do JavaScript, você pode preferir níveis de minificação diferentes para ambientes de desenvolvimento em vez de ambientes de preparo e produção.

Para ser compatível com isso, o Cloud Manager adiciona variáveis de ambiente padrão ao contêiner de criação para cada execução.

Disponibilidade de variável de ambiente padrão availability

As variáveis de ambiente padrão podem ser usadas em vários lugares.

Criar, visualizar e publicar ambientes author-preview-publish

As variáveis e os segredos comuns do ambiente podem ser usados nos ambientes de criação, visualização e publicação.

Dispatcher dispatcher

Somente variáveis de ambiente regulares podem ser usadas com a Dispatcher. Segredos não podem ser usados.

No entanto, as variáveis de ambiente não podem ser usadas em diretivas IfDefine.

Configurações do OSGi osgi

As variáveis e os segredos comuns do ambiente podem ser usados nas configurações do OSGi.

Variáveis de pipeline pipeline-variables

Em alguns casos, o processo de criação pode depender de variáveis de configuração específicas que seriam inadequadas para colocar no repositório Git ou precisariam variar entre execuções de pipeline usando a mesma ramificação.

O Cloud Manager permite que essas variáveis sejam configuradas por meio da API ou da CLI do Cloud Manager com base no pipeline. As variáveis podem ser armazenadas como texto simples ou criptografadas em repouso. Em ambos os casos, as variáveis são disponibilizadas no ambiente de compilação como variáveis de ambiente, que podem ser referenciadas de dentro do arquivo pom.xml ou de outros scripts de compilação.

Para definir uma variável usando a CLI, execute um comando semelhante ao seguinte.

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

As variáveis atuais podem ser listadas usando um comando semelhante ao seguinte.

$ aio cloudmanager:list-pipeline-variables PIPELINEID

As variáveis devem atender a determinadas limitações.

Quando usado dentro de um arquivo pom.xml do Maven, geralmente é útil mapear essas variáveis para propriedades do Maven usando uma sintaxe semelhante à seguinte.

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

Instalação de pacotes de sistema adicionais installing-additional-system-packages

Para funcionar plenamente, algumas builds exigem a instalação de pacotes de sistema adicionais. Por exemplo, uma build pode invocar um script do Python ou Ruby e, como resultado, precisa ter um interpretador de linguagem adequado instalado. Este cenário pode ser feito chamando o exec-maven-plugin para invocar o APT. Essa execução geralmente deve ser encapsulada em um perfil Maven específico do Cloud Manager. Por exemplo, para instalar o Python, você pode fazer o seguinte:

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

Essa técnica também pode ser usada para instalar pacotes específicos de idioma. Isto é, usando gem para RubyGems ou pip para Pacotes Python.