> 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/overview.md).

# Run

Aprenda a usar a página Run da Digibee Integration Platform para encontrar, filtrar e gerenciar os deploys dos seus pipelines.

Run é a fase que vem depois de Build. Na página Run, você implanta pipelines (faz o deploy), acompanha o status deles e os gerencia nos ambientes de teste e produção.

## **Selecione o ambiente**

Selecione o ambiente no canto superior esquerdo antes de implantar ou gerenciar um pipeline:

* **Test:** Valide seu pipeline sem afetar as integrações em execução.
* **Prod:** Execute o pipeline em produção depois de testá-lo.

{% hint style="info" %}
Para atualizar ou corrigir um pipeline que está em produção, faça as alterações primeiro em teste e depois promova o pipeline para produção.
{% endhint %}

## **Navegue pela página**

A página Run tem duas abas:

* **Pipelines:** Lista os pipelines implantados, agrupados por projeto. Selecione **Todos os projetos** ou um projeto específico no painel à esquerda.
* **Histórico:** Lista as implantações recentes de todos os projetos. Consulte [Status e histórico de implantação (deploy)](https://docs.digibee.com/documentation/developer-guide/pt-br/development-cycle/overview/deployment-status-and-history.md).

A página atualiza os dados automaticamente. Para mudar o intervalo ou desativar a atualização, use a opção **Atualizar dados a cada** abaixo do título da página.

## **Encontre um pipeline implantado**

Use a barra de busca para encontrar pipelines implantados pelo nome em todos os seus projetos.

Você também pode filtrar a lista por:

* **Status:** Implantado, Erro, Reimplantar, Iniciando e Removendo. Consulte [Status e histórico de implantação (deploy)](https://docs.digibee.com/documentation/developer-guide/pt-br/development-cycle/overview/deployment-status-and-history.md) para entender o que cada status significa.
* **Triggers:** Até cinco triggers.
* **Tamanho:** Pequeno, Médio e Grande.
* **Versão da engine:** As versões da engine em execução no ambiente atual, da mais recente para a mais antiga. Use a caixa de busca para encontrar uma versão específica. As versões aparecem no formato x.y.z, então builds diferentes da mesma versão aparecem como uma única opção.

Você pode selecionar mais de uma opção em cada filtro.

Os filtros aplicados ficam salvos na URL da página. Copie o link para compartilhar a mesma visualização filtrada com seu time.

## **Visualize as implantações**

Você pode visualizar as implantações em lista ou em cards. Para alternar entre as visualizações, use os ícones ao lado dos filtros.

A visualização em lista é o padrão. Cada linha mostra o nome e a versão do pipeline, o status, a versão da engine, o tamanho, as execuções simultâneas, as réplicas e quem fez a implantação e quando.

As implantações são ordenadas pela data de implantação, da mais recente para a mais antiga, nas duas visualizações.

## **Gerencie uma implantação**

Para gerenciar um pipeline implantado, clique no menu de três pontos na linha ou no card dele:

| Opção                              | O que faz                                                                                                                                                                                                                             |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Promover**                       | Implanta o pipeline em outro ambiente.                                                                                                                                                                                                |
| **Reimplantar**                    | Implanta o mesmo pipeline novamente com novas configurações.                                                                                                                                                                          |
| **Rollback**                       | Reverte o pipeline para a versão anterior implantada com sucesso.                                                                                                                                                                     |
| **Remover**                        | Remove a implantação da versão selecionada. As demais versões não são afetadas.                                                                                                                                                       |
| **Abrir canvas**                   | Abre o pipeline em Build.                                                                                                                                                                                                             |
| **Ver execuções**                  | Abre as execuções do pipeline em Monitor.                                                                                                                                                                                             |
| **Abrir diferenças entre versões** | Compara lado a lado duas versões minor do pipeline implantado. Consulte [Versionamento de pipelines](https://docs.digibee.com/documentation/developer-guide/pt-br/development-cycle/build-overview/pipelines/pipeline-versioning.md). |

## **Próximos passos**

Agora que você já conhece a página Run, leia [Implantar (fazer deploy) e gerenciar pipelines](https://docs.digibee.com/documentation/developer-guide/pt-br/development-cycle/overview/deploy-and-manage-pipelines.md) para fazer o deploy do seu primeiro pipeline.


---

# 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/overview.md?ask=<question>&goal=<user_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.
