CI/CD da biblioteca de variáveis

Use bibliotecas variáveis no Fabric para gerenciar configurações entre as etapas do pipeline de lançamento e para salvar valores no Git. Este artigo explica como usar bibliotecas variáveis no contexto de gerenciamento do ciclo de vida e integração contínua e entrega contínua (CI/CD).

Bibliotecas variáveis e pipelines de implantação

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

Captura de tela de um pipeline de implantação.

Lembre-se destas informações importantes:

  • 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 conjunto de valores ativos para cada estágio é selecionado de forma independente. Você pode alterá-lo a qualquer momento.

  • Quando uma biblioteca de variáveis é implantada em uma etapa vazia, a implantaçã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 workspace de destino, defina o conjunto de valores necessário como ativo e salve a biblioteca de variáveis antes de executar itens dependentes ou ações do plano de implantação.

    Captura de tela do comando para alterar um conjunto de valores ativos do padrão para um valor alternativo definido 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 consumo em seu workspace (por exemplo, um pipeline) recebe automaticamente o valor correto do conjunto ativo de valores.

As seguintes operações para variáveis ou conjuntos de valores em um estágio de um pipeline de implantação fazem com que a biblioteca de variáveis seja refletida como fonte de formulário diferenteem comparação com o mesmo item em um estágio diferente:

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

Captura de tela das pipelines de implantação comparadas, com a biblioteca de variáveis aparecendo como diferente nos dois estágios.

Uma alteração simples 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 ele não aparece na comparação do pipeline de implantação e não é substituído a cada implantação.

Use valores de biblioteca variável em um plano de implantação

Uma ação de plano de implantação pode usar uma referência de biblioteca variável em vez de um valor literal de parâmetro. Quando a implantação é executada, o Fabric resolve a referência usando o conjunto de valores ativos da biblioteca Variable no workspace de destino. Isso permite que a mesma ação use valores específicos para cada estágio de implantação.

Antes de implantar, certifique-se de que o workspace de destino contenha a biblioteca e variável de variáveis referenciadas, e que o conjunto de valores correto esteja ativo. A implantação não altera o conjunto de valores ativos. Se a implantação criar o espaço de trabalho de destino, Default permanecerá ativo até que você selecione e salve outro conjunto de valores.

Para uma ação de planejamento de implantação, você 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, ele informa qual parte da referência falhou. Para a sequência de resolução e as correções, consulte Falhas na resolução de referências de variáveis.

Bibliotecas de variáveis e integração do Git

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

As permissões dos itens são verificadas durante o update e o commit do Git.

A seleção ativa do conjunto de valores é o estado do workspace e não é armazenada no Git. Quando a sincronização inicial importa uma biblioteca de variáveis para um novo espaço de trabalho, o Padrão 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 salve a biblioteca de variáveis antes de executar itens dependentes ou ações do plano de implantação.

O esquema do item de biblioteca de variáveis é um objeto JSON que contém quatro partes:

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

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

Conjuntos de valores

A pasta de biblioteca de variáveis 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ável para valores não padrão nesse conjunto de valores.

Para obter mais informações sobre o arquivo de conjunto de valores, consulte os 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 obter mais informações, consulte variáveis e o exemplo desettings.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 exemplo devariables.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 é menor que 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 observação 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

  • Conjuntos de valores alternativos em uma biblioteca de variáveis aparecem na ordem em que você os adicionou. Atualmente, você não pode 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 em uma biblioteca de variáveis.
  • Os nomes de variáveis devem ser exclusivos em uma biblioteca de variáveis. Você pode ter duas variáveis com o mesmo nome em um workspace se elas estiverem em itens diferentes.
  • Há sempre um (e apenas um) valor ativo definido em uma biblioteca de variáveis 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

  • Última atualização em