> 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

Run é a segunda fase da Digibee Integration Platform, após a fase Build. Seu objetivo é realizar o a implantação (deploy) de um pipeline configurado, executá-lo e colocar a integração em produção.

### Seletor de ambiente

Selecione o ambiente de destino no canto superior esquerdo antes de fazer a implantação de um pipeline. Dois ambientes estão disponíveis: test e prod.

* **Test:** use esse ambiente para avaliar e validar seu pipeline antes de movê-lo para produção. Você pode testar e modificar as configurações sem afetar as integrações em execução.
* **Prod:** use esse ambiente para a implantação final, após o pipeline ter sido testado e validado.

{% hint style="info" %}
Sempre que um pipeline no ambiente prod precisar de uma atualização ou correção de bug, faça os ajustes no ambiente test primeiro e, em seguida, promova o pipeline de volta para produção.
{% endhint %}

### Tag de ambiente

A tag de ambiente ajuda a identificar em qual ambiente você está trabalhando, evitando ações acidentais no ambiente errado. A cor da tag indica a criticidade do ambiente selecionado:

* **Produção:** rosa
* **Teste:** azul claro

A tag é exibida na página Run, na página Monitor e na página de configurações de Consumers (chaves de API).

### Atualização automática de dados

A função de atualização automática atualiza os dados da página em um intervalo selecionado:

* 5 segundos
* 10 segundos
* 30 segundos

Essa opção está habilitada por padrão. Para desativá-la, selecione toggle para desligar a **Atualização automática.**

### Lista de projetos

Após selecionar o ambiente, escolha o projeto que deseja fazer a implantação. Os projetos são listados abaixo do seletor de ambiente.

À medida que você interage com a página Run, dados adicionais são carregados progressivamente em segundo plano. Esse modo de scroll infinito foi projetado para exibir o conteúdo essencial rapidamente.

Leia a [documentação sobre projetos](/documentation/developer-guide/pt-br/development-cycle/build-overview/projects.md) para mais detalhes.

### Busca global e filtros para pipelines implantados

Você pode buscar pipelines implantados em todos os seus projetos usando palavras-chave do nome do pipeline, nos ambientes test e prod. Os resultados da busca exibem o nome do pipeline, o projeto associado e todas as versões disponíveis de cada pipeline.

Você também pode filtrar pipelines por:

* **Status:** Filtre pelo status atual do pipeline. As opções disponíveis são: Implantado, Erro, Reimplantar e Iniciando. Consulte [Status de pipeline](/documentation/developer-guide/pt-br/development-cycle/overview/deployment/pipeline-deployment-status.md) para mais detalhes.
* **Triggers:** Filtre por até cinco triggers selecionados.

Consulte [Versionamento de pipeline ](/documentation/developer-guide/pt-br/development-cycle/build-overview/pipelines/pipeline-versioning.md)para mais detalhes sobre gerenciamento de versões.

### Implantações

Todas as informações de implantações de pipeline estão disponíveis no centro da página Run. Você pode visualizá-las em dois modos de exibição: Cards e Tabela. Para alternar entre os modos, use o botão de alternância no canto superior direito da tela.

### Opções do pipeline

Para acessar opções avançadas, clique no menu de três pontos no pipeline selecionado:

* <i class="fa-box-arrow-up">:box-arrow-up:</i> **Promover:** Move o pipeline para outro ambiente.
* <i class="fa-paper-plane">:paper-plane:</i> **Reimplantar:** Refaz o deploy do mesmo pipeline com as alterações de configuração aplicadas.
* <i class="fa-arrow-u-turn-up-left">:arrow-u-turn-up-left:</i> **Rollback:** Reverte o pipeline para a versão anterior implantada com sucesso. Use essa opção quando erros ocorrerem após a implantação de uma nova versão.
* <i class="fa-trash">:trash:</i> **Remover:** Remove a implantação da versão selecionada. As demais versões não são afetadas.
* <i class="fa-arrow-right">:arrow-right:</i> **Abrir canvas:** Abre a página de execuções em Monitor.
* <i class="fa-arrow-right">:arrow-right:</i> **Ver execuções:** Abre a página de execuções em Monitor.
* <i class="fa-up-right-from-square">:up-right-from-square:</i> **Abrir diferenças entre versões:** Permite comparar duas versões secundárias de pipelines implantados lado a lado.

{% hint style="warning" %}
Ao realizar uma implantação, reimplantação ou promoção, um aviso informativo é exibido se o número de réplicas ultrapassar 10. Esse aviso é apenas informativo e não bloqueia a ação.
{% endhint %}

### Deployment

Clique em **Criar novo** para escolher um pipeline para implantar. Na tela, você selecionará:

* Nome do pipeline
* Versão do pipeline
* Projeto
* Instância
* Versão da engine
* Tamanho do pipeline
* Número de execuções simultâneas
* Número de réplicas

Consulte a [documentação de implantação ](/documentation/developer-guide/pt-br/development-cycle/overview/deployment/deployments.md)para mais detalhes sobre como fazer a implantação de um pipeline, como promover pipelines entre ambientes e outros recursos.

### Histórico

Para acompanhar as alterações recentes de um pipeline e revisar o que foi implantado, abra a aba **Histórico** no sidesheet de detalhes da implantação.

### Próximos passos

Agora que seu pipeline está implantado, leia a [documentação de Monitor](/documentation/developer-guide/pt-br/development-cycle/dashboards.md) para saber como acompanhar os dados e monitorar o desempenho do seu pipeline em tempo real.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.digibee.com/documentation/developer-guide/pt-br/development-cycle/overview.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
