Configuração de variáveis de pipeline configuring-pipeline-variables

Seu processo de compilação pode depender de variáveis de configuração específicas que seriam inadequadas para colocar no repositório Git, ou você pode precisar variá-las entre as execuções de pipeline que usam a mesma ramificação. O Cloud Manager permite gerenciar esses dados como variáveis de pipeline.

Variáveis de pipeline pipeline-variables

Usando 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 compilação.

Convenções de nomenclatura de variáveis de pipeline naming-conventions

Os nomes das variáveis devem observar as convenções a seguir.

  • As variáveis podem conter somente 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.
  • Each secretString o valor da variável de tipo deve ter 500 caracteres ou menos.

Pela interface do Cloud Manager ui

As variáveis de pipeline podem ser configuradas e gerenciadas por meio da interface do usuário do Cloud Manager. Você deve ter permissões para editar o pipeline a fim de adicionar, editar e excluir variáveis de pipeline.

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

Adição de variáveis de pipeline add-ui

  1. Quando gerenciar seus pipelines, toque ou clique no botão de reticências do pipeline para o qual deseja criar variáveis de pipeline e selecione Exibir/editar variáveis no menu de contexto.

    Exibir/editar variáveis de pipeline

  2. A variável Configuração de variáveis é aberta. Insira os detalhes da variável na primeira linha da tabela e toque ou clique Adicionar.

    • Nome da configuração é um identificador exclusivo para a variável, que deve convenções de nomenclatura de variáveis de pipeline.

    • Valor é o valor que a variável contém.

    • Etapa aplicada é a etapa no pipeline à qual a variável se aplica. É obrigatório.

      • Build
      • Teste funcional
      • Teste da interface do usuário
    • Tipo define se a variável é texto simples ou criptografada como um segredo.

    Adicionar variável

  3. O é adicionado à tabela. Adicione variáveis adicionais conforme necessário e toque ou clique Salvar para salvar as variáveis adicionadas ao pipeline.

Edição de variáveis de pipeline edit-ui

  1. Quando gerenciar seus pipelines, toque ou clique no botão de reticências do pipeline para o qual deseja criar variáveis de pipeline e selecione Exibir/editar variáveis no menu de contexto.

    Exibir/editar variáveis de pipeline

  2. A variável Configuração de variáveis é aberta. Toque ou clique no botão de reticências da variável que deseja editar e selecione Editar.

    Editar variável

  3. Atualize o valor da variável conforme necessário e toque ou clique Aplicar (a marca de seleção no final da linha) para aplicar a alteração ou Descartar (a seta para trás) para reverter a alteração.

    • Somente o valor da variável pode ser editado.

    Edição de uma variável

  4. Toque ou clique Salvar para salvar as alterações feitas nas variáveis no pipeline.

Se desejar excluir uma variável, selecione Excluir em vez de Editar no menu de reticências da variável de pipeline no Configuração de variáveis janela.

Uso da CLI do Cloud Manager cli

Esse comando da CLI 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 pom.xml do Maven, normalmente é útil mapear essas variáveis às propriedades do Maven usando uma sintaxe semelhante a esta.

        <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