Renomear um projeto no Azure DevOps

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Renomear um projeto no Azure DevOps atualiza o nome do projeto em caminhos de controle de versão, itens de trabalho, consultas e outros artefatos de projeto. Você pode renomear um único projeto várias vezes e usar nomes antigos. Após a renomeação, algumas ações podem ser exigidas dos membros da equipe.

Aviso

Copilot do GitHub: ao renomear um projeto, o Azure DevOps notifica todos os membros do projeto por email se a contagem de usuários for inferior a 1.000. Para projetos com mais de 1.000 usuários, somente os Administradores da Coleção de Projetos recebem essas notificações.

Federação de identidades de carga de trabalho: renomear um projeto interromperá os assuntos de federação de identidades de carga de trabalho nas conexões de serviço do Gerenciador de Recursos do Azure.

Pré-requisitos

• Você deve ser membro do grupo Administradores de Projeto ou ter a permissão de projeto Renomear projeto de equipe no nível do projeto definida como Permitir. Para obter mais informações, confira Alterar permissões no nível do projeto.

Renomear um projeto

1. Entre na sua organização (https://dev.azure.com/{Your_Organization}) e abra o projeto que você deseja renomear.

2. Selecione Visão geral das configurações>do projeto, insira um novo nome e selecione Salvar.

   

3. Para confirmar a renomeação, insira o novo nome do projeto, marque a caixa ao lado de "Eu entendo as consequências de renomear este projeto" e selecione Salvar.

   

Resultados da renomeação

Os resultados a seguir ocorrem após a operação de renomeação.

• O Azure DevOps renomeia o projeto.

• Todos os membros do projeto recebem uma notificação por e-mail da alteração de nome, se menos de 1.000 membros.

• A URL continua a funcionar tanto para o novo nome da equipe quanto para o nome antigo da equipe. Esta funcionalidade destina-se a evitar a quebra de vínculos.

• Se o projeto na URL for um projeto válido na organização, mostraremos a ID do item de trabalho fornecida. O exemplo a seguir mostra uma organização com projetos chamados "Example1" e "Example2".

  https://dev.azure.com/MyOrg/Example1/_workitems/edit/40/ - Exibe o item de trabalho 40 - Exibe o item de trabalho 40 https://dev.azure.com/MyOrg/Example2/_workitems/edit/40/https://dev.azure.com/MyOrg/Potato/_workitems/edit/40/ - Exibe um erro 404

• As IDs de item de trabalho são exclusivas na organização e, portanto, os links não expiram.

• O nome do projeto antigo pode ser usado novamente.

Ações de usuário necessárias para trabalhar com o projeto renomeado

Cada usuário dentro de sua equipe deve reiniciar seus clientes e executar algumas das seguintes ações, com base nos recursos que eles usam:

• Atualizar controles remotos do Git
• Atualizar espaços de trabalho de servidor do Controle de Versão do Team Foundation (TFVC)
• Atualizar espaços de trabalho locais do TFVC

Reiniciar clientes

Os clientes abertos mantêm um cache de todos os nomes de projeto na memória, mas esse cache não é limpo automaticamente depois que um projeto é renomeado. Para limpar o cache, reinicie o cliente para que ele preencha o novo nome do projeto. Se você não reiniciar o cliente, as operações que usam o nome do projeto armazenado em cache falharão com uma exceção de projeto não encontrado .

Para os seguintes clientes, salve seu trabalho em cada um e reinicie:

• Team Explorer para Visual Studio
• Microsoft Excel, se sua equipe usa o Azure DevOps Office Integration 2019

Atualizar controles remotos do Git

Se seu projeto usa Git, suas referências remotas para cada repositório do projeto renomeado devem ser atualizadas. Essas atualizações são necessárias porque a URL do repositório remoto contém o projeto e o nome do repositório. O Git usa referências remotas para buscar e enviar alterações por push entre o repositório local e a versão remota armazenada no servidor. Cada membro de sua equipe deve atualizar seus repositórios Git locais para continuar se conectando a partir de suas máquinas de desenvolvimento.

Para obter mais informações, consulte Atualizar os controles remotos do Git em suas máquinas de desenvolvimento.

Atualizar espaços de trabalho do servidor TFVC

Se o seu projeto usa TFVC com espaços de trabalho de servidor, esses espaços de trabalho devem ser atualizados com o novo nome do projeto. Para clientes do Visual Studio, execute um get ou check-in e, em seguida, o mapeamento do espaço de trabalho é corrigido para usar o novo nome do projeto.

Para obter mais informações, consulte Comando Renomear (TFVC).

Atualizar espaços de trabalho locais do TFVC

Se sua equipe usa TFVC com espaços de trabalho locais, esses espaços de trabalho precisam ser atualizados com o novo nome do projeto. Para Visual Studio, execute um get ou check-in e o mapeamento do espaço de trabalho é corrigido para usar o novo nome do projeto.

Recomendamos que você atualize seus clientes para a atualização ou versão mais recente, se possível. Para todas as outras versões do Visual Studio com suporte, você deve criar um novo espaço de trabalho local mapeado para o novo nome do projeto.

Os espaços de trabalho locais são gerenciados localmente e não no servidor. Clientes mais antigos sem a lógica de renomeação atualizada não podem atualizar espaços de trabalho locais para o novo nome do projeto.

Artigos relacionados

• Excluir um projeto
• Git e Azure Repos

Perguntas frequentes (FAQs)

P: Por que minha tentativa de reutilizar um nome de projeto falhou devido a espaços de trabalho existentes?

R: Não é possível reutilizar um nome de projeto se ainda houver mapeamentos de espaço de trabalho abordando-o. Essa função ajuda a evitar o caso de ambiguidade em que um espaço de trabalho pode ser mapeado para dois projetos. Entre em contato com os usuários que têm esses mapeamentos e exclua-os ou atualize-os para usar o novo nome.

Se a máquina do usuário que contém o espaço de trabalho não estiver mais disponível, você poderá excluir o espaço de trabalho executando o seguinte comando no prompt de comando do desenvolvedor do Visual Studio: tf workspace /delete [/collection:TeamProjectCollectionUrl] workspacename[;workspaceowner]

P: Como renomear um projeto afeta minha experiência de navegação no navegador?

R: Depois de renomear um projeto, qualquer navegador com o projeto aberto pode encontrar alguns erros. Esses erros são devidos a caches mantidos pelo navegador, que incluem o nome antigo do projeto. Atualize para que esses erros desapareçam, já que o cache é preenchido novamente com o novo nome do projeto.

P: Outros artefatos no projeto são renomeados?

R: Sim, todos os artefatos que compartilham o mesmo nome são renomeados junto com o projeto. As únicas exceções são para a equipe padrão e repo. A renomeação desses artefatos é realizada como um melhor esforço. Por exemplo, se um Foo de projeto fosse renomeado para Bar, a equipe padrão Foo não seria renomeada se uma equipe chamada Bar já existisse no projeto.

P: Por que não consigo abrir consultas salvas em um disco após uma renomeação?

R: Se você usar o Visual Studio 2010 e tiver consultas salvas em disco, não será possível abri-las depois de renomear um projeto. Você pode usar o Visual Studio 2012 ou mais recente para abri-los.