Variáveis
Visão Geral
Durante a construção de fluxos de integração, podem surgir situações onde determinadas configurações tem valores distintos entre ambientes. Essas configurações, muitas vezes não relacionadas a regras de negócio, precisam ter um comportamento dinâmico para que um mesmo fluxo seja instalado em vários ambientes sem alteração de sua lógica.
Para atender a essa necessidade, o DHuO possui o conceito de variáveis. Variáveis são configurações que possuem valores dinâmicos conforme o ambiente onde a integração será implantada. As variáveis podem ser utilizadas para configurações como endereço de servidores, configurações de banco de dados, configurações de timeout, entre outros. Além desse comportamento dinâmico por ambiente, as variáveis podem ser reaproveitadas e utilizadas em diferentes fluxos de integração, possuindo ainda mais versatilidade no seu uso. Para saber mais sobre o uso de variáveis na criação de integrações, acesse a seção Motor de integrações de integrações.
Após criar uma variável, ela está disponível para uso em dois locais:
- nos formulários de configuração de componentes, durante a criação da integração no canvas, utilizando a sintaxe
{{var.nome_da_variavel}} - no momento da implantação de uma integração, para configuração de variáveis de ambiente
Após a implantação da integração, todas as variáveis associadas a ela serão disponibilizadas como variáveis de ambiente para o serviço no cluster.
As informações das variáveis só são utilizadas de fato no momento da implantação de integrações. Se uma ou mais integrações utilizam uma variável cujo valor foi alterado, será necessário atualizar a implantação correspondente a cada uma delas para o novo valor ser replicado para os respectivos ambientes/clusters.
No entanto, não é necessário criar uma nova release da integração caso apenas valores de variáveis tenham sido alterados. É necessário apenas a atualização da implantação. Para saber mais, acesse a seção Implantação (Deploy) de integrações.
Configuração
As variáveis são gerenciadas no contexto da Organização. A partir da home, acesse o ícone de configurações da Organização ⚙ menu > Variáveis. Na página de variáveis, elas podem ser cadastradas, editadas e excluídas.
Permissões
Apenas usuários com papel de administrador da organização (Org Admin) podem gerenciar variáveis. Para saber mais, acesse a seção Papéis e permissões.
Parâmetros
Aqui estão os parâmetros gerais para a configuração de uma variável:
- Nome: Obrigatório. Nome da variável.
As variáveis são únicas por Organização. Não é possível ter mais de uma variável com o mesmo nome.
O nome de uma variável não pode conter espaços, não deve iniciar com número e pode conter apenas letras sem acentos, números e o caractere _.
- Descrição: Texto opcional para detalhes sobre a variável.
Configurações por ambiente
Para cada ambiente onde a variável será utilizada, é necessário configurar:
- Cluster: Obrigatório. Cluster que receberá o valor específico da variável durante a implantação de integrações que a utilizem. Para saber mais sobre clusters, acesse a seção Clusters da Administração do iPaaS.
- Valor: Obrigatório. Valor da variável a ser utilizada ao implantar integrações no cluster relacionado.
Não é possível implantar uma integração que utiliza variáveis sem que elas tenham valores declarados para o cluster onde ela será implantada.
Não é possível excluir uma variável caso ela esteja associada na configuração de variáveis de ambiente da implantação de uma integração. É necessário removê-la da configuração de variáveis de ambiente das integrações para excluir.
Ao contrário da associação de variáveis na configuração de variáveis de ambiente da implantação de uma integração, é possível excluir uma variável mesmo que ela esteja em uso apenas nas configurações do canvas da integração.
Neste cenário, a variável será excluída, porém, não será possível implantar uma release da integração caso ela contenha a variável referenciada em algum componente no canvas.
Caso deseje implantar releases existentes com essa referência à variável, será necessário recriar e configurar novamente a variável excluída. Caso contrário, será necessário excluir a referência da variável nos componentes do canvas e gerar uma nova release para implantação.