> 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/platform-administration/settings/multi-instance/multi-instance.md).

# Implantando um pipeline de multi-instância

Saiba mais sobre como implantar um pipeline de multi-instâncias.

## **Como implantar um pipeline** multi-instância? <a href="#h_b2fc3d4ffe" id="h_b2fc3d4ffe"></a>

### 1. Crie o modelo de multi-instância <a href="#h_f1b978282c" id="h_f1b978282c"></a>

Antes de criar as instâncias, você deverá criar um modelo de multi-instância. Para isso, acesse a página **Multi-Instância**, em **Configurações**, clique em **Criar** e defina um nome, uma descrição e os campos das instâncias, isto é, as variáveis que receberão os valores em cada ambiente.&#x20;

Veja o exemplo abaixo:

![](https://content.gitbook.com/content/cO0A6g1dOsu8BiHYqO67/blobs/UFGN4zSCOa2ngmCOEQMc/1.criar-multi-instancia.png)

Feito isso, clique em **Confirmar** para criar o modelo.

### 2. Configure as instâncias <a href="#h_44f2628b03" id="h_44f2628b03"></a>

Agora, você poderá criar as instâncias que corresponderão ao modelo criado na última etapa. Para isso, localize o modelo na listagem e clique no botão da ação **Configurar** correspondente a ele. Desse modo, você poderá criar as instâncias desse modelo uma a uma inserindo e definindo valores para cada campo.

No exemplo abaixo, "instancia1" e "instancia2" são duas lojas que receberão os valores de cada variável que podem ser configuradas tanto para *test* quanto para *prod.* Isso se repete para todas as demais instâncias a serem criadas.

![](https://content.gitbook.com/content/cO0A6g1dOsu8BiHYqO67/blobs/GBsGgd3ZWLtoH2sGZZBN/2.configurar-instancias.gif)

Após informar as variáveis, basta clicar em **Salvar**.

### 3. Crie um pipeline multi-instância <a href="#h_8db809b531" id="h_8db809b531"></a>

Nesta etapa, vamos criar um *pipeline* e defini-lo como multi-instância. Para isso, acesse as configurações clicando no botão de **Configurações** e ativando a opção **É multi-instância?**:

![](https://content.gitbook.com/content/cO0A6g1dOsu8BiHYqO67/blobs/LvtwZPgLsrlziAbQiMnt/3.pipeline-multi-instancia.gif)

Após a opção **É multi-instância?** ser selecionada, informe a qual modelo de multi-instância o *pipeline* reportará. No nosso exemplo, estamos utilizando o "modelo-multi-instancia".&#x20;

{% hint style="info" %}
Após definir o *pipeline* como multi-instância, não será possível reverter essa configuração. Por outro lado, é possível transformar qualquer *pipeline*, implantado ou não, em um *pipeline* multi-instância.
{% endhint %}

Por ser um evento, devemos informar no *trigger* uma variável da instância que será executada através do padrão **`-{{replica.nome_da_variavel_da_instância}}`**, como no exemplo abaixo:

![](https://content.gitbook.com/content/cO0A6g1dOsu8BiHYqO67/blobs/pttaVnKNBjcKoeu511WJ/4.trigger-event.png)

#### **Realizando consultas no Painel de execução**

Ao executar o teste no Painel de execução em um *pipeline* multi-instância, a primeira coluna da aba **Teste** permitirá que você informe a instância a qual pretende executar, como no exemplo abaixo:

<figure><img src="https://content.gitbook.com/content/cO0A6g1dOsu8BiHYqO67/blobs/RuBUO2OSQ8cwbJCI6jF2/5.painel-de-execu%C3%A7%C3%A3o-multi-inst%C3%A2ncia.gif" alt=""><figcaption></figcaption></figure>

Desse modo, é possível consultar os valores previamente configurados na instância selecionada através do padrão **`{{replica.nome_da_variável_da_instância}}`**.

### 4. Implantando um pipeline multi-instância <a href="#h_990defdcd9" id="h_990defdcd9"></a>

Agora que você já configurou o modelo e definiu o *pipeline* como multi-instância, é necessário editar a solicitação do *pipeline* com a instância em que pretende implantá-lo. Desse modo, o nome da instância será adicionado ao nome do *pipeline* após a implantação.&#x20;

**Por exemplo**: uma vez que o "pipeline-multi-instancia” for implantado na "instancia1", seu nome no *card* do *pipeline* na aba **Run** será "pipeline-multi-instancia-instancia1".

No exemplo abaixo, o “pipeline-multi-instancia” está sendo implantado na "instancia1" e "instancia2".

![](https://content.gitbook.com/content/cO0A6g1dOsu8BiHYqO67/blobs/xTanSX10QQLdxvUh4Usu/6.implantar-pipeline.gif)

Após a edição, basta clicar em **Implantar**.

Abaixo, o “pipeline-multi-instancia” já implantado nas instâncias "instancia1" e "instancia2", na aba de **Run** mostrada no card do *pipeline*:

![](https://content.gitbook.com/content/cO0A6g1dOsu8BiHYqO67/blobs/IPvuFex3upNS8zSAO5c4/7.pipeline-implantado.png)


---

# 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/platform-administration/settings/multi-instance/multi-instance.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.
