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
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 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
stringdeve ter menos de 2048 caracteres. - Cada valor de tipo de variável
secretStringdeve ter 500 caracteres ou menos.
Pela interface do usuário do Cloud Manager ui
As variáveis de pipeline podem ser configuradas e gerenciadas por meio da interface 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
-
Ao 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.
-
A janela Configuração de variáveis é aberta. Insira os detalhes da variável na primeira linha da tabela e toque ou clique em Adicionar.
-
O Nome da Configuração é um identificador exclusivo para sua variável, que deve chefiar 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.
- Compilação
- Teste funcional
- Testes de interface
-
Type define se a variável é texto simples ou criptografada como um segredo.
-
-
O é adicionado à tabela. Adicione mais variáveis conforme necessário e toque ou clique em Salvar para salvar as variáveis adicionadas ao pipeline.
Edição de variáveis de pipeline edit-ui
-
Ao 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.
-
A janela Configuração de variáveis é aberta. Toque ou clique no botão de reticências da variável que deseja editar e selecione Editar.
-
Atualize o valor da variável conforme necessário e toque ou clique em Aplicar (a marca de seleção no final da linha) para aplicar a alteração ou em Descartar (a seta para trás) para reverter a alteração.
- Somente o valor da variável pode ser editado.
-
Toque ou clique em 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 na janela Configuração de variáveis.
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>