Azure DevOps 서비스 | Azure DevOps Server | Azure DevOps Server 2022
이 빠른 시작에서는 GitHub Azure Boards 앱을 설치하여 Azure Boards GitHub 리포지토리에 연결합니다. Azure Boards 프로젝트를 GitHub.com 리포지토리와 연결하는 경우 GitHub 커밋과 끌어오기 요청 간에 작업 항목에 대한 연결을 지원합니다. Azure Boards 사용하여 작업을 계획하고 추적하는 동안 소프트웨어 개발에 GitHub 사용할 수 있습니다. GitHub 계정 또는 조직에 GitHub Azure Boards 앱을 설치한 후 프로젝트에서 연결할 GitHub 리포지토리를 선택합니다.
GitHub Azure Boards 앱에서 지원하는 통합에 대한 개요는 Azure Boards-GitHub 통합 참조하세요.
Prerequisites
| 사용 권한 범주 | Requirements |
|---|---|
| Azure DevOps | - 프로젝트 컬렉션 관리자 그룹구성원입니다. 프로젝트를 만든 경우 이 권한이 있습니다. - Azure Boards 프로젝트의 프로젝트 멤버. |
| GitHub |
- Azure Boards 앱을 설치하는 GitHub 조직의 관리자 또는 소유자 - GitHub 리포지토리에 대한 읽기 권한 |
Important
- OAuth와 같은 다른 인증 유형을 사용하여 리포지토리가 이미 연결된 경우 GitHub 앱을 사용하여 다시 연결하기 전에 기존 연결에서 해당 리포지토리를 제거해야 합니다. GitHub 앱을 구성하기 전에 이 문서의 뒷부분에 있는 GitHub 리포지토리 추가 또는 제거에 제공된 단계를 따르십시오.
- 해당 리포지토리의 관리자인 경우 Azure DevOps 조직을 여러 GitHub 리포지토리에 연결할 수 있습니다. GitHub 리포지토리를 둘 이상의 Azure DevOps 조직에 연결해서는 안 됩니다.
Azure Boards 앱 설치 및 구성
다음 단계에서는 일반적인 설치 순서를 보여줍니다. 화면의 프롬프트에 따라 설정을 완료합니다.
GitHub Marketplace Azure Boards 앱으로 이동합니다.
요금제 및 가격 책정의 무료 아래에서 설치를 선택합니다.
Azure Boards 설치 및 권한 부여에서 Azure Boards에 연결할 리포지토리를 선택한 다음 설치 및 권한 부여를 선택합니다.
이 예제에서는 모든 리포지토리를 사용합니다.
GitHub.com 연결하려는 Azure DevOps 조직 및 Azure Boards 프로젝트를 선택합니다.
스크린샷은 조직 및 프로젝트를 선택할 수 있는 Azure Boards 프로젝트 설정 페이지를 보여줍니다. 한 번에 하나의 프로젝트만 연결할 수 있습니다. 다른 프로젝트를 연결하려면 다른 프로젝트 또는 리포지토리 구성을 참조하세요.
Azure Boards 조직 액세스 권한 부여
Azure DevOps 조직에 GitHub 액세스 권한을 부여하려면 다음 단계를 완료합니다.
GitHub 웹 포털의 프로필 메뉴에서 settings 엽니다.
통합에서 애플리케이션을 선택합니다.
Authorized GitHub Apps>Azure Boards 선택합니다.
조직 액세스에서 나타날 수 있는 문제를 해결합니다. 권한 부여를 선택하여 액세스 요청이 보류 중인 것으로 표시되는 모든 조직에 대한 액세스 권한을 부여합니다.
타사 애플리케이션 액세스 정책 확인
GitHub 조직에서 Azure Boards 앱에 대한 타사 애플리케이션 액세스를 허용하는지 확인합니다. 타사 액세스가 제한된 경우 Azure DevOps 리포지토리를 추가하면 빈 목록이 표시되거나 오류가 발생할 수 있습니다.
액세스를 사용하도록 설정하려면 다음을 수행합니다.
GitHub 조직을 열고 설정>OAuth 앱 정책으로 이동합니다.
Azure Boards 앱을 특별히 승인하거나(권장) 모든 타사 애플리케이션에 대한 제한을 제거합니다.
비고
이 설정을 변경하려면 조직 소유자 또는 관리자여야 합니다.
작업 항목을 GitHub 끌어오기 요청에 연결
Azure Boards-GitHub 통합을 구성한 후 작업 항목을 GitHub 끌어오기 요청 및 커밋에 연결할 수 있습니다.
다음 예제에서는 작업 항목을 만들고 끌어오기 요청에 연결하여 통합을 보여 줍니다.
보드에서 새 작업 항목을 선택하여 작업 항목을 만듭니다. 이 예제에서는 "README에 배지 추가" 제목을 사용합니다. 작업 항목 유형은 문제(기본), 사용자 스토리(Agile) 또는 제품 백로그 항목(스크럼) 프로세스에 따라 달라집니다.
새 작업 항목이 보드에 나타납니다.
작업 항목을 열고 개발 섹션으로 이동합니다.
링크 추가를 선택한 다음 링크 유형 메뉴에서 GitHub 끌어오기 요청을 선택합니다.
리포지토리를 선택하고 끌어오기 요청 ID를 입력합니다. 선택적 주석을 추가할 수도 있습니다.
연결 추가를 선택하여 연결을 만듭니다.
Azure Boards 백그라운드에서 다음 작업을 자동으로 수행합니다.
- 연결된 GitHub 리포지토리 목록에서 첫 번째 리포지토리의 추가 정보 파일에 배지를 추가합니다.
- 배지 업데이트에 대한 GitHub 커밋을 만듭니다.
- 변경 내용을 추가 정보 파일에 병합하는 GitHub 끌어오기 요청을 만듭니다.
- GitHub 커밋 및 끌어오기 요청을 작업 항목에 연결
작업 항목에서 풀 요청 링크를 선택하여 GitHub에서 엽니다.
GitHub에서 풀 리퀘스트 병합을 선택합니다.
GitHub 리포지토리에서 추가 정보 파일을 열어 배지가 추가되었는지 확인합니다. 자세한 내용은 GitHub 추가 정보 파일에 추가할 상태 배지 구성을 참조하세요.
다른 프로젝트 또는 리포지토리 구성
다른 Azure Boards/Azure DevOps 프로젝트나 GitHub.com 리포지토리를 구성하거나, Azure Boards 앱 페이지에서 현재 구성을 변경할 수 있습니다. 자세한 내용은 리포지토리 추가 또는 제거 또는 Azure Boards 연결을 제거하세요.
리포지토리 추가 또는 제거 또는 Azure Boards 연결 제거
연결에 문제가 발생하는 경우 연결을 제거하고 새 연결로 다시 시작합니다.
Azure DevOps의 프로젝트에서 프로젝트 설정>GitHub 연결을 선택합니다.
리포지토리를 추가하거나 제거하려면 연결에 대한 기타 옵션 줄임표를 선택하고 메뉴에서 리포지토리 추가 또는 리포지토리 제거를 선택합니다.
모든 리포지토리 및 연결을 제거하려면 연결 제거 옵션을 선택합니다. 그런 다음 제거를 선택하여 확인합니다.
리포지토리 액세스 변경
GitHub 웹 포털의 프로필 메뉴에서 settings 엽니다.
통합>애플리케이션을 선택합니다. 사용 GitHub 앱 아래에서 Configure 선택합니다.
스크린샷에는 Azure Boards와 설정 옵션을 포함한 설치된 GitHub 앱이 표시됩니다. Azure Boards 구성 페이지가 열립니다.
리포지토리 액세스 섹션까지 아래로 스크롤합니다.
원하는 옵션을 선택하세요, 모든 저장소 또는 선택한 저장소만.
선택된 리포지토리만을 선택하는 경우, Azure Boards 통합에 참여할 리포지토리를 선택합니다.
저장을 선택합니다.
Azure Boards 통합 일시 중단 또는 제거
이전 절차의 2단계부터 위험 영역 섹션까지 아래로 스크롤합니다.
통합을 일시 중단하려면 일시 중단을 선택합니다. 확인 창에서 확인을 선택하여 일시 중단을 확인합니다.
통합을 일시 중단 해제하려면 일시 중단 취소를 선택합니다.
Azure Boards 앱을 제거하려면 제거를 선택한 다음 팝업 확인 창에서 확인을 선택합니다.
Azure Boards GitHub 연결 업데이트
GitHub Azure Boards 앱에서 지원하는 리포지토리를 변경하면 Azure Boards GitHub 연결로 리디렉션될 수 있습니다. 더 이상 GitHub 연결할 수 없는 Azure Boards 리포지토리를 제거하는 것이 좋습니다. 자세한 내용은 GitHub 리포지토리 추가 또는 제거 참조하세요.
GitHub Azure Boards 앱을 제거하면 다음 메시지가 Azure Boards 프로젝트 설정>GitHub 연결에 표시됩니다. 연결 제거를 선택하여 이전에 만든 모든 GitHub 연결을 제거합니다. 자세한 내용은 GitHub 리포지토리 추가 또는 제거 참조하세요.
통합 문제 해결
리포지토리를 추가할 때 빈 리포지토리 목록
Azure DevOps 리포지토리 목록이 비어 있는 경우:
- GitHub 조직에서 타사 앱 액세스를 사용하도록 설정했는지 확인합니다.
- Grant Azure Boards organization access에서 Azure Boards가 조직에 액세스할 수 있도록 권한을 부여했는지 확인하세요.
- GitHub에서 조직 설정 > 설치된 GitHub 앱 > Azure Boards > 조직 액세스를 확인하세요. 상태가 "액세스 요청 보류 중"으로 표시되면 승인하려면 부여 를 선택합니다.
"액세스 요청 보류 중" 중단 상태
조직 액세스가 보류 중인 경우:
- 요청을 승인하려면 GitHub 조직 소유자 또는 관리자여야 합니다.
- 권한 있는 앱 설정의 조직 액세스 섹션에서 권한 부여를 선택합니다.
- 문제가 지속되면 Azure Boards 앱을 제거하고 Azure Boards 앱 설치 및 구성의 단계에 따라 다시 설치합니다.
끌어오기 요청을 연결한 후 배지가 표시되지 않음
끌어오기 요청을 연결한 후 추가 정보 파일에 배지가 표시되지 않는 경우:
- 배지는 끌어오기 요청을 연결할 때만 표시되고 리포지토리는 연결된 목록의 첫 번째 리포지토리입니다.
- 연결한 PR이 여전히 열려 있는지 확인합니다(병합된 PR은 배지 생성을 트리거하지 않음).
- Azure Boards 리포지토리에 대한 쓰기 권한이 있는지 확인합니다.
인증 또는 권한 오류
설치 중에 인증 오류가 표시되는 경우:
- GitHub 조직 소유자 또는 관리자인지 확인합니다.
- GitHub 조직에서 타사 애플리케이션 액세스를 제한하지 않았는지 확인합니다.
- 연결하려는 리포지토리에 대한 읽기 권한이 있는지 확인합니다.
- GitHub 로그아웃하고 다시 로그인한 다음 권한 부여를 다시 시도합니다.