Biblioteca variável CI/CD

Use bibliotecas variáveis no Fabric para gerir configurações em várias fases do pipeline de lançamento e para guardar valores no Git. Este artigo explica como usar bibliotecas de variáveis no contexto do gerenciamento do ciclo de vida e da integração contínua e entrega contínua (CI/CD).

Bibliotecas de variáveis e pipelines de implementação

Você pode implantar bibliotecas de variáveis e seus valores em pipelines de implantação para gerenciar valores de variáveis entre estágios.

Captura de ecrã de um pipeline de implementação.

Lembre-se desta informação importante:

  • Todos os conjuntos de valores na biblioteca de variáveis estão disponíveis para todos os estágios do pipeline de implantação, mas apenas um conjunto está ativo em um estágio.

  • O valor ativo definido para cada estágio é selecionado independentemente. Você pode alterá-lo a qualquer momento.

  • Quando uma biblioteca de variáveis é implementada numa fase vazia, a implementação cria um espaço de trabalho onde o conjunto de valores padrão está ativo. Se o ambiente de destino exigir outro conjunto de valores, abra a biblioteca de variáveis no espaço de trabalho de destino, defina o conjunto de valores necessário como ativo e guarde a biblioteca de variáveis antes de executar itens dependentes ou ações do plano de implementação.

    Captura de tela do comando para alterar um conjunto de valores ativos do padrão para um conjunto de valores alternativos em um pipeline de implantação.

  • Embora as implantações não afetem o conjunto de valores ativos selecionado em cada estágio, você pode atualizar os próprios valores na biblioteca de variáveis. O item de consumidor em seu espaço de trabalho (por exemplo, um pipeline) recebe automaticamente o valor correto do conjunto de valores ativo.

As operações seguintes sobre variáveis ou conjuntos de valores numa fase de um pipeline de implementação fazem com que a biblioteca de variáveis seja apresentada como Origem de formulário diferentecomparativamente ao mesmo item numa fase diferente:

  • Variáveis adicionadas, excluídas ou editadas
  • Conjuntos de valores adicionados ou excluídos
  • Nomes das variáveis
  • Ordem das variáveis

Captura de ecrã de pipelines de implementação comparados entre si, com a biblioteca de variáveis a aparecer como diferente nas duas fases.

Uma simples alteração no conjunto de valores ativos não se registra como fonte de formulário diferente quando você compara. O conjunto de valores ativos faz parte da configuração do item, mas não está incluído na definição. É por isso que não aparece na comparação do pipeline de implementação e não é substituído em cada implementação.

Use valores de biblioteca variável num plano de implementação

Uma ação de plano de implementação pode usar uma referência de biblioteca de variáveis em vez de um valor literal de parâmetro. Quando a implementação é executada, o Fabric resolve a referência utilizando o conjunto de valores ativos da biblioteca Variable no workspace de destino. Isto permite que a mesma ação utilize valores específicos para cada etapa de implementação.

Antes de implementar, certifique-se de que o espaço de trabalho de destino contém a biblioteca e variável de variáveis referenciadas, e que o conjunto de valores correto está ativo. A implementação não altera o conjunto de valores ativos. Se a implementação criar o espaço de trabalho de destino, Default permanece ativo até selecionar e guardar outro conjunto de valores.

Para uma ação de plano de implantação, pode usar uma referência variável como valor de um parâmetro. Para mais informações, veja Passar parâmetros para uma ação.

Se o Fabric não conseguir resolver uma referência, reporta qual parte da referência falhou. Para a sequência de resolução e correções, veja Falhas de resolução de referência variável.

Bibliotecas variáveis e integração com Git

Como outros itens de malha, as bibliotecas variáveis podem ser integradas ao Git para controle do código-fonte. Os itens de biblioteca variável são armazenados como pastas que você pode manter e sincronizar entre o Fabric e seu provedor Git.

As permissões de item são verificadas durante a atualização e confirmação do Git.

A seleção ativa do conjunto de valores é o estado do workspace e não está armazenada no Git. Quando a sincronização inicial importa uma biblioteca de variáveis para um novo espaço de trabalho, o Default está ativo. Se o ambiente de destino exigir outro conjunto de valores, abra a biblioteca de variáveis importadas no novo espaço de trabalho, defina o conjunto de valores necessário como ativo e guarde a biblioteca de variáveis antes de executar itens dependentes ou ações do plano de implementação.

O esquema para o item de biblioteca variável é um objeto JSON que contém quatro partes:

  • Pasta para conjuntos de valores
  • Configurações
  • Platform.json, um ficheiro gerado automaticamente
  • Variáveis

Captura de tela de uma pasta Git com arquivos de biblioteca variáveis nele.

Conjuntos de valores

A pasta da biblioteca variável contém uma subpasta chamada valueSets. Esta pasta contém um arquivo JSON para cada conjunto de valores. Esse arquivo JSON contém apenas os valores de variáveis para valores não padrão nesse conjunto de valores.

Para mais informações sobre o ficheiro do conjunto de valores, consulte conjuntos de valores e o exemplo do conjunto de valores.

Os valores para variáveis que não estão neste arquivo são retirados do conjunto de valores padrão.

Configurações

O settings.json arquivo contém configurações para a biblioteca de variáveis.

Para mais informações, consulte variáveis e o exemplo de settings.json.

Variáveis

O variables.json arquivo contém os nomes das variáveis e seus valores padrão.

Para obter mais informações, consulte o exemplovariables.json.

Considerações e limitações

Limitações para variáveis

  • Pode haver até 1.000 variáveis e até 1.000 conjuntos de valores, desde que você atenda a ambos os requisitos:

    • O número total de células nos conjuntos de valores alternativos é inferior a 10.000.
    • O tamanho do item não excede 1 MB.

    Esses requisitos são validados quando você salva as alterações.

  • O campo de notas pode ter até 2.048 caracteres.

  • O campo de descrição do conjunto de valores pode ter até 2.048 caracteres.

Limitações para conjuntos de valores alternativos

  • Os conjuntos de valores alternativos em uma biblioteca de variáveis aparecem na ordem em que foram adicionados. Atualmente, não é possível reordená-los na interface do usuário. Para alterar a ordem, edite o arquivo JSON diretamente.
  • O nome de cada conjunto de valores deve ser exclusivo dentro de uma biblioteca de variáveis.
  • Os nomes das variáveis devem ser exclusivos dentro de uma biblioteca de variáveis. Você pode ter duas variáveis com o mesmo nome em um espaço de trabalho se elas estiverem em itens diferentes.
  • Há sempre um (e apenas um) valor ativo definido em uma biblioteca variável de cada vez. Não é possível excluir um conjunto de valores enquanto ele estiver ativo. Para excluí-lo, primeiro configure outro conjunto de valores para estar ativo. Você pode ter um valor ativo diferente definido para cada estágio de um pipeline de implantação.

Conteúdo relacionado

  • Last updated on