> For the complete documentation index, see [llms.txt](https://docs.digibee.com/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digibee.com/documentation/developer-guide/pt-br/development-cycle/build-overview/globals.md).
# Globals
Saiba mais sobre globals e como elas são usadas para armazenar variáveis na Digibee Integration Platform.
## **Visão geral**
Globals são variáveis armazenadas na plataforma que podem ser reutilizadas em vários [pipelines](/documentation/developer-guide/pt-br/development-cycle/build-overview/pipelines.md) e [cápsulas](/documentation/developer-guide/pt-br/development-cycle/build-overview/capsulas.md). Depois de criada, uma global pode ser referenciada em qualquer campo de texto do formulário de configuração de um conector.
Como o valor fica definido em um único lugar, atualizar uma global aplica a mudança em todos os pontos onde ela é usada. As globals também podem ser restritas a projetos específicos, para que cada variável fique disponível apenas onde é necessária.
## **Gerenciando globals**
Você pode acessar a página Globals pela página de Build, clicando na aba **Globals**, ou clicando no logo da Digibee no canto superior esquerdo, selecionando **Configurações** e acessando a página **Globals**.
A lista de globals mostra o **Nome da Global**, a **Categoria**, a **Descrição** e os **Pipelines em Execução** de cada global. Você pode filtrar a lista por **Categoria** e pelo status **Descontinuada** (**Sim** ou **Não**).
### **Criando uma global**
Na página Globals, clique em **Criar novo** e preencha os campos:
| Campo | Descrição |
| ---------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nome da global** | Nome usado para referenciar a global em pipelines e cápsulas. Use apenas letras minúsculas, números, hífens (`-`) ou pontos (`.`), com até 60 caracteres e sem acentos. |
| **Categoria** | Define como o valor é validado. Veja as categorias disponíveis abaixo. |
| **Descrição** | Uma breve explicação sobre a finalidade da global. |
| **Disponibilidade do Projeto** | Define se a global fica disponível para todos os projetos ou apenas para os selecionados. Na página de listagem de globals, você vê apenas as globals disponíveis para todos os projetos ou para os projetos aos quais tem acesso. |
| **Ambiente Prod / Ambiente Test / Outros ambientes** | O valor da global em cada ambiente, com até 10.000 caracteres por campo. |
A categoria selecionada determina quais valores a global aceita. Antes de salvar, a plataforma valida o valor de cada ambiente de acordo com a categoria:
| Categoria | Valor aceito |
| --------- | ------------------------------------------- |
| **URL** | Uma URL válida. |
| **Email** | Um endereço de e-mail válido. |
| **ID** | Apenas números. |
| **Cron** | Uma expressão cron válida. |
| **JDBC** | Uma string de conexão válida. |
| **Other** | Qualquer valor. Use esta opção para listas. |
{% hint style="warning" %}
#### **Globals podem ser removidas permanentemente dos pipelines**
Uma global é removida do pipeline quando deixa de estar disponível no projeto dele. Isso acontece quando o projeto do pipeline perde acesso à global, seja porque o pipeline foi movido para outro projeto ou porque o projeto foi removido da configuração **Disponibilidade do Projeto** da global.
Depois da remoção, mover o pipeline de volta ou permitir o projeto novamente **não restaura a global**, por motivos de segurança. Nesse caso, é preciso adicionar a global ao pipeline manualmente.
{% endhint %}
Em seguida, clique em **Salvar**. Uma janela de confirmação aparece e você deve clicar em **Criar** para criar a global.
{% hint style="danger" %}
Globals não são criptografadas e ficam visíveis para todos os usuários com acesso a elas. Não armazene dados sensíveis em globals. Se precisar de criptografia, use [Contas](/documentation/developer-guide/pt-br/development-cycle/build-overview/accounts.md).
{% endhint %}
### **Editando uma global**
Para editar uma global, acesse a lista de globals e clique na linha da global que deseja editar.
Você pode:
* Atualizar a categoria.
* Atualizar a descrição.
* Marcar a global como descontinuada. Saiba mais sobre como descontinuar uma global.
* Definir novas regras de **Disponibilidade do Projeto**.
* Atualizar os valores dos ambientes.
* Visualizar todos os pipelines que usam a global.
Depois de editar a global, clique em **Salvar**. Uma janela de confirmação aparece e você deve clicar em **Editar** para confirmar as mudanças.
As mudanças são aplicadas imediatamente aos pipelines que usam a global e ainda não foram implantados. Pipelines já implantados só recebem os novos valores após o redeploy e um aviso no card do pipeline na página **Run** indica quando ele é necessário.
### **Descontinuando uma global**
Descontinuar uma global a torna indisponível para novos pipelines ou novas versões de pipelines. As implantações existentes continuam funcionando até que seja feito um redeploy.
Para descontinuar uma global:
1. Na lista de globals, clique na linha da global que deseja descontinuar.
2. Ative a opção **Descontinuada**.
3. Clique em **Salvar**.
{% hint style="warning" %}
Esta ação é irreversível.
{% endhint %}
### **Excluindo uma global**
Excluir uma global a remove permanentemente da plataforma. Não é possível excluir globals que estejam em uso em pipelines, implantados ou não. Para prosseguir, remova ou substitua a global em todos os pipelines antes de excluí-la.
Para excluir uma global:
1. Na lista de globals, clique nos três pontos da global que deseja excluir.
2. Selecione **Remover**.
3. Confirme a ação na janela de confirmação.
{% hint style="warning" %}
Esta ação é irreversível.
{% endhint %}
### **Usando globals**
Globals podem ser referenciadas em qualquer campo de texto do formulário de configuração de um conector. Para usar uma global:
1. Abra o pipeline ou a cápsula.
2. Selecione o conector que deseja configurar.
3. No campo desejado, digite `{{`. Na lista de preenchimento automático, selecione **global** e digite um ponto (`.`) para ver as variáveis disponíveis.
Você também pode inserir a referência manualmente:
```
{{global.globalName}}
```
Substitua `globalName` pelo nome da global. Por exemplo: `{{global.db-timeout}}`.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.digibee.com/documentation/developer-guide/pt-br/development-cycle/build-overview/globals.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.