Variáveis de pipeline no Cloud Manager configuring-pipeline-variables

Seu processo de build pode depender de variáveis de configuração específicas que não devem ser armazenadas no repositório Git. Ou talvez seja necessário ajustá-los entre execuções de pipeline na mesma ramificação. O Cloud Manager permite gerenciar essas configurações como variáveis de pipeline.

Sobre variáveis de pipeline pipeline-variables

Com o Cloud Manager, você pode configurar variáveis de pipeline de várias maneiras diferentes.

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.

Adicionar uma variável de pipeline por meio do Cloud Manager ui

As variáveis de pipeline podem ser configuradas e gerenciadas pela interface do usuário do Cloud Manager. Eles ajudam a simplificar o gerenciamento de pipeline, especialmente quando configurações variáveis são necessárias em diferentes etapas.

Você deve ter permissões para editar o pipeline para adicionar, editar e excluir variáveis de pipeline.

Se um pipeline estiver em execução, o gerenciamento de variáveis será bloqueado.

Para adicionar uma variável de pipeline por meio do Cloud Manager:

  1. Ao gerenciar seus pipelines, clique em Reticências - Mais ícone do pipeline para o qual você deseja criar variáveis de pipeline.

  2. No menu suspenso, clique em Exibir/Editar variáveis.

    Exibir/Editar variáveis de pipeline

  3. Na caixa de diálogo Configuração de Variáveis, insira os detalhes na primeira linha da tabela.

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    Texto Descrição
    Nome

    Um nome exclusivo da variável de configuração. Ela identifica a variável específica usada no pipeline. Ele deve seguir as seguintes convenções de nomenclatura:

    • As variáveis só podem conter caracteres alfanuméricos e sublinhado (_).
    • Os nomes devem estar em maiúsculas.
    • Há um limite de 200 variáveis por pipeline.
    • Cada nome deve ter 100 caracteres ou menos.
    • Cada valor de variável string deve ter menos de 2048 caracteres.
    • Cada valor de tipo de variável secretString deve ter 500 caracteres ou menos.
    Valor O valor que a variável contém.
    Etapa aplicada

    Obrigatório. A etapa no pipeline à qual a variável se aplica:

    • Compilação - A variável é aplicada durante o processo de compilação.
    • Teste funcional - A variável é usada durante a etapa de teste funcional.
    • Teste de interface - A variável é usada durante a fase de teste de interface.
    Tipo Selecione se a variável for texto sem formatação ou criptografada como segredo.

    Adicionar variável

  4. Clique em Adicionar.

    Adicione mais variáveis, conforme necessário.

  5. Clique em Salvar.

Editar uma variável de pipeline edit-ui

  1. Ao gerenciar seus pipelines, clique em Reticências - Mais ícone do pipeline para o qual você deseja editar variáveis de pipeline.

  2. No menu suspenso, clique em Exibir/Editar variáveis.

    Exibir/Editar variáveis de pipeline

  3. Na caixa de diálogo Configuração de Variáveis, clique em Reticências - Mais ícone da variável que você deseja alterar.

  4. No menu suspenso, clique em Editar.

    Editar variável

  5. Atualize o valor da variável conforme necessário.

    Somente o valor da variável pode ser alterado.

  6. Siga uma das seguintes opções:

    • Clique em Aplicar - Ícone de marca de seleção para aplicar a alteração.
    • Clique no ícone Desfazer para reverter a alteração.
  7. Clique em Salvar.

Excluir uma variável de pipeline delete-ui

  1. Ao gerenciar seus pipelines, clique em Reticências - Mais ícone do pipeline para o qual você deseja excluir variáveis de pipeline.

  2. No menu suspenso, clique em Exibir/Editar variáveis.

    Exibir/Editar variáveis de pipeline

  3. Na caixa de diálogo Configuração de Variáveis, clique em Reticências - Mais ícones da variável que você deseja remover e em Excluir.

Definir variáveis de pipeline usando a CLI do Cloud Manager cli

Esse comando na CLI (Command Line Interface, interface de linha de comando) define uma variável.

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

Esse comando lista variáveis.

$ aio cloudmanager:list-pipeline-variables PIPELINEID

Quando usado em um arquivo Maven pom.xml, geralmente é útil vincular essas variáveis às propriedades Maven usando uma sintaxe semelhante ao seguinte exemplo:

        <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>
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab