> 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/deploy-and-manage-pipelines.md).

# Implantar (fazer deploy) e gerenciar pipelines

Aprenda a implantar (fazer deploy), reimplantar (fazer redeploy), promover, fazer rollback e remover pipelines na página Run da Digibee Integration Platform.

## **Antes de começar**

Para implantar ou gerenciar pipelines, você precisa das permissões **`DEPLOYMENT:READ`** e **`DEPLOYMENT:CREATE`**, ou de um papel que as inclua, no ambiente de destino (test ou prod). As permissões podem ser atribuídas ao seu usuário ou a um grupo do qual você faz parte. Leia mais sobre [Papéis](https://docs.digibee.com/documentation/developer-guide/pt-br/platform-administration/administration/new-access-control/access-control-roles.md).

O pipeline também precisa ter um trigger configurado.

### **Implante um pipeline (deploy)**

1. Na página **Run**, selecione o ambiente no canto superior esquerdo.
2. Clique em **Criar novo**.
3. Selecione o pipeline e a versão dele. A Plataforma mostra o projeto associado, o trigger e, no caso de pipelines multi-instância, a instância.
4. Em **Versão do pipeline engine**, selecione a versão da engine do pipeline. O padrão é a versão mais recente.
5. Em **Tamanho do pipeline**, selecione Small, Medium ou Large.
6. Defina o número de execuções simultâneas.
7. Defina o número de réplicas. Se o seu realm usa o Modelo baseado em consumo, o painel de implantação também mostra a opção de autoscaling, em que você define o número mínimo e máximo de réplicas. Consulte [Autoscaling](https://docs.digibee.com/documentation/development-cycle/overview/autoscaling.md).
8. Clique em **Implantar**.

Antes de a implantação ser concluída, a Plataforma mostra como ela afeta o seu consumo: licenças, no Modelo baseado em pipelines, ou uso de RTUs e subscrições, no Modelo baseado em subscription.

Se o pipeline já foi implantado antes, as configurações atuais são preenchidas automaticamente.

Para escolher o tamanho, as execuções simultâneas e as réplicas adequadas, leia [Como funciona a execução de pipelines](https://docs.digibee.com/documentation/developer-guide/pt-br/development-cycle/overview/how-pipeline-execution-works.md).

{% hint style="info" %}
Se você definir mais de 10 réplicas, a Plataforma mostra um aviso. O aviso é apenas informativo e não bloqueia a implantação.
{% endhint %}

### **Reimplante um pipeline (redeploy)**

Reimplante um pipeline para alterar o tamanho, as execuções simultâneas, as réplicas ou as configurações de autoscaling, ou quando a Plataforma indicar que a implantação atual não é mais válida.

1. Na página **Run**, encontre o pipeline.
2. Clique no menu de três pontos e selecione **Reimplantar**.
3. Altere as configurações necessárias.
4. Clique em **Reimplantar**.

{% hint style="warning" %}
Durante uma reimplantação, a instância atual do pipeline é removida antes de a nova ser criada. Com uma única réplica, o pipeline pode ficar indisponível por um breve período. Com várias réplicas, o impacto é menor, porque novas réplicas são iniciadas enquanto outras ainda estão em execução.

Se o runtime estiver fora do ar, nenhuma réplica pode ser alocada e o pipeline fica offline até o runtime se recuperar. Verifique o status do runtime antes de reimplantar e evite reimplantar durante períodos críticos de execução.
{% endhint %}

### **Promova um pipeline para outro ambiente**

1. Na página **Run**, selecione o ambiente em que o pipeline está implantado.
2. Clique no menu de três pontos do pipeline e selecione **Promover**.
3. Revise as configurações de implantação do ambiente de destino e altere-as, se necessário.
4. Clique em **Promover**.

Depois da promoção, a Plataforma abre a página Run do ambiente de destino e mostra as licenças consumidas. O pipeline continua implantado no ambiente de origem até você removê-lo.

### **Faça rollback para a versão anterior**

Faça o rollback de um pipeline quando ocorrerem erros depois de implantar uma nova versão. O rollback restaura a versão anterior que foi implantada com sucesso no mesmo ambiente.

1. Na página **Run**, clique no menu de três pontos do pipeline e selecione **Rollback**.
2. Confirme a ação.

{% hint style="warning" %}
Não é possível desfazer um rollback. Ele também não restaura configurações anteriores de Globais ou Contas: o pipeline usa a configuração atual delas.
{% endhint %}

### **Remova uma implantação**

1. Na página **Run**, clique no menu de três pontos do pipeline e selecione **Remover**.
2. Confirme a ação.

Somente a implantação da versão selecionada é removida. As demais versões do pipeline não são afetadas. Enquanto a remoção está em andamento, o pipeline mostra o status **Removendo**.

### **Solucione erros de implantação (deploy)**

Se um deploy, redeploy ou promoção falhar, consulte [Problemas de implantação (deploy)](https://docs.digibee.com/documentation/troubleshooting/pt-br/deployment-issues/globals-and-accounts-issues.md).

### **Próximos passos**

Agora que seu pipeline está implantado, leia [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 acompanhar o status dele e rastrear as alterações.


---

# 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/deploy-and-manage-pipelines.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.
