Migrowanie z projektu publicznego do GitHub

Azure DevOps Services

Important

Projekty publiczne w Azure DevOps są wycofane. Począwszy od 2027 r., istniejące projekty publiczne są konwertowane na prywatne. Aby uzyskać więcej informacji, zobacz Wycofanie projektów publicznych i Migracja z projektu publicznego na GitHub.

W tym artykule pokazano, jak przeprowadzić migrację poszczególnych obszarów usług z projektu publicznego Azure DevOps do jego GitHub odpowiednika. Obejmuje ona repozytoria, potoki, witryny typu wiki, artefakty i elementy robocze.

Wymagania wstępne

Wymóg Details
Azure DevOps access Członek projektu z co najmniej dostępem podstawowym
Konto GitHub Konto GitHub z uprawnieniem do tworzenia repozytoriów
Git Usługa Git zainstalowana lokalnie
GitHub CLI (opcjonalnie) GitHub CLI dla zoptymalizowanych operacji

Migrowanie repozytoriów

GitHub repozytoria obsługują otwartą współpracę z propozycjami zmian, forkami i gwiazdami.

Używanie importera GitHub Enterprise

GitHub Enterprise Importer jest zalecanym narzędziem do migrowania repozytoriów z chmury Azure DevOps do chmury GitHub Enterprise Cloud. Migruje źródło usługi Git (w tym historię zatwierdzeń), żądania ściągnięcia, historię użytkownika, linki elementów roboczych dotyczące żądań ściągnięcia, załączników i zasad gałęzi.

  1. Zainstaluj rozszerzenie migracji GitHub CLI:

    gh extension install github/gh-gei
    
  2. Uwierzytelnianie za pomocą Azure DevOps i GitHub:

    # Sign in to Azure DevOps with Microsoft Entra ID and set the token
    az login
    export ADO_PAT=$(az account get-access-token --resource 499b84ac-1321-427f-aa17-267ca6975798 --query accessToken -o tsv)
    
    # Authenticate with GitHub
    gh auth login
    
  3. Wygeneruj skrypt migracji dla organizacji Azure DevOps:

    gh gei generate-script --ado-org {organization} --github-org {github-org} --output migrate.sh
    
  4. Możesz też przeprowadzić migrację pojedynczego repozytorium:

    gh gei migrate-repo --ado-org {organization} --ado-team-project {project} \
      --ado-repo {repo} --github-org {github-org} --github-repo {new-repo}
    

Aby uzyskać więcej informacji, zobacz Understand migrations from Azure DevOps to GitHub (Migracje z Azure DevOps do GitHub.

Używanie importera GitHub

Aby uzyskać prostszą opcję opartą na przeglądarce, użyj wbudowanego GitHub Importera:

  1. Zaloguj się do GitHub i wybierz Nowe repozytorium.
  2. Wprowadź nazwę repozytorium i ustaw widoczność na Publiczny.
  3. Wybierz pozycję Importuj repozytorium w górnej części strony.
  4. Wprowadź adres URL klonowania Azure DevOps: https://dev.azure.com/{organization}/{project}/_git/{repo}.
  5. Jeśli zostanie wyświetlony monit, wprowadź poświadczenia Azure DevOps. Zaloguj się przy użyciu Microsoft Entra ID. Jeśli musisz użyć osobistego tokenu dostępu, utwórz go z zakresem Odczytu kodu>. Aby uzyskać więcej informacji, zobacz Używanie osobistych tokenów dostępu.
  6. Wybierz pozycję Rozpocznij importowanie.

GitHub Importer migruje źródło Git i historię zatwierdzeń, ale nie migruje pull requests, linków elementów roboczych ani zasad gałęzi. Aby uzyskać więcej informacji, zobacz Importowanie repozytorium za pomocą narzędzia GitHub Importer.

Importowanie z wiersza polecenia

Jeśli GitHub Enterprise Importer nie spełnia Twoich potrzeb, wyślij bezpośrednio z lokalnej kopii:

# Clone the Azure DevOps repository with full history
git clone --bare https://dev.azure.com/{organization}/{project}/_git/{repo}
cd {repo}.git

# Push to the new GitHub repository
git push --mirror https://github.com/{owner}/{new-repo}.git

Important

Przejrzyj historię Git pod kątem poświadczeń, kluczy API lub poufnych danych przed wypchnięciem do publicznego repozytorium GitHub. Użyj narzędzi, takich jak git filter-repo , aby usunąć poufne treści z historii.

Migrowanie potoków

GitHub Actions oferuje elastyczne przepływy pracy i bezpłatne minuty pracy dla repozytoriów publicznych.

Użyj importera GitHub Actions

GitHub Actions Importer automatyzuje konwersję Azure Pipelines na przepływy pracy GitHub Actions.

  1. Zainstaluj rozszerzenie interfejsu wiersza polecenia importera GitHub Actions:

    gh extension install github/gh-actions-importer
    
  2. Uruchom audyt, aby zidentyfikować przepływy do migracji.

    gh actions-importer audit azure-devops \
      --output-dir audit-results
    
  3. Konwersja określonego pipeline'u

    gh actions-importer migrate azure-devops pipeline \
      --target-url https://github.com/{owner}/{repo} \
      --pipeline-id {pipeline-id} \
      --output-dir migration-results
    

Aby uzyskać więcej informacji, zobacz Migrate from Azure DevOps to GitHub Actions with GitHub Actions Importer.

Kluczowe różnice między Azure Pipelines a GitHub Actions

Azure Pipelines GitHub Actions
azure-pipelines.yml .github/workflows/*.yml
Etapy, zadania, kroki Zadania, kroki (przepływy pracy wielokrotnego użytku dla etapów)
Połączenia usługowe GitHub sekrety i OIDC
Pule agentów Etykiety modułu uruchamiającego (ubuntu-latest, windows-latest)
Odwołania do zadań (task@version) Odwołania do akcji (owner/action@version)

Migrowanie zawartości typu wiki

Publikowanie przewodników i podręczników przy użyciu witryny GitHub Wiki lub GitHub Pages.

Migrowanie do witryny typu wiki GitHub

Azure DevOps wikis są repozytoriami Git. Sklonuj je i wysyłaj bezpośrednio.

# Clone the Azure DevOps wiki repository
git clone https://dev.azure.com/{organization}/{project}/_git/{project}.wiki

cd {project}.wiki

# Add the GitHub wiki as a remote
git remote add github https://github.com/{owner}/{repo}.wiki.git

# Push to GitHub wiki
git push github main

Note

Przed przesłaniem utwórz co najmniej jedną stronę wiki w swoim repozytorium GitHub, aby zainicjować repozytorium wiki. Wybierz kartę Wiki w repozytorium GitHub i utwórz stronę.

Przenieś do GitHub Pages

W przypadku projektów z dużą liczbą dokumentacji GitHub Pages udostępnia pełną witrynę statyczną hostowaną bezpośrednio z repozytorium. Możesz użyć generatorów witryn statycznych, takich jak Jekyll lub MkDocs, aby przekonwertować zawartość typu wiki na opublikowaną witrynę.

Migrowanie artefaktów

GitHub Packages obsługuje publikowanie i używanie pakietów NuGet, npm i Maven.

Przenoszenie pakietów do pakietów GitHub

  1. Pobierz istniejące pakiety ze źródła danych Azure Artifacts.
  2. Skonfiguruj ponownie źródło pakietu, aby wskazywało GitHub Packages.
  3. Opublikuj pakiety do nowego kanału.

Aby na przykład przeprowadzić migrację pakietu npm:

# Set the GitHub Packages registry
npm config set @{owner}:registry https://npm.pkg.github.com

# Authenticate
npm login --registry=https://npm.pkg.github.com

# Publish
npm publish

Rejestry alternatywne

W przypadku pakietów wymagających szerokiej widoczności publicznej należy wziąć pod uwagę rejestry publiczne:

Typ pakietu Rejestr publiczny
NuGet nuget.org
npm npmjs.com
Maven Maven Central
Python PyPI
Ładunek crates.io

Migrowanie elementów roboczych

GitHub Problemy i projekty udostępniają nowoczesne narzędzia do zarządzania usterkami i żądaniami funkcji.

Nie ma wbudowanego narzędzia do migracji zadań z Azure Boards do GitHub Issues. Dostępnych jest kilka opcji dla społeczności.

  • Migrator z Azure DevOps do GitHub Issues — narzędzia open source na GitHub, które konwertują elementy robocze na zgłoszenia, zachowując tytuły, opisy i etykiety.
  • CSV export/import — wyeksportuj elementy robocze z Azure Boards jako plik CSV i następnie użyj CLI GitHub lub interfejsu API, aby utworzyć zgłoszenia.
  • REST API scripting — użyj REST API elementów roboczych Azure DevOps i REST API zagadnień GitHub do utworzenia niestandardowego skryptu migracji.

Eksportowanie elementów roboczych za pomocą interfejsu wiersza polecenia Azure DevOps

# Export work items from a query
az boards query --wiql "SELECT [System.Id], [System.Title], [System.State] FROM workitems WHERE [System.TeamProject] = '{project}'" --organization https://dev.azure.com/{organization} --output table

Wskazówka

Priorytetuj migrację aktywnych i najnowszych elementów roboczych. Zamknięte lub historyczne elementy mogą nie wymagać migracji — można je zachować w prywatnym projekcie w celu uzyskania informacji referencyjnych.

Zastąp pulpity nawigacyjne

GitHub nie ma jednej funkcji pulpitu nawigacyjnego równoważnej pulpitom nawigacyjnym Azure DevOps. Zamiast tego podobne funkcje są rozłożone na kilka funkcji natywnych.

Korzystanie z pulpitu nawigacyjnego Azure DevOps odpowiednik GitHub
Śledzenie pracy i wykres wypalenia GitHub Projects z wbudowanymi wykresami analitycznymi
Działanie repozytorium Szczegółowe informacje o repozytorium (zatwierdzenia, żądania ściągnięcia, ruch, współautorzy)
Stan kompilacji i ciągłej integracji GitHub Actions identyfikatory historii i stanu przebiegu przepływu pracy
Przejrzystość publiczna Problemy, żądania ściągnięcia, wydania i znaczki README

W przypadku pulpitów nawigacyjnych na poziomie organizacji, które agregują dane w wielu repozytoriach, zapoznaj się z integracjami w witrynie GitHub Marketplace.

Lista kontrolna po migracji

Po przeprowadzeniu migracji zawartości sprawdź następujące elementy:

  • [ ] Wszystkie repozytoria Git są dostępne na GitHub z pełną historią.
  • [ ] Procesy CI/CD są pomyślnie uruchamiane w GitHub Actions.
  • [ ] Treść Wiki jest poprawnie renderowana w witrynie GitHub Wiki lub GitHub Pages.
  • [ ] Pakiety są publikowane i przywracane z nowego rejestru.
  • [ ] Aktywne elementy robocze są śledzone w GitHub Problemy.
  • [ ] Linki zewnętrzne i znaczki wskazują na nowe lokalizacje GitHub.
  • [ ] Współpracownicy i członkowie społeczności są informowani o nowej lokalizacji.
  • [ ] README w projekcie Azure DevOps kieruje odwiedzających nową lokalizację GitHub.