Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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.
Zainstaluj rozszerzenie migracji GitHub CLI:
gh extension install github/gh-geiUwierzytelnianie 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 loginWygeneruj skrypt migracji dla organizacji Azure DevOps:
gh gei generate-script --ado-org {organization} --github-org {github-org} --output migrate.shMoż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
Używanie importera GitHub
Aby uzyskać prostszą opcję opartą na przeglądarce, użyj wbudowanego GitHub Importera:
- Zaloguj się do GitHub i wybierz Nowe repozytorium.
- Wprowadź nazwę repozytorium i ustaw widoczność na Publiczny.
- Wybierz pozycję Importuj repozytorium w górnej części strony.
- Wprowadź adres URL klonowania Azure DevOps:
https://dev.azure.com/{organization}/{project}/_git/{repo}. - 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.
- 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.
Zainstaluj rozszerzenie interfejsu wiersza polecenia importera GitHub Actions:
gh extension install github/gh-actions-importerUruchom audyt, aby zidentyfikować przepływy do migracji.
gh actions-importer audit azure-devops \ --output-dir audit-resultsKonwersja 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
- Pobierz istniejące pakiety ze źródła danych Azure Artifacts.
- Skonfiguruj ponownie źródło pakietu, aby wskazywało GitHub Packages.
- 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.
Treści powiązane
- wycofanie projektów publicznych w Azure DevOps
- Zmienianie widoczności projektu na prywatny
- Informacje o projektach
- Utwórz projekt
- Dokumentacja funkcji GitHub Actions