# 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**](/documentation/developer-guide/pt-br/platform-administration/administration/new-access-control/access-control-roles.md). Saiba mais na [**documentação de Papéis**](/documentation/developer-guide/pt-br/platform-administration/administration/new-access-control/access-control-roles.md). ## **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**.
Após criar o projeto, você pode começar a [criar pipelines dentro dele](/documentation/developer-guide/pt-br/development-cycle/build-overview/pipelines/how-to-create-a-pipeline.md). 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](/documentation/developer-guide/pt-br/platform-administration/administration/audit.md), 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**](/documentation/developer-guide/pt-br/development-cycle/build-overview/globals.md#criando-uma-global) e [**Contas**](/documentation/developer-guide/pt-br/development-cycle/build-overview/accounts.md#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**.
### **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.
--- # Agent Instructions: 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: ``` GET https://docs.digibee.com/documentation/developer-guide/pt-br/development-cycle/build-overview/projects.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.