Import úložiště Git

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Tento článek ukazuje, jak importovat existující úložiště Git z GitHubu, Bitbucketu, GitLabu nebo jiného umístění do nového nebo prázdného existujícího úložiště v projektu Azure DevOps.

Požadavky

Import do nového úložiště

Import do existujícího prázdného úložiště

Na stránce Soubory prázdného úložiště Git vyberte Importovat a zadejte adresu URL klonování. Pokud zdrojové úložiště vyžaduje ověření, budete muset zadat přihlašovací údaje.

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"
}

Ruční import úložiště pomocí rozhraní příkazového řádku git

Funkce úložiště importu byla zavedena v TFS 2017 Update 1. Pokud používáte TFS 2017 RTM nebo starší, můžete ručně importovat úložiště do TFS pomocí následujícího postupu. Tímto postupem můžete také ručně importovat úložiště do úložiště Azure DevOps Services tak, že v následujících krocích nahradíte TFS azure Repos.

1. Naklonujte zdrojové úložiště do dočasné složky v počítači pomocí bare možnosti, jak je znázorněno v následujícím příkladu příkazového řádku, a přejděte do složky úložiště. Při klonování pomocí bare této možnosti obsahuje název složky příponu .git . V tomto příkladu je zdrojové úložiště, https://github.com/contoso/old-contoso-repo.git které se má importovat ručně.

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

2. Vytvořte cílové úložiště pomocí TFS 2017 RTM a poznamenejte si adresu URL klonování. V tomto příkladu https://dev.azure.com/contoso-ltd/MyFirstProject/_git/new-contoso-repo je adresa URL nového cílového úložiště.

3. Spuštěním následujícího příkazu zkopírujte zdrojové úložiště do cílového úložiště.

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

   Upozorňující

   Použití --mirror přepíše všechny větve v cílovém úložišti, včetně odstranění všech větví, které nejsou ve zdrojovém úložišti.

4. Pokud má zdrojové úložiště objekty LFS, načtěte je a zkopírujte je ze zdrojového úložiště do cílového úložiště.

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

5. Odstraňte dočasnou složku spuštěním následujících příkazů.

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

Nejčastější dotazy

I když je import ve většině případů úspěšný, můžou problémy způsobit následující podmínky.

• Co když je zdrojové úložiště za dvoufaktorovým ověřováním?
• Co když zdrojové úložiště nepodporuje multi_ack?
• Můžu importovat z předchozích verzí Team Foundation Serveru?
• Můžu použít přihlašovací údaje založené na MSA?
• Můžu importovat z TFVC?
• Co když zdrojové úložiště obsahuje objekty Git LFS?

Co když je zdrojové úložiště za dvoufaktorovým ověřováním?

Služba importu používá rozhraní REST API k ověření a aktivaci importu a nemůže pracovat přímo s úložišti, která vyžadují dvojúrovňové ověřování. Většina poskytovatelů hostingu Git, jako je GitHub a Azure DevOps Services , podporuje osobní tokeny, které je možné doručovat do služby importu.

Co když zdrojové úložiště nepodporuje multi_ack?

Služba importu používá během importu funkci multi_ack protokolu Git. Pokud zdrojové úložiště tuto funkci neposkytuje, služba importu nemůže importovat z daného zdroje. K tomuto selhání může dojít při vytváření žádosti o import nebo při probíhajícím importu.

Můžu importovat z předchozích verzí Team Foundation Serveru?

Pokud je zdrojové úložiště Git ve verzi TFS starší než TFS 2017 RTM, import se nezdaří. K tomu dochází kvůli neshodě kontraktů mezi nejnovějšími verzemi TFS a Azure DevOps Services/TFS a verzemi TFS před 2017 RTM.

Můžu použít přihlašovací údaje založené na MSA?

Přihlašovací údaje založené na účtu Microsoft (účet Microsoft, dříve Live ID) bohužel nebudou fungovat. Služba importu spoléhá na základní ověřování při komunikaci se zdrojovým úložištěm. Pokud uživatelské jméno nebo heslo, které používáte, nejsou základní ověřování, ověřování selže a import selže. Jedním ze způsobů, jak zkontrolovat, jestli uživatelské jméno nebo heslo, které používáte, jsou základní ověřování nebo ne, je zkusit pomocí Gitu naklonovat úložiště pomocí následujícího formátu.

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

Můžu importovat z TFVC?

Kód můžete migrovat z existujícího úložiště TFVC do nového úložiště Git v rámci stejného účtu. I když migrace na Git má mnoho výhod, jedná se o proces velkých úložišť a týmů TFVC. Centralizované systémy správy verzí, jako je TFVC, se chovají jinak než Git základními způsoby. Přepínač zahrnuje mnohem víc než učení nových příkazů. Jedná se o rušivý změnu, která vyžaduje pečlivé plánování. Další informace najdete v tématu Import z TFVC do Gitu.

Co když zdrojové úložiště obsahuje objekty Git LFS?

Import Gitu neimportuje objekty Git LFS.

Objekty LFS je možné přesunout pomocí následujícího postupu:

• Importujte úložiště pomocí funkce importu úložiště do Azure DevOps. Tím se zkopírují všechny objekty Gitu ze zdroje do Azure DevOps (tím se také naimportují ukazatele LFS, které jsou objekty Gitu, ale ne soubory LFS).

Pokud chcete přejít přes soubory LFS (budete potřebovat klienta Git.exe i klienta LFS ve stejném poli a přístup k zdrojovému úložišti i cílovému úložišti).

• Klonování importovaného úložiště z Azure DevOps do místního systému, klonování bude fungovat, ale při rezervaci souborů LFS selže.
• Přidejte zdrojové úložiště jako vzdálené (řekněme "source").
• Proveďte git lfs fetch source --all (tím se přenesou všechny soubory LFS ze zdroje do místního úložiště).
• Za předpokladu, že cílové úložiště VSTS je vaše cílové vzdálené úložiště
• Provést git lfs push target --all

Můžu naimportovat aktualizace, pokud se zdroj později změní?

Služba importu slouží k počátečnímu importu celého úložiště. K pozdějšímu zrcadlení změn budete potřebovat místní klon úložiště se vzdálenými soubory nastavenými na zdroj i cíl.

Změny můžete synchronizovat pomocí následujících příkazů. Zacházíme s importem Azure Repos jako s původním úložištěm jako origin s původním úložištěm.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

Další kroky

Související články

• Další informace o Gitu najdete v kurzu Gitu.