Projetos
Saiba como criar e gerenciar projetos para garantir governança e organização dos seus pipelines, com controle de acesso e estruturação por pastas.
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. Saiba mais na documentação de Papéis.
Gerenciamento de projetos
Criar um projeto
Acesse a página Build, na aba Pipeline, e clique em Criar novo.
Selecione Projeto.
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.
Clique em Salvar.
Após criar o projeto, você pode começar a criar pipelines dentro dele. 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.
Por motivos de auditoria, 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.
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.
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 e Contas, 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.
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.
Gerenciamento de pastas
Pastas ajudam você a organizar seus pipelines dentro de um projeto.
Criar uma pasta
Abra o projeto desejado e clique em Criar novo.
Selecione Pasta de projeto.
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.
Insira o nome da pasta. O nome deve ser exclusivo dentro do projeto, mas pode ser reutilizado em outros projetos.
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.
Atualizado
Isto foi útil?