Renomear um projeto no Azure DevOps

Serviços de DevOps do Azure | 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

Copiloto 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 de 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 identidade de carga de trabalho nas conexões de serviço do Azure Resource Manager.

Pré-requisitos

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

Renomear um projeto

  1. Inicie sessão no seu projeto (https://dev.azure.com/{Your_Organization}/{Your_Project}).

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

    Captura de ecrã a mostrar a nova entrada de nome e o botão Guardar realçado.

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

    Captura de ecrã a mostrar o novo ecrã de confirmação de nome com o botão Guardar.

Resultados da mudança de nome

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 mudança de nome, se menos de 1.000 membros.

  • O URL continua a funcionar tanto para o novo nome da equipa como para o nome da equipa antiga. Esta funcionalidade destina-se a evitar a quebra de links.

  • 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 "Exemplo1" e "Exemplo2".

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

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

  • O nome antigo do projeto pode ser usado novamente.

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

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

Reiniciar clientes

Os clientes abertos mantêm um cache de todos os nomes de projetos na memória, mas esse cache não é automaticamente limpo 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:

Atualizar controles remotos 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 por push alterações entre seu repositório local e a versão remota armazenada no servidor. Cada membro da 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 Git em suas máquinas de desenvolvimento.

Atualizar espaços de trabalho do servidor TFVC

Se 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.

Captura de ecrã do explorador de controlo do código-fonte, mostrando a seleção da versão mais recente.

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 suportadas do Visual Studio, 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.

Perguntas mais frequentes (FAQ)

P: Por que minha tentativa de reutilizar um nome de projeto falhou devido aos 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. Esta 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 é que mudar o nome de um projeto afeta a minha experiência de navegação no browser?

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 fazer com que esses erros desapareçam, pois 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 projeto Foo foi 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 no disco, não poderá abri-las depois de renomear um projeto. Você pode usar o Visual Studio 2012 ou mais recente para abri-los.