# Build

**Build** é a principal porta de entrada da Plataforma, onde o ciclo de desenvolvimento começa. Nesta página, você pode:

* Criar e gerenciar [pipelines](https://docs.digibee.com/documentation/developer-guide/pt-br/development-cycle/build-overview/pipelines) na aba **Pipelines**
* Criar e gerenciar [cápsulas](https://docs.digibee.com/documentation/developer-guide/pt-br/development-cycle/build-overview/capsulas) na aba **Cápsulas**
* Criar e gerenciar [variáveis globais](https://docs.digibee.com/documentation/developer-guide/pt-br/platform-administration/settings/globals) na aba Globals
* Criar e gerenciar [contas](https://docs.digibee.com/documentation/developer-guide/pt-br/platform-administration/settings/accounts) na aba Contas.

## **Aba Pipelines**

<figure><img src="https://2518718503-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcO0A6g1dOsu8BiHYqO67%2Fuploads%2F0TcHBACyf6tJNxWmS45z%2Fpipelines-pt.png?alt=media&#x26;token=79a3e93d-c653-445a-b9c7-20a04673a889" alt=""><figcaption><p>Aba Pipelines na página de Build.</p></figcaption></figure>

Um **pipeline** é um fluxo de integração que conecta sistemas e gerencia a troca de dados na Digibee Integration Platform. Ele começa com um **trigger**, que inicia o fluxo, e inclui um ou mais **conectores** que interagem com sistemas externos, transformam dados e permitem a comunicação entre serviços.

Na aba **Pipelines** da página Build, você pode:

* Criar um [pipeline do zero](https://docs.digibee.com/documentation/developer-guide/pt-br/development-cycle/build-overview/pipelines/how-to-create-a-pipeline)
* Criar um [pipeline com base em uma especificação OpenAPI](https://docs.digibee.com/documentation/developer-guide/pt-br/development-cycle/build-overview/pipelines/how-to-scaffold-a-pipeline-using-an-openapi-specification)
* Criar [projetos para agrupar e organizar seus pipelines](https://docs.digibee.com/documentation/developer-guide/pt-br/development-cycle/build-overview/projects)

### **Busca e filtros**

Todos os pipelines aos quais você tem acesso são exibidos no centro da página. Use os seguintes **filtros** para localizar e gerenciar pipelines com mais agilidade:

* **Ordenar por:**
  * **Nome**: Ordena os pipelines em ordem alfabética.
  * **Data de atualização**: Ordena pelos pipelines com mudanças mais recentes.
  * **Versão:** Ordena os pipelines pelas versões mais recentes.
* **Status:**
  * **Todos ativos**: Exibe apenas pipelines ativos (não arquivados).
  * **Arquivados**: Exibe apenas pipelines arquivados.
  * **Rascunho**: Exibe apenas os pipelines que ainda não foram implantados.
* **Triggers:** Filtra os pipelines por até cinco triggers selecionados.

{% hint style="info" %}
Os filtros são redefinidos ao mudar de projeto ou realm.
{% endhint %}

### **Detalhes do card do pipeline**

<figure><img src="https://2518718503-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcO0A6g1dOsu8BiHYqO67%2Fuploads%2FBpaTFuHVJ44QKS6ZDtgw%2Fpr%C3%A9via-card-pipeline.gif?alt=media&#x26;token=e5cfd934-bcae-44a4-951d-d22ce35d0bd6" alt=""><figcaption><p>Informações e ações exibidas no card do pipeline.</p></figcaption></figure>

#### **Informações exibidas**

* Categoria e nome do trigger usado no pipeline.
* Nome e descrição do pipeline
* Número de passos, cápsulas e subfluxos.
* Versão do pipeline.
* Ambientes implantados e suas versões (ao passar o mouse, todos os ambientes são exibidos).
* Prévia do pipeline (acessível pelo botão **Prévia**, exibido apenas ao passar o mouse).

{% hint style="info" %}
A prévia do pipeline é exibida apenas para pipelines salvos após o lançamento da funcionalidade. Para pipelines salvos anteriormente, é necessário salvá-los novamente para visualizar a prévia.
{% endhint %}

#### **Ações disponíveis no menu de três pontos**

* **Nova versão:** Cria uma nova versão major do pipeline.
* **Arquivar:** Arquiva o pipeline (não é possível excluí-lo permanentemente).
* **Restaurar:** Restaura o pipeline, caso tenha sido arquivado.
* **Ver histórico:** Exibe o histórico de versões do pipeline.
* **Ver execuções:** Abre a página de Execuções em Monitor.
* **Abrir no Canvas:** Abre o pipeline no ambiente de desenvolvimento.

### **Movendo um pipeline entre projetos**

Você pode mover pipelines entre projetos arrastando e soltando os cards na pasta do projeto desejado.

Lembre-se de que os pipelines só podem usar contas e globals associados ao projeto atual. Se você mover um pipeline para um projeto em que essas contas ou globals não estejam disponíveis, ele não funcionará mais e não será possível implantá-lo.

Para resolver isso, você pode:

* Atualizar as [contas](https://docs.digibee.com/documentation/developer-guide/pt-br/platform-administration/settings/accounts) e [globals](https://docs.digibee.com/documentation/developer-guide/pt-br/platform-administration/settings/globals) para que fiquem disponíveis no novo projeto, ou
* Editar o pipeline para usar contas ou globals já associados ao novo projeto.

## **Aba Cápsulas**

<figure><img src="https://2518718503-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcO0A6g1dOsu8BiHYqO67%2Fuploads%2FGdkUE5dcJvDDoikbwjcX%2Fcapsules-pt%20(1).png?alt=media&#x26;token=eac18791-efbe-4b1a-acf2-2bc71e2fa2ac" alt=""><figcaption><p>Aba Cápsulas na página de Build.</p></figcaption></figure>

Cápsulas são conjuntos reutilizáveis de conectores pré-configurados, encapsulados para acelerar o desenvolvimento de pipelines e oferecer as mesmas funcionalidades dos conectores individuais.

Na aba **Cápsulas** da página Build, você pode:

* Criar cápsulas [personalizadas para seus casos de uso](https://docs.digibee.com/documentation/developer-guide/pt-br/development-cycle/build-overview/capsulas/how-to-use-capsules/how-to-configure-a-capsule)
* Organizar suas cápsulas em [coleções](https://docs.digibee.com/documentation/developer-guide/pt-br/development-cycle/build-overview/capsulas/how-to-use-capsules/how-to-create-a-capsule-collection) e [grupos](https://docs.digibee.com/documentation/developer-guide/pt-br/development-cycle/build-overview/capsulas/how-to-use-capsules/how-to-create-a-capsule-group)
* Acessar facilmente suas cápsulas, [inclusive as arquivadas](https://docs.digibee.com/documentation/developer-guide/pt-br/development-cycle/build-overview/capsulas/how-to-use-capsules/how-to-archive-and-restore-a-capsule)

As cápsulas ficam listadas no lado esquerdo da página Build, ao lado de **Pipelines**, e podem ser reutilizadas como conectores em seus fluxos de integração.

{% hint style="info" %}
Saiba mais na [documentação de Cápsulas](https://docs.digibee.com/documentation/developer-guide/pt-br/development-cycle/build-overview/capsulas).
{% endhint %}

## Aba Globals

<figure><img src="https://2518718503-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcO0A6g1dOsu8BiHYqO67%2Fuploads%2Frf6RSihQ3F7ViK7jNK3O%2Fglobals-pt.png?alt=media&#x26;token=4a278bf0-11cd-4ac5-bbfb-b39697a98a4e" alt=""><figcaption></figcaption></figure>

Globals são variáveis armazenadas na Plataforma que podem ser reutilizadas em vários pipelines e cápsulas. Depois de criar uma global, você pode referenciá-la em qualquer campo de texto nos formulários de configuração do conector. Quando uma global é atualizada, a alteração é aplicada automaticamente onde quer que a variável seja usada.

Na aba **Globals** em Build, você pode:

* Criar uma variável global.
* Visualizar, editar e excluir globals.
* Acessar todas as globals, incluindo as que foram descontinuadas.

Saiba mais na documentação de [Globals](https://docs.digibee.com/documentation/developer-guide/pt-br/platform-administration/settings/globals).

## Aba Contas

<figure><img src="https://2518718503-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcO0A6g1dOsu8BiHYqO67%2Fuploads%2Fh2PeSl22AAfOPAYVYaa7%2Faccounts_build_PT.png?alt=media&#x26;token=06644249-d49f-4559-813d-69e53e11cc76" alt=""><figcaption><p>Aba Contas na página de Build</p></figcaption></figure>

As contas oferecem uma maneira segura de armazenar informações confidenciais, como senhas, chaves privadas e tokens de autenticação, sem expor essas credenciais diretamente em suas integrações.

Além disso, as contas podem ser restritas a projetos específicos, garantindo que as informações confidenciais só sejam acessíveis onde forem necessárias. Elas podem então ser usadas em conectores dentro de pipelines e cápsulas para autenticar e autorizar o acesso a endpoints externos.

Na aba **Contas** da página Build, você pode:

* Criar uma conta.
* Visualizar, editar e excluir contas.
* Acessar todas as contas, incluindo as obsoletas.

Saiba mais na [documentação sobre Contas](https://docs.digibee.com/documentation/developer-guide/pt-br/platform-administration/settings/accounts).
