Importar um repositório Git para um projeto

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Este artigo mostra como importar um Repositório do Git existente do GitHub, Bitbucket, GitLab ou de outro local para um repositório existente novo ou vazio em seu projeto do Azure DevOps.

Pré-requisitos

Importar para um novo repositório

Execute as seguintes etapas para importar para um novo repositório:

1. No navegador, entre em sua organização e selecioneArquivos>.

   

2. Na lista suspensa do repositório, selecione Importar repositório.

   

3. Insira a URL de clone do repositório de origem e um nome para o novo repositório Git.

4. Selecione Importar um repositório.

O repositório é importado.

Importar para um repositório vazio existente

Na página Arquivos do Repositório do Git vazio, selecione Importar e insira a URL de clone. Forneça credenciais se o repositório de origem exigir autenticação.

az repos import create --git-source-url
                       [--detect {false, true}]
                       [--git-service-endpoint-id]
                       [--org]
                       [--project]
                       [--repository]
                       [--requires-authorization]
                       [--subscription]
                       [--user-name]

az repos import create --git-source-url https://github.com/fabrikamprime/fabrikam-open-source --repository fabrikam-open-source
{
  "detailedStatus": {
    "allSteps": [
      "Processing request",
      "Analyzing repository objects",
      "Storing objects",
      "Storing index file",
      "Updating references",
      "Import completed successfully"
    ],
    "currentStep": 6,
    "errorMessage": null
  },
  "importRequestId": 8,
  "parameters": {
    "deleteServiceEndpointAfterImportIsDone": null,
    "gitSource": {
      "overwrite": false,
      "url": "https://github.com/fabrikamprime/fabrikam-open-source"
    },
    "serviceEndpointId": null,
    "tfvcSource": null
  },
  "repository": {
    "defaultBranch": null,
    "id": "0f6919cd-a4db-4f34-a73f-2354114a66c4",
    "isDisabled": false,
    "isFork": null,
    "name": "new-empty-repo",
    "parentRepository": null,
    "project": {
      "abbreviation": null,
      "defaultTeamImageUrl": null,
      "description": "Guidance and source control to foster a vibrant ecosystem for Fabrikam Fiber applications and extensions.",
      "id": "56af920d-393b-4236-9a07-24439ccaa85c",
      "lastUpdateTime": "2021-05-24T21:52:14.95Z",
      "name": "Fabrikam Fiber",
      "revision": 438023732,
      "state": "wellFormed",
      "url": "https://dev.azure.com/fabrikamprime/_apis/projects/56af920d-393b-4236-9a07-24439ccaa85c",
      "visibility": "private"
    },
    "remoteUrl": "https://fabrikamprime@dev.azure.com/fabrikamprime/Fabrikam%20Fiber/_git/fabrikam-open-source",
    "size": 12477,
    "sshUrl": "git@ssh.dev.azure.com:v3/kelliott/Fabrikam%20Fiber/new-empty-repo",
    "url": "https://dev.azure.com/fabrikamprime/56af920d-393b-4236-9a07-24439ccaa85c/_apis/git/repositories/0f6919cd-a4db-4f34-a73f-2354114a66c4",
    "validRemoteUrls": null,
    "webUrl": "https://dev.azure.com/fabrikamprime/Fabrikam%20Fiber/_git/fabrikam-open-source"
  },
  "status": "completed",
  "url": "https://dev.azure.com/fabrikamprime/Fabrikam%20Fiber/_apis/git/repositories/0f6919cd-a4db-4f34-a73f-2354114a66c4/importRequests/8"
}

Importar manualmente um repositório usando a CLI git

1. Clone o repositório de origem em uma pasta temporária no computador usando a opção bare , conforme mostrado no exemplo de linha de comando a seguir e depois navegue até a pasta do repositório. Ao clonar usando a opção bare , o nome da pasta inclui o sufixo .git. Neste exemplo, https://github.com/contoso/old-contoso-repo.git é o repositório de origem a ser importado manualmente.

   git clone --bare https://github.com/contoso/old-contoso-repo.git
   cd old-contoso-repo.git
   

2. Crie um repositório de destino e anote a URL do clone. Neste exemplo, https://dev.azure.com/contoso-ltd/MyFirstProject/_git/new-contoso-repo é a URL do novo repositório de destino.

3. Execute o comando a seguir para copiar o repositório de origem para o repositório de destino.

   git push --mirror https://dev.azure.com/contoso-ltd/MyFirstProject/_git/new-contoso-repo
   

   Aviso

   O uso --mirror substitui todos os branches no repositório de destino, o que inclui a exclusão de branches que não estão no repositório de origem.

4. Se o repositório de origem tiver objetos LFS, busque-os e copie-os do repositório de origem para o repositório de destino.

   git lfs fetch origin --all
   git lfs push --all https://dev.azure.com/contoso-ltd/MyFirstProject/_git/new-contoso-repo
   

5. Exclua a pasta temporária executando os comandos a seguir.

   cd ..
   rm -rf old-contoso-repo.git
   

Perguntas frequentes (FAQs)

Embora as importações sejam mais bem-sucedidas, as condições a seguir podem causar problemas.

• E se meu repositório Source estiver por trás da autenticação de dois fatores?
• E se meu repositório de origem não der suporte a multi_ack?
• Posso importar de versões locais anteriores?
• Posso usar credenciais baseadas em MSA?
• Posso importar do TFVC?
• E se meu repositório de origem contiver objetos Git LFS?

P: E se meu repositório de origem estiver por trás da autenticação de dois fatores?

R: O serviço de importação usa APIs REST para validar e disparar a importação e não pode funcionar diretamente com repositórios que exigem autenticação de dois fatores.

A maioria dos provedores de hospedagem git dá suporte a tokens de autenticação que podem ser fornecidos para o serviço de importação:

Tokens de ID do Microsoft Entra (recomendado): Os tokens de ID do Microsoft Entra fornecem melhor segurança e são o método de autenticação recomendado. Você pode obter esses tokens por meio de:

• CLI do Azure (para desenvolvimento/teste):

  az account get-access-token --resource 499b84ac-1321-427f-aa17-267ca6975798 --query "accessToken" --output tsv
  

• Entidade de Serviço (para cenários de produção/automatizados):

  • Registre um aplicativo no Microsoft Entra ID
  • Criar um segredo do cliente para o aplicativo
  • Conceder permissões apropriadas ao aplicativo no Azure DevOps
  • Usar as credenciais da entidade de serviço para obter tokens programaticamente

Tokens de Acesso Pessoal (alternativa):o GitHub e o Azure DevOps também dão suporte a tokens de acesso pessoal.

P: E se meu repositório de origem não der suporte a multi_ack?

R: O serviço de importação usa a funcionalidade multi_ack do protocolo Git durante a importação. Se o repositório de origem não fornecer essa funcionalidade, o serviço de importação poderá falhar ao importar da fonte fornecida. Essa falha pode ocorrer ao criar uma solicitação de importação ou enquanto a importação estiver em andamento.

P: Posso importar de versões anteriores?

R: Se o repositório Git de origem estiver em uma versão local anterior ao RTM 2017, a importação falhará devido a uma incompatibilidade de contrato entre o Azure DevOps mais recente e as versões anteriores.

P: Posso usar credenciais baseadas em MSA?

R: Infelizmente, as credenciais baseadas em MSA (Conta da Microsoft) não funcionam. O serviço de importação depende da autenticação básica para se comunicar com o repositório de origem. Se o nome de usuário e a senha que você está usando não forem básicos, a autenticação e a importação falharão. Uma maneira de verificar se o nome de usuário/senha que você está usando é tentar usar o Git para clonar seu repositório usando o seguinte formato:

git clone https://<<username>>:<<password>>@<<remaining clone Url>>

P: Posso importar do TFVC?

R: Você pode migrar o código de um repositório TFVC existente para um novo repositório Git na mesma conta. Embora a migração para o Git tenha muitos benefícios, é um processo envolvido para grandes repositórios E equipes do TFVC. Sistemas de controle de versão centralizados, como o TFVC, se comportam de forma diferente do Git de maneiras fundamentais. A opção envolve muito mais do que aprender novos comandos. É uma mudança disruptiva que requer um planejamento cuidadoso. Para obter mais informações, consulte Importar do TFVC para o Git.

P: E se meu repositório de origem contiver objetos Git LFS?

R: A importação do Git não importa objetos git LFS.

Os objetos LFS podem ser movidos usando as seguintes etapas:

• Importe o repositório usando o recurso de importação de repositório para o Azure DevOps. Essa ação copia todos os objetos Git da origem para o Azure DevOps, que também importa os ponteiros LFS que são objetos Git, mas não os arquivos LFS

Para mover os arquivos LFS, você precisa de Git.exe e do cliente LFS na mesma caixa e acesso ao repositório de origem e ao repositório de destino

• Clone o repositório importado do Azure DevOps para o sistema local. O clone funciona, mas falha ao executar o check-out de arquivos LFS
• Adicionar o repositório de origem como remoto, por exemplo, "origem"
• Executar git lfs fetch source --all, que traz todos os arquivos LFS da origem para o repositório local
• Supondo que o repositório VSTS de destino seja seu "destino" remoto
• Execute git lfs push target --all

P: Posso importar atualizações se a origem for alterada mais tarde?

R: O serviço de importação é para importar inicialmente um repositório inteiro. Para espelhar alterações posteriores, você precisa de um clone local do repositório com os controles remotos definidos como origem e destino.

Você pode sincronizar as alterações usando os comandos a seguir. Tratamos a importação do Azure Repos como origin e o repositório original como upstream.

git clone --bare <Azure-Repos-clone-URL>.git
cd <name-of-repo>
git remote add --mirror=fetch upstream <original-repo-URL>
git fetch upstream --tags
git push origin --all

Próximas etapas

Artigos relacionados

• Saiba mais sobre o fluxo de trabalho do Git