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 atributos a seguir.

Repositórios Maven HTTPS https-maven

O Cloud Manager 2023.10.0 iniciou uma atualização contínua do ambiente de compilação (que terminou com a versão 2023.12.0), a qual incluiu a atualização para o Maven 3.8.8. Uma mudança significativa introduzida no Maven 3.8.1 foi um aprimoramento de segurança destinado a reduzir possíveis vulnerabilidades. Mais especificamente, o Maven agora desabilita por padrão todos os espelhos inseguros de http://*, 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 são criados pelo processo de compilação do Cloud Manager usando o Oracle 8 JDK. Os clientes que desejam usar um JDK alternativo têm duas opções.

Maven Toolchains maven-toolchains

O plug-in Maven Toolchains permite que os projetos selecionem um JDK específico (ou conjunto de ferramentas) a ser usado no contexto de plug-ins do Maven com reconhecimento de conjuntos de ferramentas. Isso é feito por especificar um fornecedor e o número da versão no arquivo pom.xml do projeto. Veja um exemplo de seção do arquivo 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>

Isso fará com que todos os plug-ins do Maven com reconhecimento de conjuntos de ferramentas usem o Oracle JDK, 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, verificar ou impor a versão do Java por meio de plug-ins como o Apache Maven Enforcer não terá resultado, e, portanto, estes não devem 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 conjuntos de ferramentas, essa definição altera o JDK usado em todos os plug-ins, a menos que a configuração de conjuntos de ferramentas também esteja definida; neste caso, essa configuração ainda será aplicada aos plug-ins Maven com reconhecimento de conjuntos de ferramentas. Como resultado, a verificação e a implementação da versão do Java usando o plug-in Apache Maven Enforcer será bem-sucedida.

Para 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 minimização do JavaScript, você pode preferir níveis de minimização diferentes para ambientes de desenvolvimento em comparação a 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 da variável de ambiente padrão availability

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

Ambientes de criação, visualização e publicação 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 normais podem ser usadas com o Dispatcher. Não é possível usar segredos.

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 no arquivo pom.xml ou em outros scripts de criaçã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 usadas 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, precisar de um interpretador de linguagem adequado instalado. Para isso, é possível chamar 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, faça 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 de idioma específicos. Isto é, usando gem para RubyGems ou pip para pacotes Python.