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 | Azure DevOps Server | Azure DevOps Server 2022
W tym szybkim starcie zainstalujesz aplikację Azure Boards dla GitHub, by połączyć Azure Boards z repozytoriami na GitHub. Podczas łączenia projektów Azure Boards z repozytoriami GitHub.com, wspiera się powiązania między zatwierdzeniami i żądaniami ściągnięcia GitHub a elementami roboczymi. Możesz użyć GitHub do tworzenia oprogramowania podczas planowania i śledzenia pracy przy użyciu Azure Boards. Po zainstalowaniu aplikacji Azure Boards dla GitHub na koncie lub organizacji GitHub wybierz repozytoria GitHub, z którymi chcesz nawiązać połączenie z projektu.
Aby zapoznać się z przeglądem integracji aplikacji Azure Boards dla GitHub, zobacz Azure Boards-GitHub integration.
Prerequisites
| Category | Requirements |
|---|---|
| uprawnienia | - Członek grupy administratorów kolekcji projektów . Jeśli to Ty utworzyłeś projekt, masz uprawnienia. - Administrator lub właściciel organizacji GitHub do instalowania aplikacji Azure Boards. - Uprawnienia Read do repozytorium GitHub. |
| członkostwo w projekcie | członek projektu. |
Important
Jeśli repozytorium jest już połączone przy użyciu innego typu uwierzytelniania, takiego jak OAuth, musisz usunąć to repozytorium z istniejącego połączenia przed ponownym połączeniem przy użyciu aplikacji GitHub. Wykonaj kroki opisane w Dodaj lub usuń repozytoria GitHub w dalszej części tego artykułu przed skonfigurowaniem aplikacji GitHub.
Jeśli jesteś administratorem tych repozytoriów, możesz połączyć organizację Azure DevOps z wieloma repozytoriami GitHub. Nie należy łączyć repozytorium GitHub z więcej niż jedną organizacją Azure DevOps.
Instalowanie i konfigurowanie aplikacji Azure Boards
Sekwencja instalacji może się różnić ze względu na konfigurację konta. W razie potrzeby postępuj zgodnie z instrukcjami wyświetlanymi na ekranie.
Przejdź do aplikacji Azure Boards w witrynie GitHub Marketplace.
W obszarze Plany i ceny w obszarze Bezpłatna wybierz pozycję Zainstaluj.
W
Install & Autoryzuj Azure Boards wybierz repozytoria, które chcesz połączyć z Azure Boards, a następnie wybierz pozycjęInstaluj & Autoryzowanie .W tym przykładzie użyto wszystkich repozytoriów:
Wybierz projekt organizacji Azure DevOps i Azure Boards, z którym chcesz nawiązać połączenie z GitHub.com.
Jednocześnie można połączyć tylko jeden projekt. Jeśli masz inne projekty, które chcesz połączyć, możesz to zrobić później, zgodnie z opisem w temacie Konfigurowanie innych projektów lub repozytoriów w dalszej części tego artykułu.
Nadanie dostępu do organizacji Azure Boards
W razie potrzeby, aby udzielić GitHub dostępu do organizacji Azure DevOps, wykonaj następujące kroki.
W portalu internetowym GitHub otwórz Settings z menu profilu.
Wybierz pozycję Aplikacje w obszarze Integracje.
Wybierz pozycję Authorized GitHub Apps>Azure Boards.
W obszarze Dostęp do organizacji rozwiąż wszelkie problemy, które mogą się pojawić. Wybierz pozycję Udziel, aby udzielić dostępu do wszystkich organizacji, które są wyświetlane jako mające żądanie dostępu w toku.
Sprawdzanie zasad dostępu do aplikacji innych firm
Upewnij się, że organizacja GitHub zezwala na dostęp aplikacji innych firm dla aplikacji Azure Boards. Jeśli dostęp innych firm jest ograniczony, dodanie repozytoriów z Azure DevOps może wyświetlić pustą listę lub wygenerować błąd.
Aby włączyć dostęp:
W GitHub otwórz swoją organizację i przejdź do sekcji Ustawienia > zasady aplikacji OAuth.
Zatwierdź aplikację Azure Boards specjalnie (zalecaną) lub usuń ograniczenia dla wszystkich aplikacji innych firm.
Uwaga / Notatka
Aby zmienić to ustawienie, musisz być właścicielem organizacji lub administratorem.
Korzystanie z połączenia
Na tym etapie integracja Azure Boards-GitHub została ukończona. Możesz pominąć kolejne kroki lub przejść przez nie, aby poznać funkcje obsługiwane przez połączenie.
Na tablicy wybierz pozycję Nowy element roboczy aby wprowadzić nowy element roboczy o nazwie "Add badge to README"— Issue (Basic), User Story (Agile) lub Product Backlog Item (Scrum) — w zależności od modelu procesu używanego przez projekt Azure Boards.
Na tablicy pojawi się element roboczy Dodaj odznakę do pliku README.
Otwórz element roboczy, przejdź do sekcji Programowanie i wybierz pozycję Dodaj link.
Z Typ łącza wybierz pozycję GitHub Pull Request.
Wybierz repozytorium i wprowadź identyfikator żądania ściągnięcia i opcjonalny komentarz.
Wybierz pozycję Dodaj link.
Następujące akcje są wykonywane w tle automatycznie:
- Dodaje odznakę do pliku README pierwszego repozytorium na liście połączonych repozytoriów GitHub.
- Tworzy commit na GitHubie dla aktualizacji, poprzez dodanie odznaki do pliku README.
- Tworzy pull request na GitHubie w celu scalenia zmian wprowadzonych w pliku README.
- Łączy commit GitHub i pull request z elementem roboczym utworzonym w kroku 1.
Wybierz pierwszy link pull request z elementu roboczego.
Żądanie ściągnięcia GitHub zostanie otwarte na nowej karcie przeglądarki.
Wybierz pozycję Scal żądanie ściągnięcia.
Przejdź do pliku README repozytorium i wyświetl odznakę, która została dodana.
Aby uzyskać więcej informacji, zobacz Dodaj znaczki stanu dla repozytorium GitHub.
Konfigurowanie innych projektów lub repozytoriów
Możesz skonfigurować inne projekty Azure Boards/Azure DevOps, repozytoria GitHub.com lub zmienić bieżącą konfigurację ze strony aplikacji Azure Boards. Aby uzyskać więcej informacji, zobacz Dodaj lub usuń repozytoria albo usuń połączenie z Azure Boards.
Dodawanie lub usuwanie repozytoriów lub usuwanie połączenia z Azure Boards
Jeśli wystąpi problem z połączeniem, zalecamy usunięcie połączenia i rozpoczęcie od nowego połączenia.
W projekcie w Azure DevOps przejdź do Ustawienia projektu>Połączenia GitHub.
Aby dodać lub usunąć repozytoria, wybierz wielokropek Więcej opcji dla połączenia, a następnie wybierz pozycję Dodaj repozytoria lub Usuń repozytoria z menu.
Aby usunąć wszystkie repozytoria i połączenie, wybierz opcję Usuń połączenie . Następnie wybierz pozycję Usuń , aby potwierdzić.
Zmienianie dostępu do repozytorium
W portalu internetowym GitHub otwórz Settings z menu profilu.
Wybierz pozycję Integracje>Aplikacje. W obszarze Instalowane aplikacje GitHub wybierz Konfiguruj.
Zostanie otwarta strona konfiguracji Azure Boards.
Przewiń w dół do sekcji Dostęp do repozytorium.
Wybierz odpowiednią opcję, Wszystkie repozytoria lub Wybierz tylko repozytoria.
Jeśli wybierzesz Tylko wybrane repozytoria, wybierz repozytoria, które chcesz, aby uczestniczyły w integracji z Azure Boards.
Wybierz opcję Zapisz.
Wstrzymywanie lub odinstalowywanie integracji Azure Boards
Począwszy od kroku 2 w poprzedniej procedurze, przewiń w dół do sekcji Strefa niebezpieczeństwa.
Aby wstrzymać integrację, wybierz pozycję Wstrzymaj. W oknie potwierdzenia wybierz przycisk OK , aby potwierdzić zawieszenie.
Aby wznowić integrację, wybierz Wznów.
Aby odinstalować aplikację Azure Boards, wybierz pozycję Uninstall, a następnie wybierz pozycję OK w oknie potwierdzenia wyskakującego.
Aktualizowanie połączeń Azure Boards-GitHub
Jeśli zmienisz repozytoria obsługiwane przez aplikację Azure Boards dla GitHub, możesz zostać przekierowany do połączeń Azure Boards z GitHub. Dobrym rozwiązaniem jest usunięcie repozytoriów w Azure Boards, które nie mogą już łączyć się z GitHub. Aby uzyskać więcej informacji, zobacz Dodaj lub usuń repozytoria GitHub.
Jeśli odinstalujesz aplikację Azure Boards dla GitHub, w Azure Boards zostanie wyświetlony następujący komunikat Ustawienia projektu>GitHub połączenia. Wybierz pozycję Usuń połączenie aby usunąć wszystkie wcześniej wykonane połączenia GitHub. Aby uzyskać więcej informacji, zobacz Dodaj lub usuń repozytoria GitHub.
