Importar um repositório Git

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

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

Pré-requisitos

Importar para um novo repositório

Importar para um repositório vazio existente

Na página Arquivos do repositório Git vazio, selecione Importar e insira a URL de clonagem. Você precisará fornecer 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 com a CLI git

O recurso de repositório de importação foi introduzido na Atualização 1 do TFS 2017. Se você estiver usando o TFS 2017 RTM ou anterior, poderá usar as etapas a seguir para importar manualmente um repositório para o TFS. Você também pode seguir estas etapas para importar manualmente um repositório para um repositório dos Serviços de DevOps do Azure substituindo o TFS pelo Azure Repos nas etapas a seguir.

1. Clone o repositório de origem em uma pasta temporária no seu computador usando a bare opção, conforme mostrado no exemplo de linha de comando a seguir, e navegue até a pasta do repositório. Ao clonar usando a bare opção, 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 usando o TFS 2017 RTM e anote a URL de clone. Neste exemplo, https://dev.azure.com/contoso-ltd/MyFirstProject/_git/new-contoso-repo é a URL para o novo repositório de destino.

3. Execute o seguinte comando 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 substituirá todas as ramificações no repositório de destino, o que inclui a exclusão de quaisquer ramificações que não estejam 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 seguintes comandos.

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

Perguntas mais frequentes

Embora na maioria das vezes a importação seja bem-sucedida, as seguintes condições podem causar problemas.

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

E se meu repositório de origem estiver atrás da autenticação de dois fatores?

O serviço de importação usa APIs REST para validar e disparar a importação e não pode trabalhar diretamente com repositórios que exigem autenticação de dois fatores. A maioria dos provedores de hospedagem Git, como o GitHub e os Serviços de DevOps do Azure, oferece suporte a tokens pessoais que podem ser fornecidos ao serviço de importação.

E se o meu repositório de origem não suportar multi_ack?

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

Posso importar de versões anteriores do Team Foundation Server?

Se o repositório Git de origem estiver em uma versão do TFS anterior ao TFS 2017 RTM, a importação falhará. Isso acontece devido a uma incompatibilidade de contrato entre os Serviços de DevOps do Azure/TFS mais recentes e as versões RTM anteriores a 2017 do TFS.

Posso usar credenciais baseadas em MSA?

Infelizmente, as credenciais baseadas em MSA (Conta da Microsoft, anteriormente Live ID) não funcionarão. 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 / senha que você está usando não são autenticação básica, a autenticação falhará e a importação falhará. Uma maneira de verificar se o nome de usuário / senha que você está usando são autenticação básica ou não é tentar usar o Git para clonar seu repositório usando o formato abaixo

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

Posso importar do TFVC?

Você pode migrar o código de um repositório TFVC existente para um novo repositório Git dentro da mesma conta. Embora a migração para o Git tenha muitos benefícios, é um processo envolvido para grandes repositórios e equipes de TFVC. Sistemas de controle de versão centralizados, como o TFVC, se comportam de maneiras diferentes do Git de maneiras fundamentais. O switch 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.

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

A importação do Git não importará objetos do Git LFS.

Os objetos LFS podem ser movidos usando as seguintes etapas:

• Importe o repositório usando o recurso de repositório de importação para o Azure DevOps. Isso copiará todos os objetos Git da origem para o Azure DevOps (isso também importará os ponteiros LFS que são objetos Git, mas não os arquivos LFS)

Para mover os arquivos LFS (você precisará do cliente Git.exe e do LFS na mesma caixa e acessar o repositório de origem e o repositório de destino)

• Clone o repositório importado do Azure DevOps para o sistema local, o clone funcionará, mas falhará ao executar o check-out de arquivos LFS
• Adicione o repositório de origem como remoto (diga 'source')
• Executar git lfs fetch source --all (isso trará todos os arquivos LFS do código-fonte para o repositório local)
• Supondo que o repositório VSTS de destino seja seu remoto de "destino"
• Executar git lfs push target --all

Posso importar atualizações se a fonte mudar mais tarde?

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

Você pode sincronizar as alterações usando os seguintes comandos. Trataremos 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óximos passos

Artigos relacionados

• Saiba mais sobre o Git no tutorial do Git