# Projetos

## Visão geral

Projetos ajudam você a organizar e gerenciar seus pipelines enquanto controla quem pode acessá-los.

Você pode atribuir usuários e grupos a cada projeto pela página **Projetos**. Além disso, é possível restringir o acesso a **Contas** e **Globals** por projeto — nas respectivas páginas, defina quais projetos podem usar esses recursos.

Essa estrutura garante governança adequada e uma separação clara entre integrações.

## **Antes de começar**

Para gerenciar projetos, você precisa da permissão [**Project Manager**](https://docs.digibee.com/documentation/developer-guide/pt-br/platform-administration/administration/new-access-control/access-control-roles). Saiba mais na [**documentação de Papéis**](https://docs.digibee.com/documentation/developer-guide/pt-br/platform-administration/administration/new-access-control/access-control-roles).

## **Gerenciamento de projetos**

### **Criar um projeto**

1. Acesse a página **Build**, na aba **Pipeline**, e clique em **Criar novo**.
2. Selecione **Projeto**.
3. No formulário de configuração, preencha os seguintes campos:
   * **Nome:** Nome do projeto.
   * **Descrição:** Descrição do projeto.
   * **Associação do projeto:** Ative **Selecionar todos os usuários** para atribuir todos os usuários atuais e futuros do seu realm ou defina:
     * **Grupos associados:** Grupos de usuários a serem atribuídos.
     * **Usuários associados:** Usuários individuais a serem atribuídos.
4. Clique em **Salvar**.

<figure><img src="https://2518718503-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcO0A6g1dOsu8BiHYqO67%2Fuploads%2FcTCszxBPCGdcI1n85LlS%2Fcriar-projeto.gif?alt=media&#x26;token=d6f18c97-9a33-4d01-8e86-2ececf9e9307" alt=""><figcaption></figcaption></figure>

Após criar o projeto, você pode começar a [criar pipelines dentro dele](https://docs.digibee.com/documentation/developer-guide/pt-br/development-cycle/build-overview/pipelines/how-to-create-a-pipeline). Os pipelines são automaticamente vinculados ao projeto em que foram criados. O projeto **Default** está sempre disponível caso você prefira não criar um projeto personalizado.

### **Editar um projeto**

Passe o mouse sobre o nome do projeto na barra lateral esquerda e clique no **ícone de três pontos** para abrir o menu:

* **Editar:** Abre o formulário de configuração para atualizar os detalhes do projeto.

{% hint style="warning" %}
Por motivos de [auditoria](https://docs.digibee.com/documentation/developer-guide/pt-br/platform-administration/administration/audit), o nome do projeto não pode ser alterado. Se você precisar renomear um projeto, crie um novo com o nome desejado e migre os pipelines.
{% endhint %}

* **Arquivar:** Arquiva o projeto. Apenas projetos vazios podem ser arquivados. Para desarquivar um projeto, entre em contato com seu CSM.

Você também pode criar pastas a partir desse mesmo menu — veja mais em [Criar uma pasta](#criar-uma-pasta).

### **Mover pipelines entre projetos**

Para mover um pipeline para outro projeto ou pasta, arraste e solte o card para o local desejado.

#### **Globals e Contas removidas permanentemente após a movimentação**

Antes de mover um pipeline para outro projeto, garanta que todas as **Globals** e **Contas** usadas pelo pipeline estejam permitidas no projeto de destino. Atualize as permissões nas páginas de [**Globals**](https://docs.digibee.com/documentation/developer-guide/pt-br/platform-administration/settings/globals#criando-uma-global) e [**Contas**](https://docs.digibee.com/documentation/developer-guide/pt-br/platform-administration/settings/accounts#criando-uma-conta), se necessário.

Se você mover o pipeline sem atualizar essas permissões, um aviso listará as **Globals** ou **Contas** que não são permitidas e que serão **removidas permanentemente** do pipeline. Você pode prosseguir com a movimentação ou cancelá-la para atualizar as permissões primeiro.

Depois de removidas, **Globals e Contas não são restauradas automaticamente**. Mover o pipeline de volta ou permitir o projeto novamente não reverte a remoção. Você deve adicioná-las manualmente ao pipeline.

{% hint style="warning" %}
A partir da release de 14 de janeiro de 2026, pipelines que contenham **Globals** ou **Contas** não permitidas no projeto atual continuarão funcionando apenas até serem salvos novamente.
{% endhint %}

## Gerenciamento de p**astas**

Pastas ajudam você a organizar seus pipelines dentro de um projeto.

### **Criar uma pasta**

1. Abra o projeto desejado e clique em **Criar novo**.
2. Selecione **Pasta de projeto**.

{% hint style="info" %}
Você também pode passar o mouse sobre o nome do projeto na barra lateral esquerda, clicar no **ícone de três pontos** e selecionar **Criar nova pasta**.
{% endhint %}

3. Insira o nome da pasta. O nome deve ser exclusivo dentro do projeto, mas pode ser reutilizado em outros projetos.
4. Clique em **Salvar**.

<figure><img src="https://2518718503-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcO0A6g1dOsu8BiHYqO67%2Fuploads%2FnMk2vqV7zz4PEwoz6l0E%2Fcriar-pasta.gif?alt=media&#x26;token=293add1f-f0c9-4319-bef3-d938cd7730ef" alt=""><figcaption></figcaption></figure>

### **Editar uma pasta**

Passe o mouse sobre o nome da pasta e clique no **ícone de três pontos** para acessar as seguintes opções:

* **Editar:** Alterar o nome da pasta.
* **Arquivar:** Arquivar a pasta. Apenas pastas vazias podem ser arquivadas.

### Regras de organização de pastas e pipelines

Você pode organizar pipelines e pastas das seguintes formas:

* **Mover pipelines livremente:** Arraste e solte pipelines entre pastas, entre projetos, de uma pasta para a raiz do projeto ou da raiz para uma pasta.
* **Navegar pela raiz do projeto:** Ao clicar na raiz do projeto, você vê todas as pastas (se existirem) e quaisquer pipelines que não estejam dentro de uma pasta.
* **Usar o menu lateral esquerdo:** Ao clicar na raiz do projeto, o menu lateral se expande, exibindo todas as pastas e a opção **Todos os pipelines**. Ao selecionar **Todos os pipelines**, você visualiza todos os pipelines do projeto.

<figure><img src="https://2518718503-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcO0A6g1dOsu8BiHYqO67%2Fuploads%2Fg5YslHkkiT0fObaqb7A4%2Fmover-pipelines.gif?alt=media&#x26;token=fe01dbbf-96ea-4f0a-ab89-7054d48c2ee7" alt=""><figcaption></figcaption></figure>