Biblioteca variável CI/CD

Você pode usar bibliotecas de variáveis do Microsoft Fabric para gerenciar configurações entre estágios do pipeline de lançamento e salvar 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.

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 você implanta ou confirma uma biblioteca variável pela primeira vez, o conjunto ativo da biblioteca tem o valor padrão. Você pode alterar esse valor acessando a biblioteca de variáveis recém-criada no estágio ou repositório de destino e alterando o conjunto ativo.

  

• 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 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 das variáveis
• Ordem das variáveis

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

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.

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

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 obter mais informações sobre o arquivo de conjunto de valores, consulte o exemplo de 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 o exemplosettings.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 de tamanho

• 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

• Formato do código-fonte de integração Git